A ThunderPhone használata a Zapierrel

Csatlakoztassa a Zapieren található ThunderPhone alkalmazást a szervezetéhez, és hozzon létre egy Zapet, amely minden hívás befejeződésekor lefut.

Zapier a Zaps nevű automatizált munkafolyamatokkal kapcsolja össze az alkalmazásokat. A Zapier ThunderPhone alkalmazása a következőket kínálja:

• Kiváltó események: A Hívás befejeződött akkor aktiválódik, amikor egy telefonos, webes vagy teszthívás véget ér. A Hívás értékelve akkor aktiválódik, amikor egy befejezett hívás értékelése elérhetővé válik.
• Műveletek: Kimenő hívás indítása, Kapcsolatok hozzáadása kampányhoz és Kampány indítása.
• Keresés: A Hívás keresése hívásazonosító alapján megkeres egy hívást, és elérhetőség esetén visszaadja annak átiratát és aláírt felvételi URL-jét.

Itt találja: ThunderPhone a Zapieren. A Zapier ThunderPhone-nal való használatának mindkét módjáról áttekintést a Zapier-integráció oldalán talál.

Szervezet csatlakoztatása#

Az alkalmazás OAuthon keresztül csatlakozik. Jelentkezzen be a ThunderPhone-ba, és hagyja jóvá egy szervezet hozzáférését; API-kulcs nem kerül átmásolásra a Zapierbe.

1. ThunderPhone-lépés hozzáadása

   A Zap-szerkesztőben keressen rá a ThunderPhone alkalmazásra (amely Beta címkével jelenik meg), majd válasszon kiváltó eseményt vagy műveletet. Amikor a Zapier fiókot kér, csatlakoztasson egy újat. A Zapier megnyit egy ThunderPhone-bejelentkezési ablakot.

2. Bejelentkezés és a szervezet kiválasztása

   Jelentkezzen be, ellenőrizze a kért engedélyeket, válassza ki a szervezetet, majd válassza a Jóváhagyás lehetőséget. Az alkalmazás engedélyt kér az AI-ügynökei és telefonszámai olvasására, a hívások és kampányok olvasására és írására, az olyan integrációk kezelésére, mint a webhook- végpontok, valamint a fiókjához tartozó e-mail-cím megtekintésére.

3. A kapcsolat nevének ellenőrzése

   A Zapier a jóváhagyott szervezetről nevezi el a kapcsolatot, így meg tudja különböztetni a kapcsolatokat, ha egynél több szervezethez tartozik.

Olyan fiókkal csatlakozzon, amely rendszergazdai vagy tulajdonosi szerepkörrel rendelkezik az adott szervezetben. Egy kiváltó Zap be- vagy kikapcsolásához, valamint minden művelethez szükség van erre a szerepkörre. Egy már bekapcsolt kiváltó Zap a szerepkör módosítása vagy a kapcsolat visszavonása után is fogadja a hívási eseményeket. Kapcsolja ki a leállításukhoz. A Hívás keresése bármely tag számára működik.

Az alkalmazásnak nincs saját ThunderPhone-díja. Az általa kezdeményezett vagy indított hívásokra a szokásos ThunderPhone-díjszabás vonatkozik, a Zapier pedig a Zapier-csomagjában számolja a feladatokat.

Az első Zap létrehozása#

Ez a Zap minden hívás befejeződésekor hozzáad egy sort egy Google-táblázathoz.

1. Mintaadatként használható hívás indítása

   Nyisson meg egy ügynököt a szerkesztőben, kattintson a Beszélgetés lehetőségre, majd fejezze be a hívást. A szerkesztőben indított teszthívások kiváltják a Hívás befejeződött eseményt, így az eseményindító egy nemrég lezajlott hívást tud betölteni.

2. Az eseményindító hozzáadása

   Válassza eseményindító alkalmazásként a ThunderPhone alkalmazást, állítsa az eseményt Hívás befejeződött értékre, majd válassza ki a ThunderPhone-kapcsolatát. Tesztelje az eseményindítót. A Zapier a legutóbb befejezett hívásait tölti be mintaként, ugyanabban a formátumban, mint egy éles eseményt.

3. Google Sheets hozzáadása

   Adjon hozzá egy Google Sheets-műveletet, amely létrehoz egy táblázatsort. Válasszon egy fejlécsort tartalmazó táblázatot, majd rendelje hozzá az egyes oszlopokat az eseményindító egyik mezőjéhez (lásd az alábbi táblázatot).

