A ThunderPhone használata az n8n-nel

Telepítse az n8n-hez készült ThunderPhone-csomópontot, csatlakoztasson egy szerveroldali API-kulcsot, és hozzon létre egy munkafolyamatot, amely minden hívás befejezésekor lefut.

n8n egy munkafolyamat-automatizálási eszköz. Az n8n-hez készült ThunderPhone csomag két csomópontot ad hozzá:

• A ThunderPhone Trigger munkafolyamatot indít, amikor egy hívás véget ér (Hívás befejezve), vagy amikor egy hívásértékelési futtatás befejeződik (Hívás kiértékelve).
• A ThunderPhone kimenő hívásokat indít, névjegyeket ad kampányokhoz és elindítja azokat, lekéri a hívásokat azok átiratával és felvételével együtt, valamint felsorolja az ügynökeit és telefonszámait.

Ez egy hitelesített közösségi csomópont, amely itt szerepel: ThunderPhone az n8n-en.

A csomópont telepítése#

Az n8n szerkesztőben kattintson a + jelre a csomópontpanel megnyitásához, majd keressen rá a ThunderPhone elemre. Előfordulhat, hogy a példány tulajdonosának előbb be kell állítania a hitelesített csomópontokat, mielőtt más felhasználók hozzáadhatnák azokat.

Saját üzemeltetésű n8n esetén csomagnév alapján is telepíthet: nyissa meg a Beállítások > Közösségi csomópontok menüt, és telepítse a n8n-nodes-thunderphone csomagot. A telepítés előtt ellenőrizze a közösségi csomópontok kockázatait és a példányára vonatkozó szabályzatot.

Szerveroldali API-kulcs létrehozása#

1. Nyissa meg a Kulcsok lapot

   A ThunderPhone-ban lépjen a Szervezet → Kulcsok menüponthoz, majd kattintson a Kulcs létrehozása lehetőségre.

2. Nevezze el

   Olyan nevet használjon, amely jelzi, hol található a kulcs, például „n8n”.

3. Másolja ki most

   A teljes sk_live_... titkos kulcs csak egyszer jelenik meg. Másolja ki, mielőtt bezárja a párbeszédablakot.

A kulcsot csak rendszergazda vagy tulajdonos hozhatja létre, és a ThunderPhone az ezzel végrehajtott kéréseket úgy kezeli, mintha az adott személytől érkeznének. Az eseményindítóhoz és a kampányműveletekhez szükséges, hogy ez a személy megtartsa a rendszergazdai vagy tulajdonosi szerepkört. A szerveroldali API-kulcs létrehozása útmutató ismerteti a kulcsforgatást és a visszavonást.

Hitelesítő adat hozzáadása az n8n-ben#

1. Az n8n-ben hozzon létre egy ThunderPhone API típusú hitelesítő adatot.
2. Illessze be a kulcsot az API-kulcs mezőbe.
3. Mentse el, majd futtassa a hitelesítőadat-tesztet. A teszt egy hívást olvas ki a szervezetéből a GET /v1/calls?limit=1 használatával.

Az első munkafolyamat létrehozása#

Ez a munkafolyamat minden hívás befejeződésekor hozzáad egy sort egy Google Sheethez.

1. Indító hozzáadása

   Adja hozzá a ThunderPhone Trigger elemet, válassza ki ThunderPhone API-hitelesítő adatait, és állítsa az Esemény értékét Hívás befejezve értékre.

2. A hívás lekérése

   Adjon hozzá egy ThunderPhone csomópontot. Állítsa az Erőforrás értékét Hívás értékre, a Művelet értékét Lekérés értékre, a Hívásazonosító értékét pedig erre a kifejezésre: {{ $json.data.call_id }}. A kimenet a hívásrekordot, valamint a transcripts és recording_url mezőt tartalmazza; utóbbi egy rövid élettartamú hivatkozás, amely null, ha a híváshoz nem tartozik felvétel.

3. Sor hozzáfűzése

   Adjon hozzá egy sort hozzáfűző Google Sheets csomópontot, és képezze le a kívánt oszlopokat a Hívás lekérése kimenetből (lásd az alábbi táblázatot).

4. A munkafolyamat aktiválása

   Mentse és aktiválja a munkafolyamatot. Az indító webhook-végpontként regisztrálja az éles URL-jét a ThunderPhone-szervezetében. A munkafolyamat deaktiválása törli ezt a végpontot.

5. Tesztelés

   Nyisson meg egy ügynököt a szerkesztőben, kattintson a Beszélgetés gombra, majd fejezze be a hívást. A szerkesztő teszthívásai web.complete eseményként érkeznek, amely a Hívás befejezve mögötti két esemény egyike, így a munkafolyamat lefut, és megjelenik egy sor.

Hasznos oszlopok:

A híváshivatkozás megnyitja a hívást a ThunderPhone irányítópultján a szervezet tagjai számára, az átirattal és a felvétellel együtt, így ezeket nem kell a táblázatban tárolni.

