Používejte ThunderPhone se Zapierem

Připojte aplikaci ThunderPhone v Zapieru ke své organizaci a vytvořte Zap, který se spustí pokaždé, když hovor skončí.

Zapier propojuje aplikace pomocí automatizovaných pracovních postupů zvaných Zapy. Aplikace ThunderPhone v Zapieru přidává:

• Spouštěče: Hovor dokončen se spustí po ukončení telefonního, webového nebo testovacího hovoru. Hovor vyhodnocen se spustí, když je k dispozici hodnocení dokončeného hovoru.
• Akce: Uskutečnit odchozí hovor, Přidat kontakty do kampaně a Spustit kampaň.
• Vyhledávání: Najít hovor vyhledá hovor podle ID a vrátí ho spolu s jeho přepisem a podepsanou adresou URL nahrávky, pokud je k dispozici.

Najdete ji na stránce ThunderPhone na Zapieru. Přehled obou způsobů použití Zapieru s ThunderPhone najdete na stránce integrace Zapier.

Připojte svou organizaci#

Aplikace se připojuje prostřednictvím OAuth. Přihlásíte se do ThunderPhone a schválíte přístup pro jednu organizaci; do Zapieru se nekopíruje žádný klíč API.

1. Přidejte krok ThunderPhone

   V editoru Zap vyhledejte ThunderPhone (zobrazený se štítkem Beta) a vyberte spouštěč nebo akci. Když Zapier požádá o účet, připojte nový účet. Zapier otevře okno pro přihlášení do ThunderPhone.

2. Přihlaste se a vyberte organizaci

   Přihlaste se, zkontrolujte požadovaná oprávnění, vyberte organizaci a zvolte Schválit. Aplikace požádá o oprávnění číst vaše agenty a telefonní čísla, číst a zapisovat hovory a kampaně, spravovat integrace, jako jsou koncové body webhooků, a zobrazit e-mail vašeho účtu.

3. Zkontrolujte název připojení

   Zapier pojmenuje připojení podle organizace, kterou jste schválili, takže můžete připojení rozlišit, pokud patříte do více než jedné organizace.

Připojte účet s rolí administrátora nebo vlastníka v dané organizaci. Zapnutí nebo vypnutí Zap se spouštěčem i každá akce vyžadují tuto roli. Zap se spouštěčem, který je již zapnutý, bude nadále přijímat události hovorů po změně role nebo zrušení připojení. Chcete-li je zastavit, vypněte jej. Funkce Najít hovor funguje pro každého člena.

Aplikace nemá vlastní poplatek ThunderPhone. Hovory, které uskuteční nebo spustí, jsou účtovány podle vašich běžných sazeb ThunderPhone a Zapier započítává úlohy do vašeho tarifu Zapier.

Vytvořte první Zap#

Tento Zap přidá řádek do Tabulek Google pokaždé, když hovor skončí.

1. Proveďte hovor pro použití jako ukázková data

   Otevřete agenta v editoru, klikněte na Hovořit a ukončete hovor. Testovací hovory v editoru spouštějí událost Hovor dokončen, takže spouštěč získá nedávný hovor k načtení.

2. Přidejte spouštěč

   Jako aplikaci spouštěče vyberte ThunderPhone, nastavte událost na Hovor dokončen a vyberte své připojení ThunderPhone. Otestujte spouštěč. Zapier načte vaše nejnovější dokončené hovory jako ukázky ve stejném formátu jako živá událost.

3. Přidejte Tabulky Google

   Přidejte akci Tabulek Google, která vytvoří řádek v tabulce. Vyberte list s řádkem záhlaví a poté namapujte každý sloupec na pole ze spouštěče (viz tabulka níže).

4. Publikujte Zap

   Publikujte Zap a zapněte ho. Jeho zapnutím se ve vaší organizaci ThunderPhone vytvoří koncový bod webhooku s názvem Zapier: Hovor dokončen. Vypnutím Zapu se tento koncový bod odstraní.

