> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Brevo

> Lisää Brevo Macaly-projektiisi

Brevo (entinen Sendinblue) on sähköpostimarkkinoinnin alusta, johon kuuluvat myös tekstiviesti- ja WhatsApp-kampanjat sekä sisäänrakennettu CRM. Jos tarvitset muutakin kuin uutiskirjeitä, Brevo kokoaa useita viestintäkanavia yhteen työkaluun.

<Callout icon="user">
  Saatavilla kaikissa paketeissa
</Callout>

<Note>
  **Tarvitsetko Brevoa todella?** Macalyssa on [sisäänrakennettu tietokanta](/docs/fi/features/databases) ja sähköposti-ilmoitukset. Jos tarvitset vain yhteydenottolomakkeen tai odotuslistan, ulkoista työkalua ei tarvita. Brevo kannattaa ottaa käyttöön, kun tarvitset uutiskirjeitä, automatisoituja viestisarjoja, tekstiviestikampanjoita tai CRM:n yhteystietojen hallintaan.
</Note>

## Miksi käyttää Brevoa

* **Lähetä uutiskirjeitä ja markkinointisähköposteja.** Käytä vedä ja pudota -editoria tai HTML-pohjia ilman koodausta.
* **Automatisoi jatkoviestintä.** Rakenna tervetulosarjoja, hylätyn ostoskorin viestejä ja uudelleenaktivointikampanjoita, jotka pyörivät itsekseen.
* **Tavoita ihmiset eri kanavissa.** Lähetä sähköposti-, teksti- ja WhatsApp-kampanjoita samalta alustalta.
* **Hallitse yhteystietoja ilman erillistä CRM:ää.** Seuraa kauppoja ja segmentoi yleisösi yhdessä paikassa.

## Mitä tarvitset

Varmista ennen aloittamista, että sinulla on:

* **Brevo-tili**. Luo sellainen ilmaiseksi osoitteessa [brevo.com](https://www.brevo.com)
* **Yhteystietolista** Brevossa, johon tilaajat kerätään

Brevon voi yhdistää sivustoosi kahdella tavalla:

* **Upotettu tilauslomake.** Liitä Brevon luoma lomakekoodi sivustollesi. Sopii parhaiten yksinkertaiseen sähköpostiosoitteiden keräämiseen.
* **Brevon API.** Yhdistä lomakkeesi Brevon API:in, jolloin hallitset täysin, mitä tietoja lähetetään. Sopii parhaiten silloin, kun haluat omat lomakkeet, jotka sopivat ulkoasuusi.

## Vaihtoehto 1: Upotettu tilauslomake

Yksinkertaisin tapa. Brevo luo lomakkeen, jonka voit upottaa sivustollesi.

<Steps>
  <Step title="Hae lomakkeen upotuskoodi">
    Siirry Brevossa kohtaan **Contacts** ja sitten **Forms**. Luo uusi tilauslomake (tai käytä olemassa olevaa), muokkaa sitä ja kopioi upotuskoodi.
  </Step>

  <Step title="Pyydä agenttia lisäämään se">
    Avaa Macaly-projektisi keskustelu ja kirjoita:

    ```
    Lisää tämä Brevo-tilauslomake sivustolleni. Tässä on upotuskoodi:

    [liitä Brevon upotuskoodi tähän]
    ```
  </Step>

  <Step title="Agentti sijoittaa lomakkeen">
    Agentti lisää lomakkeen projektiisi. Kerro, minne haluat sen: alatunnisteeseen, sivupalkkiin, omalle sivulleen tai ponnahdusikkunaan.
  </Step>
</Steps>

<Tip>
  Jos haluat lomakkeen sopivan sivustosi ulkoasuun, kerro se agentille: *”Muotoile Brevo-lomake sopimaan muun sivustoni ulkoasuun.”*
</Tip>

## Vaihtoehto 2: Oma lomake Brevon API:n kautta

Jos haluat enemmän hallintaa, agentti voi rakentaa oman lomakkeen, joka lähettää tilaajat Brevoon sen API:n kautta.

<Steps>
  <Step title="Lisää Brevon tunnukset Salaisuuksiin">
    Siirry Macaly-projektissasi kohtaan **Asetukset** ja sitten **Salaisuudet**. Lisää kaksi salaisuutta:

    * `BREVO_API_KEY`: Brevon API-avaimesi
    * `BREVO_LIST_ID`: yhteystietolista, johon haluat tilaajien lisättävän

    <Accordion title="Näin löydät API-avaimen ja listan tunnuksen">
      **API-avain:**

      1. Napsauta Brevossa nimeäsi oikeassa yläkulmassa ja valitse **SMTP & API**
      2. Avaa **API Keys** -välilehti
      3. Napsauta **Generate a new API key** ja kopioi avain

      **Listan tunnus (List ID):**

      1. Siirry kohtaan **Contacts** ja sitten **Lists**
      2. Napsauta haluamaasi listaa
      3. **List ID** näkyy URL-osoitteessa ja listan tiedoissa
    </Accordion>
  </Step>

  <Step title="Pyydä agenttia rakentamaan lomake">
    Avaa keskustelu ja kirjoita:

    ```
    Tee alatunnisteeseen uutiskirjeen tilauslomake. Kun joku tilaa kirjeen,
    lisää hänet Brevo-yhteystietolistalleni API:n avulla.
    Olen lisännyt API-avaimeni ja listan tunnuksen Salaisuuksiin.
    ```
  </Step>
</Steps>

<Warning>
  Älä koskaan liitä API-avaimia suoraan keskusteluun. Tallenna arkaluonteiset tunnukset aina kohtaan **Asetukset** ja sitten **Salaisuudet**. Agentti voi lukea ne sieltä turvallisesti.
</Warning>

## Tarkista, että se toimii

<Steps>
  <Step title="Lähetä testitilaus">
    Siirry sivustollesi ja kirjoita tilauslomakkeeseen testisähköpostiosoite.
  </Step>

  <Step title="Tarkista Brevon yhteystiedot">
    Siirry Brevossa kohtaan **Contacts**. Testisähköpostiosoitteesi pitäisi näkyä yhdistämässäsi listassa.
  </Step>
</Steps>

## Hyvä tietää

* Jos tarvitset vain sähköpostiosoitteiden keräämistä, Macalyn [sisäänrakennettu tietokanta](/docs/fi/features/databases) on yksinkertaisempi eikä vaadi ulkoista tiliä
* GDPR-vaatimusten täyttämiseksi ota **double opt-in** käyttöön Brevon lomakeasetuksissa
* Brevon API:lla voi lähettää myös tapahtumaviestejä (tilausvahvistuksia, salasanan palautuksia). Kysy agentilta, jos tarvitset niitäkin


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.