4. A Zap közzététele

   Tegye közzé és kapcsolja be a Zapot. A bekapcsolás létrehoz egy Zapier: Hívás befejeződött nevű webhook-végpontot a ThunderPhone szervezetében. A Zap kikapcsolása törli ezt a végpontot.

5. Tesztelés

   Indítson egy újabb teszthívást a szerkesztőben. Amikor a hívás befejeződik, a Zap 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 átiratával és felvételével együtt, így ezeket nem kell a táblázatban tárolni.

Az esemény az átiratot is tartalmazhatja, megszólalások listájaként, valamint egy Felvétel URL-címet, amely egy lejáró, aláírt hivatkozás. Csak akkor adja hozzá ezeket, ha a táblázatnak szüksége van rájuk. A hívásátiratok, összefoglalók és felvételek személyes vagy egészségügyi adatokat tartalmazhatnak. Csak olyan alkalmazásoknak küldje el őket, amelyeket a szervezete jogosult használni az adott adatokhoz, egészségügyi adatok esetén BAA alapján, és csak a szükséges mezőket őrizze meg. Az összes mezőt lásd itt: telephony.complete / web.complete.

Eseményindítók, műveletek és keresés#

A Hívás kiértékelve megadja a hívásazonosítót, az ügynökazonosítót, az ügynök nevét és az értékelést: az értékelés azonosítóját, a pontszámot, a hívás kimenetelét, az összefoglalót, az értékelő modellt és az értékelés időpontját. Egy Zap bekapcsolásakor létrejön egy Zapier: Hívás kiértékelve nevű végpont. Egy hívás többször is kiértékelhető, és minden befejezett értékelési futás aktiválja az eseményindítót. Lásd: call.graded.

A Hívás keresése egy hívásazonosítót fogad, a legutóbbi hívások legördülő listájával. Visszaadja a hívás ügynökét, irányát, telefonszámait, kezdési és befejezési időpontját, állapotát, befejezési okát, értékelési pontszámát és híváskimenetelét, az átiratot, valamint egy aláírt felvétel-URL-t, ha elérhető. Ismeretlen hívásazonosító esetén hiba helyett nem ad vissza találatot.

A Kimenő hívás indítása a következőket fogadja:

Visszaadja a hívásazonosítót, az állapotot és az idempotens ismétlést.

A Kapcsolatok hozzáadása kampányhoz kapcsolatokat ad hozzá egy piszkozat állapotú kampányhoz. Egy kapcsolat esetén töltse ki a Telefonszám mezőt E.164 formátumban, és opcionálisan a Kapcsolati változók mezőt, amely egy JSON-objektum, és amelynek tulajdonságai kampányváltozókká válnak. Köteg esetén töltse ki a Kapcsolatok JSON mezőt legfeljebb 5 000 objektumot tartalmazó tömbbel. Mindegyiknek szüksége van phone_number értékre, a többi tulajdonsága pedig változóvá válik. A lépés sikertelen, ha minden kapcsolat elutasításra kerül, és Részleges siker értéket állít be, ha csak néhány kapcsolat kerül elutasításra.

A Kampány indítása elindít vagy folytat egy legalább egy kapcsolatot tartalmazó kampányt. Ehhez Hozzájárulás a terheléshez szükséges. Lásd: Kimenő kampányok.

Mielőtt egy Zap hívásokat indít#

A Kimenő hívás indítása és a Kampány indítása valós telefonszámokat hív, és számlázható hívásokat indít.

• Ha ThunderPhone arra kéri szervezetét, hogy erősítse meg, hogy kimenő hívásai megfelelnek a TCPA és más hívási jogszabályok előírásainak, egy rendszergazdának rögzítenie kell ezt a megerősítést az irányítópulton, mielőtt egy Zap hívásokat indíthat.
• A Kiinduló telefonszámnak engedélyezve kell lennie kimenő hívásokhoz. A saját szolgáltatójától hozott telefonszámok ellenőrzés után jogosultak erre. A ThunderPhone által biztosított telefonszámok kezdetben csak bejövő hívásokhoz használhatók, és az irányítópulton kérhet hozzájuk kimenő hozzáférést. Lásd: Telefonszám beszerzése.
• A Kimenő hívás indítása művelethez Idempotenciakulcs szükséges. Társítson egy stabil azonosítót az eseményindítóból vagy a forrásrekordból, például a ThunderPhone eseményazonosítóját vagy egy CRM-rekord azonosítóját. Ha a Zapier újrapróbálja a lépést, ThunderPhone felismeri a kulcsot, és az eredeti hívást adja vissza egy második hívás indítása helyett. Kerülje az időbélyegek, a véletlenszerű értékek vagy önmagában a Zap azonosítójának használatát.
• A Kampány indítása művelethez Hozzájárulás a terheléshez szükséges, amely megerősíti, hogy a Zap számlázható kimenő hívásokat indíthat az Ön fiókjában.
• 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: kimenő hívásokra vonatkozó jogszabályok.