5. Otestujte ho

   Proveďte další testovací hovor v editoru. Po jeho ukončení se Zap spustí a objeví se řádek.

Užitečné sloupce:

Odkaz na hovor otevře hovor v panelu ThunderPhone pro členy vaší organizace včetně jeho přepisu a nahrávky, takže tabulka nemusí obsahovat ani jedno z nich.

Událost může také obsahovat přepis jako seznam replik a adresu URL nahrávky, tedy podepsaný odkaz s omezenou platností. Přidávejte je pouze v případě, že je tabulka potřebuje. Přepisy hovorů, shrnutí a nahrávky mohou obsahovat osobní nebo zdravotní údaje. Odesílejte je pouze do aplikací, které vaše organizace smí pro tato data používat, v případě zdravotních údajů na základě smlouvy BAA, a uchovávejte pouze pole, která potřebujete. Všechna pole najdete v telephony.complete / web.complete.

Spouštěče, akce a vyhledávání#

Hovor vyhodnocen poskytuje ID hovoru, ID agenta, název agenta a hodnocení: ID hodnocení, skóre, výsledek hovoru, shrnutí, model hodnotitele a čas vyhodnocení. Zapnutím Zapu se vytvoří endpoint s názvem Zapier: Hovor vyhodnocen. Hovor lze vyhodnotit více než jednou a každý dokončený běh hodnocení spustí spouštěč. Viz call.graded.

Najít hovor přijímá ID hovoru s rozbalovacím seznamem nedávných hovorů. Vrací agenta hovoru, směr, čísla, čas zahájení a ukončení, stav, důvod ukončení, skóre hodnocení a výsledek hovoru, přepis a podepsanou adresu URL nahrávky, je-li k dispozici. Neznámé ID hovoru nevrátí žádný výsledek místo chyby.

Uskutečnit odchozí hovor přijímá:

Vrací ID hovoru, stav a idempotentní opakování.

Přidat kontakty do kampaně přidá kontakty do konceptu kampaně. Pro jeden kontakt vyplňte Telefonní číslo ve formátu E.164 a volitelně Proměnné kontaktu, objekt JSON, jehož vlastnosti se stanou proměnnými kampaně. Pro dávku vyplňte JSON kontaktů polem až 5 000 objektů. Každý vyžaduje phone_number a jeho další vlastnosti se stanou proměnnými. Krok selže, pokud jsou všechny kontakty odmítnuty, a nastaví Částečný úspěch, pokud jsou odmítnuty pouze některé.

Spustit kampaň spustí nebo obnoví kampaň, která má alespoň jeden kontakt. Vyžaduje Souhlas s účtováním. Viz Odchozí kampaně.

Než Zap uskuteční hovory#

Akce Uskutečnit odchozí hovor a Spustit kampaň vytáčejí skutečná telefonní čísla a zahajují zpoplatněné hovory.

• Pokud ThunderPhone požádá vaši organizaci o potvrzení, že její odchozí hovory splňují TCPA a další zákony týkající se volání, musí správce toto potvrzení zaznamenat na dashboardu, než bude moci Zap zahajovat hovory.
• Výchozí číslo musí být povoleno pro odchozí hovory. Čísla, která si přenesete od vlastního operátora, splňují podmínky po ověření. Čísla poskytovaná službou ThunderPhone jsou zpočátku pouze pro příchozí hovory a na dashboardu pro ně můžete požádat o přístup k odchozím hovorům. Viz Získat telefonní číslo.
• Akce Uskutečnit odchozí hovor vyžaduje Klíč idempotence. Namapujte stabilní ID ze spouštěče nebo zdrojového záznamu, například ID události ThunderPhone nebo ID záznamu CRM. Pokud Zapier krok zopakuje, ThunderPhone klíč rozpozná a vrátí původní hovor namísto uskutečnění druhého. Nepoužívejte časová razítka, náhodné hodnoty ani samotné ID Zapu.
• Akce Spustit kampaň vyžaduje Souhlas s účtováním, který potvrzuje, že Zap může na vašem účtu zahájit zpoplatněné odchozí hovory.
• Vaše organizace odpovídá za získání souhlasu s voláním na každé číslo a za dodržování platných zákonů týkajících se volání. Viz zákony pro odchozí volání.

