Twilio integráció

Mi az a Twilio?

A Twilio egy felhőalapú kommunikációs szolgáltató. API-n keresztül tud SMS-t, hívást és más üzeneteket küldeni. A Suarában az SMS-küldést és az elküldött üzenetek kézbesítési állapotának lekérdezését használhatod.

Mire használhatod a Suarában?

Ha összekötöd a Twiliót, az appod szöveges üzeneteket tud küldeni. Néhány példa:

• Foglalási emlékeztető: az ügyfél az időpont előtt SMS-ben kap emlékeztetőt.

• Rendelési státusz: a vásárló SMS-t kap, amikor a rendelése úton van.

• Ellenőrző kód: az app SMS-ben küld egyszer használatos kódot.

• Belső értesítés: egy fontos esemény SMS-ben jut el a csapathoz.

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

• SMS küldése: üzenetet küld egy telefonszámra (címzett, feladó, szöveg).

• Üzenet állapotának lekérdezése: megmutatja, hogy az üzenet sorban áll, elküldve, kézbesítve, sikertelen vagy kézbesíthetetlen-e.

Fontos tudnivaló a költségekről

Az SMS-díjakat közvetlenül a Twilio-fiókod fizeti, a Suara ebből nem számol fel külön díjat. A díj a címzett országától és szolgáltatójától függ. A Twilio-fiókodban egyenleget kell feltölteni, és az appod minden elküldött SMS-e ezt terheli. A magyarországi mobilszámokra küldött SMS aktuális árát a Twilio árlistáján találod: https://www.twilio.com/en-us/sms/pricing/hu

Biztonság

Az Account SID és az Auth token titkosítva, a Suara szerverén marad. A generált app sosem látja őket, és a böngészőbe sem kerülnek. Az app a Suara gatewayen keresztül hívja a Twilió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 adatokat a Twilióban

1. Jelentkezz be a Twilio Console-ba, vagy regisztrálj: https://console.twilio.com

2. A Console főoldalán az Account Info részben megtalálod az Account SID-t (AC betűkkel kezdődik) és az Auth Token-t. Az Auth Token értékét a Show gombbal jelenítheted meg.

3. Másold ki mindkettőt.

4. Ha SMS-t szeretnél küldeni, szükséged lesz egy Twilio-számra is. A Console Phone Numbers részében a Buy a number gombbal vásárolhatsz egyet, vagy használhatsz egy már meglévőt.

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 Twiliót. Az Üzenetküldés kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

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

4. Töltsd ki a mezőket:

   • Account SID: az AC-vel kezdődő azonosító, összesen 34 karakter.

   • Auth token: a titkos token. A Kulcs megjelenítése ikonnal ellenőrizhető.

   • Feladó szám: nem kötelező. Nemzetközi (E.164) formátumban add meg, például +36301234567. A Hol találom? hivatkozás a Twilio Console-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. Ennél az integrációnál ez azt jelenti, hogy az ő appjaik is küldhetnek SMS-t a te számládra.

6. Kattints a Mentés és ellenőrzés gombra. A Suara lekérdezi a Twilio-fiókod adatait, és ha a hitelesítő adatok érvényesek, a kapcsolat Twilio · {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 „A foglalás előtt egy nappal küldj SMS-emlékeztetőt az ügyfélnek.” 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 Twilio 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 Twilio-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 Twilio kapcsolatra kattintva elérhető:

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

• Kulcsok frissítése: új Account SID, Auth token vagy feladó szám 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 tudnak SMS-t küldeni.

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

Hibaelhárítás

• „Mentés és ellenőrzés” hibával áll meg: Ellenőrizd, hogy az Account SID AC-vel kezdődik és 34 karakter hosszú, hogy az Auth token helyesen lett kimásolva (szóköz nélkül), és hogy a kettő ugyanahhoz a Twilio-fiókhoz tartozik.

• A feladó szám hibás: A számnak nemzetközi formátumban, + jellel és országhívóval kell szerepelnie, például +36301234567, szóköz és kötőjel nélkül.

• A kapcsolat „Hiba” vagy „Visszavonva” státuszú: Az Auth token megváltozott (például újragenerálták). Másold ki az újat a Twilio Console-ból, és mentsd el a Kulcsok frissítése résznél.

• Az app nem küld SMS-t: Ellenőrizd, hogy a kapcsolat be van-e kötve a projektbe, és hogy a Suara Cloud be van-e kapcsolva.

• Az SMS küldése sikertelen: A feladó szám nem a Twilio-fiókodhoz tartozik, vagy a fiókodban elfogyott az egyenleg. Ellenőrizd a számot és az egyenleget a Twilio Console-ban.

• Próbafiókkal nem megy az SMS: A Twilio próbafiókja csak megerősített számokra küld. Erősítsd meg a címzett számát a Console-ban, vagy frissíts fizetős fiókra.