Az idempotenciakulcs szervezeten belül egyedi, és legfeljebb 128 karakterből állhat. Ha ugyanazt a kulcsot más ügynökkel, telefonszámmal vagy változókkal használja újra, az ütközés miatt sikertelen lesz, ezért ha két Zap ugyanazzal a rekorddal kapcsolatban hívhat, adjon mindegyik Zapnak saját rögzített előtagot a rekordazonosító előtt. A kimenő hívások indítása bemutatja a művelet mögötti API-t.

Példa Zapek#

• Befejezett hívás a CRM-be. Naplózzon tevékenységet minden befejezett híváshoz annak állapotával, befejezési okával és átiratával együtt.
• Értékelt hívás utókövetéshez. Szűrjön a hívás eredménye vagy pontszáma alapján, és irányítsa a hívást a megfelelő utókövetési munkafolyamatba.
• Új érdeklődő kampányhoz. Adja hozzá az érdeklődőt egy vázlatkampányhoz a Add Contacts to Campaign művelettel, majd futtassa a Start Campaign műveletet, miután valaki jóváhagyta a listát.

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 szervezete jogosult használni az adott adatokhoz, egészségügyi információk esetén BAA-megállapodás alapján, és csak a szükséges mezőket őrizze meg.

Hibaelhárítás#

Egy lépés engedélyezési hibával meghiúsul. Csatlakoztassa újra a ThunderPhone-kapcsolatot a Zapierben, és hagyja jóvá ismét. Egy kapcsolat akkor szűnik meg működni, ha a csatlakoztatást végző személy visszavonja azt a ThunderPhone-ban a Szervezet → Kulcsok → Engedélyezett alkalmazások alatt, ha az illető elhagyja a szervezetet, vagy ha 30 napon keresztül nem történik sikeres tokenfrissítés. Lásd: Csatlakozás OAuth-szal.

Egy Zap be- vagy kikapcsolása meghiúsul, vagy egy műveletet elutasítanak. A csatlakoztatást végző személynek rendszergazdai vagy tulajdonosi szerepkörrel kell rendelkeznie a szervezetben. Csatlakoztassa újra egy ilyen jogosultságú fiókkal. Egy már bekapcsolt trigger Zap a szerepkör módosítása vagy a kapcsolat visszavonása után is tovább fogadja a hívási eseményeket. Kapcsolja ki az események leállításához.

Le szeretné választani az alkalmazást. A kapcsolat visszavonása előtt kapcsolja ki ThunderPhone Zapjeit, mivel egy Zap kikapcsolása törli annak végpontját, és működő kapcsolatra van szükség hozzá. Ha előbb vonta vissza a kapcsolatot, törölje a megmaradt Zapier: … végpontot a DELETE /v1/developer/webhook-endpoints/{id} használatával egy rendszergazdai API-kulccsal. Lásd: Webhook-végpontok.

A Zapnak másik szervezetet kell használnia. Minden kapcsolat egy szervezetet fed le. Először kapcsolja ki a Zapet, hogy a webhook-végpontja törlődjön az aktuális szervezetből. Ezután csatlakoztasson egy új ThunderPhone-fiókot a Zapierben, a jóváhagyáskor válassza a másik szervezetet, majd válassza ki azt a kapcsolatot minden ThunderPhone-lépésnél. Az ügynökök, számok és kampányok szervezetenként eltérnek, ezért válassza ki újra az Ügynök, a Hívószám és a Kampány elemet minden olyan lépésben, ahol szerepelnek. Ezután kapcsolja vissza a Zapet.

A trigger leállt. Minden ThunderPhone-triggert tartalmazó Zap egy webhook-végpontot birtokol a szervezetében, amelynek neve Zapier: Hívás befejezve vagy Zapier: Hívás értékelve. A Zap bekapcsolásakor jön létre, és kikapcsolásakor törlődik. Hagyja változatlanul. Ha a ThunderPhone-ban szerkesztették vagy törölték, kapcsolja ki, majd be újra a Zapet, hogy új végpont jöjjön létre. Rendszergazdai API-kulccsal a GET /v1/developer/webhook-deliveries megjeleníti a legutóbbi kézbesítési kísérleteket.