Klíč idempotence je jedinečný v rámci vaší organizace a může mít nejvýše 128 znaků. Opětovné použití klíče s jiným agentem, číslem nebo proměnnými selže z důvodu konfliktu, proto pokud dva Zapy mohou volat ohledně stejného záznamu, přidejte každému Zapu před ID záznamu vlastní pevnou předponu. Uskutečňování odchozích hovorů popisuje API, které stojí za touto akcí.

Příklady Zapů#

• Dokončený hovor do CRM. Zaznamenejte aktivitu pro každý dokončený hovor včetně jeho stavu, důvodu ukončení a přepisu.
• Vyhodnocený hovor k následnému kontaktování. Filtrujte podle výsledku hovoru nebo skóre a směrujte hovor do správného pracovního postupu následného kontaktování.
• Nový potenciální zákazník do kampaně. Přidejte potenciálního zákazníka do konceptu kampaně pomocí možnosti Přidat kontakty do kampaně a poté po schválení seznamu spusťte možnost Spustit kampaň.

Přepisy hovorů, souhrny a nahrávky mohou obsahovat osobní nebo zdravotní údaje. Odesílejte je pouze do aplikací, které vaše organizace smí pro tato data používat, v případě zdravotních údajů na základě smlouvy BAA, a uchovávejte pouze pole, která potřebujete.

Řešení problémů#

Krok selže s chybou autorizace. Znovu připojte připojení ThunderPhone v Zapieru a znovu ho schvalte. Připojení přestane fungovat, když ho osoba, která ho připojila, odvolá v ThunderPhone v části Organizace → Klíče → Autorizované aplikace, když tato osoba organizaci opustí nebo když po dobu 30 dnů nedojde k úspěšnému obnovení tokenu. Viz Připojení pomocí OAuth.

Zapnutí nebo vypnutí Zapu selže nebo je akce odmítnuta. Osoba, která připojení vytvořila, potřebuje v organizaci roli administrátora nebo vlastníka. Znovu se připojte pomocí účtu, který tuto roli má. Spouštěcí Zap, který je již zapnutý, bude i po změně role nebo odvolání připojení nadále přijímat události hovorů. Vypněte ho, chcete-li je zastavit.

Chcete aplikaci odpojit. Před odvoláním připojení vypněte své Zapy ThunderPhone, protože vypnutí Zapu odstraní jeho koncový bod a vyžaduje funkční připojení. Pokud jste připojení odvolali nejdříve, odstraňte zbývající koncový bod Zapier: … pomocí DELETE /v1/developer/webhook-endpoints/{id} a administrátorského klíče API. Viz Koncové body webhooků.

Zap má používat jinou organizaci. Každé připojení zahrnuje jednu organizaci. Nejprve Zap vypněte, aby se jeho koncový bod webhooku odstranil z aktuální organizace. Poté v Zapieru připojte nový účet ThunderPhone, při schválení vyberte druhou organizaci a v každém kroku ThunderPhone vyberte toto připojení. Agenti, čísla a kampaně se mezi organizacemi liší, proto v každém kroku, který je obsahuje, znovu vyberte možnosti Agent, Číslo volajícího a Kampaň. Poté Zap znovu zapněte.

Spouštěč přestal fungovat. Každý Zap se spouštěčem ThunderPhone má ve vaší organizaci vlastní koncový bod webhooku s názvem Zapier: Dokončený hovor nebo Zapier: Vyhodnocený hovor. Vytvoří se při zapnutí Zapu a odstraní se při jeho vypnutí. Nechte ho beze změny. Pokud byl v ThunderPhone upraven nebo odstraněn, Zap vypněte a znovu zapněte, aby se vytvořil nový. S administrátorským klíčem API zobrazí GET /v1/developer/webhook-deliveries nedávné pokusy o doručení.