Suara

Customer.io integráció

Gyors és érthető leírás, hogy hogyan kösd be a Customer.io fiókodat a Suara rendszerébe.

Haladási szint

0% · Befejezés: 4 perc

Mi a Customer.io?

A Customer.io egy üzenetküldő és ügyfélkommunikációs platform. A személyeket attribútumokkal tárolja, és szegmensekbe sorolja őket, amelyekre automatizált üzenetek épülnek.

Mire használhatod a Suarában?

Ha összekötöd a Customer.io-t, a hírlevél-feliratkozások egyenesen az ügyféladataid közé kerülnek. Néhány példa:

  • Feliratkozó űrlap: az űrlap létrehozza vagy frissíti a személyt, és manuális szegmensbe teszi (a szegmens azonosítóját az AI elkéri tőled).

  • Attribútumok: az űrlap adatai (név, érdeklődés) a személyhez kerülnek.

  • Hozzájárulás-követés: a hozzájárulás időpontja a személynél tárolódik.

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

  • Személy létrehozása vagy frissítése: attribútumokkal együtt.

  • Manuális szegmensbe tétel: a megadott manuális szegmensbe sorolja a személyt. Adatalapú szegmensbe nem tud írni.

  • Esemény rögzítése: például egy feliratkozás eseményét a személyhez.

Hozzájárulás

Az AI által épített űrlapon kötelező, alapból be nem pipált hozzájárulás-jelölőnégyzet szerepel, és a hozzájárulás időpontja a személynél tárolódik. A Customer.io-ban nincs beépített double opt-in: a megerősítő kampányt neked kell beállítanod a Customer.io-ban. A leiratkozást a Customer.io saját linkje kezeli, a hírlevelek a Customer.io kampányaiból mennek ki, nem az appból.

Biztonság

A Tracking 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 Customer.io-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 a Site ID-t és a Tracking API kulcsot a Customer.io-ban

  1. Jelentkezz be a Customer.io-ba.

  2. Nyisd meg az API-adatokat: https://fly.customer.io/settings/api_credentials (a beállításokban az API Credentials oldalon).

  3. A Tracking API Keys résznél másold ki a Site ID és a mellette lévő API Key értékét.

  4. Jegyezd meg, hogy a munkaterületed melyik régióban van (US vagy EU). A régió a fiók létrehozásakor dől el.

Fontos: a régiót pontosan válaszd ki. Rossz régióval a mentés hibával áll meg.

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 Customer.io-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 „Customer.io csatlakoztatása” ablak.

  4. Töltsd ki a mezőket:

    • Régió: US vagy EU, a munkaterületed adatközpontja szerint.

    • Site ID: a másolt Site ID.

    • Tracking API kulcs: a Site ID melletti API Key.

    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 ellenőrzi a kulcsot, és ha érvényes, a kapcsolat Customer.io · {Site ID} 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 Customer.io-ban létrehozza a személyt, és a Hírlevél szegmensbe teszi.” 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 Customer.io 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 projektekbe kötéshez be kell kapcsolni a Suara Cloudot. Ha még nincs bekapcsolva, kérd meg az AI-t a chatben. A kapcsolatot ettől függetlenül használhatod csak a chatben is (Csak chat), az appba bekötni később is lehet. A chatben futó műveletekhez ennél az integrációnál külön Chat-hozzáférést (MCP) is össze kell kötni: az Integrációk → Kapcsolataid alatt a kapcsolat részleteinél a Chat-hozzáférés összekötése (MCP) gombbal.

A bekötés után az AI a Customer.io-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 Customer.io kapcsolatra kattintva elérhető:

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

  • Kulcsok frissítése: új Site ID vagy API-kulcs mentése, ha lecseré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 Customer.io-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 Site ID és a kulcs helyesen lett kimásolva (szóköz nélkül), és hogy a Régió megegyezik a munkaterületedével.

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

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

  • A régió nem egyezik: Az US és az EU munkaterület külön rendszer. Válaszd ki azt a régiót, amelyikben a munkaterületed létrejött.

Customer.io integráció | Suara