Az átirat hozzáadásához is képezze le ezt: {{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}. A felvétel URL-je lejár, ezért tárolja a hívásazonosítót, és futtassa újra a Hívás lekérése műveletet, amikor friss hivatkozásra van szüksége. A hívásátiratok, összefoglalók és felvételek személyes vagy egészségügyi információkat tartalmazhatnak. Csak olyan alkalmazásoknak küldje el őket, amelyeket a szervezete jogosult használni ezekhez az adatokhoz, egészségügyi információ esetén BAA keretében, és csak a szükséges mezőket tartsa meg.

Az indító a teljes eseményt adja ki: type, event_id és data. Az összes mezőt lásd itt: telephony.complete / web.complete és call.graded. A kézbesítés legalább egyszer történik, és az event_id ugyanaz marad egy esemény újrapróbálkozásai során, ezért ellenőrizze azt egy olyan lépés előtt, amelynek nem szabad megismétlődnie.

Külső hívások biztonságos indítása#

Külső hívás indítása (erőforrás: Külső hívás, művelet: Indítás) a következőket fogadja:

Rendelje hozzá az Idempotenciakulcsot a futtatást kiváltó elem egyik azonosítójához, például egy CRM-rekord azonosítójához vagy a kiváltó event_id értékéhez. A csomópont a következőt küldi: n8n:<node ID>:<your value>, ezért:

• Az automatikus újrapróbálás vagy a Végrehajtás újrapróbálása ugyanazt a kulcsot küldi, és a ThunderPhone az eredeti hívást adja vissza idempotent_replay: true értékkel, ahelyett hogy újra tárcsázna.
• Két, ugyanazzal a rekorddal ellátott ThunderPhone-csomópont különböző kulcsokat küld.
• Üres érték esetén a művelet még kérés küldése előtt sikertelen.

Kerülje az időbélyegeket, a véletlenszerű értékeket, valamint az n8n-végrehajtási vagy munkafolyamat-azonosítókat. Az újrapróbáláskor megadott új érték egy második valódi hívást indít. A teljes kulcs legfeljebb 128 karakter lehet. Ha ugyanazt a kulcsot más ügynökkel, számmal vagy változókkal használja újra, ütközés miatt sikertelen lesz.

Kampányok. A Névjegyek hozzáadása (erőforrás: Kampány) névjegyeket ad hozzá egy piszkozatkampányhoz. Kampányazonosítót és névjegyek JSON-tömbjét fogadja. Minden névjegyhez szükséges a phone_number; a többi kulcs hívásváltozóvá válik. A csomópont akkor sikertelen, ha minden névjegyet elutasítanak, és partial_success: true értéket állít be, ha csak néhányat utasítanak el. Az Indítás művelethez szükséges a jelölőnégyzet kiválasztása, amely megerősíti, hogy a kampány valódi hívásokat indít és ThunderPhone-krediteket használ fel. Lásd: Külső kampányok.

Mielőtt egy munkafolyamat hívásokat indít:

• Ha a ThunderPhone arra kéri a szervezetét, hogy erősítse meg, hogy külső hívásai megfelelnek a TCPA-nak és más hívásra vonatkozó jogszabályoknak, egy rendszergazdának először rögzítenie kell ezt a megerősítést az irányítópulton.
• A hívó számnak engedélyezve kell lennie külső hívásokhoz. A saját szolgáltatójától hozott számok ellenőrzés után megfelelnek a feltételeknek. A ThunderPhone-számok kezdetben csak bejövő hívásokra használhatók, és külső használatra jóváhagyhatók: ezt egy rendszergazda kérelmezi a Telefonszámok oldalon. Lásd: Telefonszám beszerzése.
• Az Ön szervezete felelős azért, hogy rendelkezzen hozzájárulással az egyes számok hívásához, és betartsa az alkalmazandó hívási jogszabályokat. Lásd: Külső hívásokra vonatkozó jogszabályok.

Példa-munkafolyamatok#

• CRM-névjegyek kampányba. Adjon CRM-névjegyeket egy piszkozat ThunderPhone-kampányhoz, majd indítsa el a kampányt, amikor valaki jóváhagyja a listát.
• Befejezett hívás az ügyfélrekordba. A Hívás befejezésekor futtassa a Hívás lekérése műveletet, és mentse az átiratot és a felvétel hivatkozását a megfelelő ügyfélrekordhoz.
• Alacsony értékelések felülvizsgálatra. A Hívás értékelésekor szűrjön a {{ $json.data.grade.score }} alapján, és irányítsa az alacsony pontszámú hívásokat felülvizsgálati várólistára a hívásazonosítóval és az értékelés részleteivel együtt. Egy hívás több alkalommal is értékelhető, és minden befejezett értékelési futás aktiválja a kiváltót, ezért hívásazonosítónként csak a legfrissebb graded_at értéket tartsa meg.

A hívásátiratok, összefoglalók és felvételek személyes vagy egészségügyi információkat tartalmazhatnak. Csak olyan alkalmazásoknak küldje el őket, amelyeket a szervezete jogosult használni ezekhez az adatokhoz, egészségügyi információk esetén BAA alapján, és csak a szükséges mezőket tartsa meg.