Mailchimp integráció

Mi a Mailchimp?

A Mailchimp egy e-mail marketing platform. A feliratkozókat közönségekbe (audience) gyűjti, címkékkel csoportosítja, és ebből építi a hírlevél-kampányokat.

Mire használhatod a Suarában?

Ha összekötöd a Mailchimpet, az appodból hírlevél-feliratkozókat gyűjthetsz közvetlenül a Mailchimp közönségedbe. Néhány példa:

• Feliratkozó űrlap: az űrlap felveszi vagy frissíti a feliratkozót a közönségedben.

• Címkézés: a feliratkozó érdeklődés szerint címkét kap.

• Double opt-in: az új feliratkozó a Mailchimp megerősítő levelét kapja.

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

• Feliratkozó felvétele vagy frissítése: a közönségedben.

• Címke beállítása: a feliratkozóhoz címkét rendel.

• Listák lekérdezése: megmutatja a meglévő közönségeidet.

Hozzájárulás

Az űrlapon GDPR szerinti, alapból be nem pipált hozzájárulás-jelölőnégyzet szerepel. Az új feliratkozók a Mailchimp double opt-in megerősítő levelét kapják. A leiratkozást a Mailchimp saját linkje kezeli, a hírlevelek a Mailchimp kampányaiból mennek ki. Egy meglévő tag státuszát (például leiratkozott) az AI nem írja felü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 Mailchimpet, 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 és az adatközpontot a Mailchimpben

1. Jelentkezz be a Mailchimpbe.

2. Nyisd meg az API-kulcsok oldalt: https://admin.mailchimp.com/account/api/ (a profilod → Extras → API keys).

3. Kattints a Create A Key gombra, adj a kulcsnak nevet, és másold ki.

4. Az adatközpontot a kulcs kötőjel utáni vége mutatja. Például a …-us21 végű kulcsnál az adatközpont us21.

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 Mailchimpet. 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 „Mailchimp csatlakoztatása” ablak.

4. Töltsd ki a mezőket:

   • API kulcs: a másolt kulcs.

   • Adatközpont: a kulcs kötőjel utáni része, például us21.

   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 Mailchimp-fiókodat, és ha a kulcs érvényes, a kapcsolat Mailchimp · {fiók neve} 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 Mailchimp Hírlevél közönségedbe veszi fel a látogatót.” 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 Mailchimp 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 Mailchimp-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 Mailchimp 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 Mailchimpet.

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 az Adatközpont megegyezik a kulcs kötőjel utáni részével.

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

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

• Rossz adatközpont: Ha az adatközpont nem egyezik a kulccsal, a hívás hibával áll meg. Add meg a kulcs kötőjel utáni végét, például us21.