Brevo integráció

Mi a Brevo?

A Brevo (korábban Sendinblue) egy e-mail marketing és CRM platform. Hírlevélküldésre, kontaktok és listák kezelésére használják, és kezeli a feliratkozás megerősítését és a leiratkozást is.

Mire használhatod a Suarában?

Ha összekötöd a Brevót, az appodon keresztül hírlevél-feliratkozókat gyűjthetsz közvetlenül a Brevo listáidra. Néhány példa:

• Feliratkozó űrlap: az oldalad űrlapja a látogatót a Brevo megadott listájára veszi.

• Double opt-in: a nyilvános űrlapnál a feliratkozó először megerősítő levelet kap, és csak a visszaigazolás után kerül a listára. Ehhez kell egy Brevo double opt-in sablon (a {{ doubleoptin }} linkkel), amelynek az azonosítóját az AI elkéri tőled, és egy megerősítő oldal az appban.

• Kontaktok frissítése: egy meglévő kontakt adatait az app frissíti, nem hoz létre duplikátumot.

Az AI az alábbi műveleteket használja:

• Kontakt felvétele vagy frissítése: nyilvános űrlapnál double opt-in megerősítéssel, már hozzájárult kontaktnál (például bejelentkezett ügyfélnél) közvetlen frissítéssel, duplikátum nélkül.

• Listák lekérdezése: megmutatja a meglévő listáidat.

• Kontakt listára tétele: a megadott listára sorolja a feliratkozót.

Hozzájárulás és leiratkozás

Az AI által épített űrlapon kötelező, alapból be nem pipált hozzájárulás-jelölőnégyzet szerepel. A leiratkozást a Brevo saját linkje kezeli. A kampányok a Brevóból mennek ki, nem az appból.

Biztonság

Az API-kulcs titkosítva, a Suara szerverén marad. A generált app sosem látja, és a böngészőbe sem kerül. Az app a Suara gatewayen keresztül hívja a Brevót, a gateway pedig a háttérben hozzáadja a hitelesítő adatokat. A kapcsolatot a láthatóság beállításával korlátozhatod: Csak én, Csak kiválasztott tagok vagy Az egész munkaterület.

Beállítás lépésről lépésre

1. Szerezd meg az API-kulcsot a Brevóban

1. Jelentkezz be a Brevóba.

2. Nyisd meg az API-kulcsok oldalt: https://app.brevo.com/settings/keys/api (az SMTP & API oldalon az API-kulcsok résznél).

3. Kattints a Generate a new API key gombra, és adj a kulcsnak nevet (például „Suara”).

4. Másold ki a kulcsot. A kulcs xkeysib--bel kezdődik.

2. Kösd be a Suarában

1. A Suara oldalsávjában nyisd meg az Integrációk oldalt.

2. A Katalógusban keresd meg a Brevót. Az Email kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

3. Kattints a Csatlakoztatás gombra. Megnyílik a „Brevo csatlakoztatása” ablak.

4. Töltsd ki a mezőt:

   • API kulcs: a másolt kulcs.

   A beillesztett titkos érték a Kulcs megjelenítése ikonnal ellenőrizhető. A Hol találom? hivatkozás a szolgáltatás megfelelő oldalára visz.

5. Válaszd ki, ki használhatja a kapcsolatot (Csak én vagy Az egész munkaterület). Ha a teljes munkaterületnek engedélyezed, a Suara figyelmeztet, hogy minden tag használhatja a kapcsolatot a saját projektjeiben.

6. Kattints a Mentés és ellenőrzés gombra. A Suara lekérdezi a Brevo-fiókodat, és ha a kulcs érvényes, a kapcsolat Brevo · {cégnév} néven megjelenik a Kapcsolataid között.

3. Használd a projektedben

Három módon használhatod a kapcsolatot:

• A chatben kérve: írd le az AI-nak, mit szeretnél, például „Építs egy hírlevél-feliratkozó űrlapot, amely a Brevo Hírlevél listájára veszi fel a látogatót double opt-innal.” Ha még nincs kapcsolat, az AI felkínálja a csatlakoztatást.

• Az Integrációk oldalról: a Kapcsolataid között a Brevo mellett a Bekötés az appba gombbal kötheted be a kapcsolatot egy projektbe.

• A projekt Kapcsolatok oldaláról: nyisd meg a projekt Kapcsolatok részét, és kattints a Kapcsolat gombra. Ott a Munkaterület kapcsolatai közül választhatsz egy meglévőt, vagy az Új bekötése gombbal újat hozhatsz létre.

A bekötés után az AI a Brevo-hívásokat az app szerveroldali (edge function) részében generálja. A hitelesítő adatok így nem kerülnek a kódba, és a kapcsolatot szükség esetén a projekt Kapcsolatok oldaláról bármikor leválaszthatod.

Kapcsolat kezelése

Az Integrációk → Kapcsolataid alatt a Brevo kapcsolatra kattintva elérhető:

• Alapadatok: az elnevezés és a láthatóság módosítása.

• Kulcsok frissítése: új API-kulcs mentése, ha lecserélted vagy törölted a régit.

• Kapcsolt projektek: itt látod, mely projektek használják a kapcsolatot.

• Utolsó hívások: itt látod a legutóbbi hívásokat (metódus, útvonal, státusz, időtartam, forrás: alkalmazás vagy chat).

• Leválasztás (Veszélyzóna): megszünteti a kapcsolatot. A hozzá kötött projektek ezután nem érik el a Brevót.

A státusz lehet Aktív, Hiba vagy Visszavonva. Ha Újracsatlakozás szükséges üzenetet látsz, mentsd újra a kulcsot.

Hibaelhárítás

• „Mentés és ellenőrzés” hibával áll meg: Ellenőrizd, hogy a kulcs helyesen lett kimásolva (szóköz nélkül), és hogy xkeysib--bel kezdődik.

• A kapcsolat „Hiba” vagy „Visszavonva” státuszú: A kulcs törölve lett, lejárt, vagy visszavonták. Generálj új kulcsot a Brevóban, és mentsd el a Kulcsok frissítése résznél.

• Az app nem éri el a Brevót: Ellenőrizd, hogy a kapcsolat be van-e kötve a projektbe, és hogy a Suara Cloud be van-e kapcsolva.

• Nem érkezik meg a megerősítő levél: A levelet a Brevo küldi, és csak akkor tud kimenni, ha van double opt-in sablon a {{ doubleoptin }} linkkel. Ellenőrizd a sablont, a küldő beállításait, és hogy a levél nem a spamben van-e.

• Egy attribútum nem kerül át: A Brevo attribútumnevei nagybetűsek (például FIRSTNAME), és előre létre kell hozni őket a Brevóban.