---
title: "Používejte ThunderPhone se Zapierem"
description: "Připojte aplikaci ThunderPhone v Zapieru ke své organizaci a vytvořte Zap, který se spustí pokaždé, když hovor skončí."
---
[Zapier](https://zapier.com) 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](https://zapier.com/apps/thunderphone/integrations).
Přehled obou způsobů použití Zapieru s ThunderPhone najdete na
[stránce integrace Zapier](https://thunderphone.com/integrations/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.
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.
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.
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čí.
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í.
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.
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).
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í.
Proveďte další testovací hovor v editoru. Po jeho ukončení se Zap spustí a
objeví se řádek.
Užitečné sloupce:
| Sloupec | Pole Hovor dokončen |
|---|---|
| ID hovoru | ID hovoru |
| Agent | Název agenta |
| Směr | Směr |
| Od | Číslo volajícího |
| Komu | Volané číslo |
| Zahájeno | Zahájeno v |
| Ukončeno | Ukončeno v |
| Délka (s) | Délka v sekundách |
| Stav | Stav |
| Důvod ukončení | Důvod ukončení |
| Odkaz na hovor | Zadejte `https://app.thunderphone.com/dashboard/call-history/` a poté vložte ID hovoru |
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`](/cs/webhooks/call-complete).
Každé doručení je podepsané. Aplikace před spuštěním Zapu ověří HMAC
`X-ThunderPhone-Signature` vůči tajnému klíči koncového bodu a zastaví se při
jakémkoli nepodepsaném nebo neplatném doručení. Pokud Zapier doručení
nepřijme, ThunderPhone ho opakuje až 24 hodin. Viz [Přehled webhooků](/cs/webhooks/overview).
## 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`](/cs/webhooks/events).
**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á:
| Pole | Význam |
|---|---|
| Agent | Uložený agent. Rozbalovací seznam obsahuje vaše agenty. |
| Cílové číslo | Cíl ve formátu E.164, například `+14155552671`. |
| Výchozí číslo | Rozbalovací seznam obsahuje pouze čísla povolená pro odchozí hovory. |
| Proměnné | Volitelný objekt JSON s hodnotami pro zástupné symboly v promptu agenta. |
| Klíč idempotence | Stabilní ID ze spouštěče nebo zdrojového záznamu. Povinné. |
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ě](/cs/guides/outbound-campaigns).
## 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](/cs/guides/get-a-phone-number).
- 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í](/cs/guides/outbound-calling-laws).
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ů](/cs/guides/place-outbound-calls) 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](/cs/guides/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ů](/cs/webhooks/endpoints).
**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`](/api-reference/webhook-deliveries)
nedávné pokusy o doručení.
Chcete, aby agent během hovoru používal akce Zapier místo až po něm?
Připojte koncový bod Zapier MCP v části **Připojení → MCP**. Viz
[Servery MCP](/cs/guides/mcp-servers). Chcete-li odesílat stejné události hovorů na vlastní server, viz [Koncové body webhooků](/cs/webhooks/endpoints).