--- title: "Používajte ThunderPhone so Zapierom" description: "Pripojte aplikáciu ThunderPhone v Zapieri k svojej organizácii a vytvorte Zap, ktorý sa spustí po každom ukončení hovoru." --- [Zapier](https://zapier.com) prepája aplikácie pomocou automatizovaných pracovných postupov nazývaných Zapy. Aplikácia ThunderPhone v Zapier pridáva: - **Spúšťače:** **Hovor dokončený** sa spustí po skončení telefonického, webového alebo testovacieho hovoru. **Hovor vyhodnotený** sa spustí, keď je k dispozícii hodnotenie dokončeného hovoru. - **Akcie:** **Uskutočniť odchádzajúci hovor**, **Pridať kontakty do kampane** a **Spustiť kampaň**. - **Vyhľadávanie:** **Nájsť hovor** vyhľadá hovor podľa ID a vráti ho spolu s jeho prepisom a podpísanou URL nahrávky, keď je k dispozícii. Nájdete ju na stránke [ThunderPhone v Zapier](https://zapier.com/apps/thunderphone/integrations). Prehľad oboch spôsobov používania Zapier s ThunderPhone nájdete na [stránke integrácie Zapier](https://thunderphone.com/integrations/zapier). ## Pripojenie organizácie Aplikácia sa pripája prostredníctvom OAuth. Prihlásite sa do ThunderPhone a schválite prístup pre jednu organizáciu. Do Zapier sa nekopíruje žiadny kľúč API. V editore Zap vyhľadajte **ThunderPhone** (zobrazený s označením Beta) a vyberte spúšťač alebo akciu. Keď Zapier požiada o účet, pripojte nový účet. Zapier otvorí okno prihlásenia do ThunderPhone. Prihláste sa, skontrolujte požadované oprávnenia, vyberte organizáciu a zvoľte **Schváliť**. Aplikácia žiada oprávnenie čítať vašich agentov a telefónne čísla, čítať a zapisovať hovory a kampane, spravovať integrácie, ako sú koncové body webhookov, a zobrazovať e-mail vášho účtu. Zapier pomenuje pripojenie podľa organizácie, ktorú ste schválili, takže môžete rozlíšiť pripojenia, keď patríte do viac než jednej organizácie. Pripojte sa pomocou účtu s rolou administrátora alebo vlastníka v danej organizácii. Zapnutie alebo vypnutie Zapu so spúšťačom a každá akcia vyžadujú túto rolu. Zap so spúšťačom, ktorý je už aktívny, bude naďalej prijímať udalosti hovorov po zmene roly alebo odvolaní pripojenia. Ak ich chcete zastaviť, deaktivujte ho. Funkcia Nájsť hovor funguje pre každého člena. Aplikácia nemá vlastný poplatok ThunderPhone. Hovory, ktoré uskutoční alebo spustí, sa účtujú podľa vašich bežných sadzieb ThunderPhone a Zapier započítava úlohy do vášho plánu Zapier. ## Vytvorte prvý Zap Tento Zap pridá riadok do Tabuliek Google vždy, keď sa hovor skončí. Otvorte agenta v editore, kliknite na **Hovoriť** a ukončite hovor. Testovacie hovory v editore spúšťajú udalosť Hovor dokončený, takže spúšťač získa nedávny hovor na načítanie. Vyberte **ThunderPhone** ako aplikáciu spúšťača, nastavte udalosť na **Hovor dokončený** a vyberte pripojenie ThunderPhone. Otestujte spúšťač. Zapier načíta vaše naposledy dokončené hovory ako vzorky v rovnakom formáte ako živá udalosť. Pridajte akciu Tabuliek Google, ktorá vytvorí riadok tabuľky. Vyberte hárok s riadkom hlavičiek a potom namapujte každý stĺpec na pole zo spúšťača (pozrite si tabuľku nižšie). Publikujte a zapnite Zap. Jeho zapnutím sa vo vašej organizácii ThunderPhone vytvorí koncový bod webhooku s názvom **Zapier: Call Completed**. Vypnutím Zapu sa tento koncový bod odstráni. Uskutočnite ďalší testovací hovor v editore. Keď sa skončí, Zap sa spustí a zobrazí sa riadok. Užitočné stĺpce: | Stĺpec | Pole Hovor dokončený | |---|---| | ID hovoru | ID hovoru | | Agent | Meno agenta | | Smer | Smer | | Od | Číslo od | | Komu | Číslo komu | | Začiatok | Začaté o | | Koniec | Ukončené o | | Trvanie (s) | Trvanie v sekundách | | Stav | Stav | | Dôvod ukončenia | Dôvod ukončenia | | Odkaz na hovor | Zadajte `https://app.thunderphone.com/dashboard/call-history/` a potom vložte ID hovoru | Odkaz na hovor otvorí hovor v paneli ThunderPhone pre členov vašej organizácie spolu s jeho prepisom a nahrávkou, takže ich hárok nemusí obsahovať. Udalosť môže obsahovať aj prepis vo forme zoznamu replík a adresu URL nahrávky, čo je podpísaný odkaz s obmedzenou platnosťou. Pridajte ich iba v prípade, že ich hárok potrebuje. Prepisy hovorov, súhrny a nahrávky môžu obsahovať osobné alebo zdravotné údaje. Odosielajte ich iba do aplikácií, ktoré je vaša organizácia oprávnená používať pre tieto údaje, na základe BAA, ak sú zahrnuté zdravotné údaje, a uchovávajte iba polia, ktoré potrebujete. Všetky polia nájdete v dokumentácii [`telephony.complete` / `web.complete`](/sk/webhooks/call-complete). Každé doručenie je podpísané. Aplikácia pred spustením Zapu overí HMAC hlavičky `X-ThunderPhone-Signature` voči tajnému kľúču koncového bodu a zastaví sa pri každom nepodpísanom alebo neplatnom doručení. Ak Zapier doručenie neprijme, ThunderPhone ho bude opakovať až 24 hodín. Pozrite si [prehľad webhookov](/sk/webhooks/overview). ## Spúšťače, akcie a vyhľadávanie **Hovor vyhodnotený** poskytuje ID hovoru, ID agenta, meno agenta a údaje o hodnotení: ID hodnotenia, skóre, výsledok hovoru, súhrn, model hodnotiteľa a čas vyhodnotenia. Zapnutím Zapu sa vytvorí koncový bod s názvom **Zapier: Hovor vyhodnotený**. Hovor možno vyhodnotiť viackrát a každé dokončené vyhodnotenie spustí spúšťač. Pozrite si [`call.graded`](/sk/webhooks/events). **Nájsť hovor** prijíma ID hovoru s rozbaľovacím zoznamom nedávnych hovorov. Vracia agenta hovoru, smer, čísla, časy začatia a ukončenia, stav, dôvod ukončenia, skóre hodnotenia a výsledok hovoru, prepis a podpísanú adresu URL nahrávky, ak je k dispozícii. Neznáme ID hovoru nevráti výsledok namiesto chyby. **Uskutočniť odchádzajúci hovor** prijíma: | Pole | Význam | |---|---| | Agent | Uložený agent. Rozbaľovací zoznam obsahuje vaše agenty. | | Číslo príjemcu | Cieľ v formáte E.164, napríklad `+14155552671`. | | Číslo volajúceho | Rozbaľovací zoznam obsahuje iba čísla povolené pre odchádzajúce hovory. | | Premenné | Voliteľný objekt JSON s hodnotami pre zástupné symboly vo výzve agenta. | | Kľúč idempotencie | Stabilné ID zo spúšťača alebo zdrojového záznamu. Povinné. | Vracia ID hovoru, stav a idempotentné zopakovanie. **Pridať kontakty do kampane** pridá kontakty do konceptu kampane. Pre jeden kontakt vyplňte **Telefónne číslo** vo formáte E.164 a voliteľne **Premenné kontaktu**, objekt JSON, ktorého vlastnosti sa stanú premennými kampane. Pre dávku vyplňte **JSON kontaktov** poľom až 5 000 objektov. Každý potrebuje `phone_number` a jeho ostatné vlastnosti sa stanú premennými. Krok zlyhá, keď sú odmietnuté všetky kontakty, a nastaví **Čiastočný úspech**, keď sú odmietnuté iba niektoré. **Spustiť kampaň** spustí alebo obnoví kampaň, ktorá má aspoň jeden kontakt. Vyžaduje **Súhlas s účtovaním**. Pozrite si [Odchádzajúce kampane](/sk/guides/outbound-campaigns). ## Predtým, než Zap uskutoční hovory Uskutočniť odchádzajúci hovor a Spustiť kampaň vytáčajú skutočné telefónne čísla a spúšťajú spoplatnené hovory. - Ak ThunderPhone požiada vašu organizáciu o potvrdenie, že jej odchádzajúce hovory dodržiavajú zákon TCPA a ďalšie zákony o telefonovaní, administrátor musí toto potvrdenie zaznamenať na ovládacom paneli predtým, než Zap môže spúšťať hovory. - Číslo volajúceho musí byť povolené pre odchádzajúce hovory. Čísla prinesené od vlastného operátora spĺňajú podmienky po overení. Čísla poskytnuté službou ThunderPhone sú na začiatku iba pre prichádzajúce hovory a na ovládacom paneli pre ne môžete požiadať o prístup k odchádzajúcim hovorom. Pozrite si [Získať telefónne číslo](/sk/guides/get-a-phone-number). - Uskutočniť odchádzajúci hovor vyžaduje **Kľúč idempotencie**. Namapujte stabilné ID zo spúšťača alebo zdrojového záznamu, napríklad ID udalosti ThunderPhone alebo ID záznamu CRM. Ak Zapier krok zopakuje, ThunderPhone kľúč rozpozná a vráti pôvodný hovor namiesto uskutočnenia druhého. Vyhnite sa časovým pečiatkam, náhodným hodnotám alebo samotnému ID Zapu. - Spustiť kampaň vyžaduje **Súhlas s účtovaním**, ktorý potvrdzuje, že Zap môže vo vašom účte spúšťať spoplatnené odchádzajúce hovory. - Vaša organizácia zodpovedá za získanie súhlasu na volanie na každé číslo a za dodržiavanie platných zákonov o telefonovaní. Pozrite si [zákony o odchádzajúcich hovoroch](/sk/guides/outbound-calling-laws). Kľúč idempotencie je jedinečný v rámci vašej organizácie a môže mať najviac 128 znakov. Opätovné použitie kľúča s iným agentom, číslom alebo premennými zlyhá s konfliktom, preto ak môžu dva Zapy volať v súvislosti s rovnakým záznamom, dajte každému Zapu vlastnú pevnú predponu pred ID záznamu. [Uskutočňovanie odchádzajúcich hovorov](/sk/guides/place-outbound-calls) opisuje rozhranie API za touto akciou. ## Príklady Zapov - **Dokončený hovor do CRM.** Zaznamenajte aktivitu pre každý dokončený hovor spolu s jeho stavom, dôvodom ukončenia a prepisom. - **Vyhodnotený hovor na následné spracovanie.** Filtrujte podľa výsledku hovoru alebo skóre a nasmerujte hovor do správneho pracovného postupu následného spracovania. - **Nový lead do kampane.** Pridajte lead do konceptu kampane pomocou možnosti Pridať kontakty do kampane a potom po schválení zoznamu spustite možnosť Spustiť kampaň. Prepisy hovorov, súhrny a nahrávky môžu obsahovať osobné alebo zdravotné údaje. Odosielajte ich iba do aplikácií, ktoré vaša organizácia smie používať na tieto údaje, v prípade zdravotných údajov na základe BAA, a uchovávajte iba polia, ktoré potrebujete. ## Riešenie problémov **Krok zlyhá s chybou autorizácie.** Znova pripojte pripojenie ThunderPhone v Zapier a opätovne ho schváľte. Pripojenie prestane fungovať, keď osoba, ktorá ho pripojila, zruší jeho autorizáciu v ThunderPhone v časti **Organizácia → Kľúče → Autorizované aplikácie**, keď táto osoba opustí organizáciu alebo keď 30 dní neprebehne úspešné obnovenie tokenu. Pozrite si [Pripojenie pomocou OAuth](/sk/guides/oauth). **Zapnutie alebo vypnutie Zapu zlyhá alebo je akcia odmietnutá.** Osoba, ktorá pripojenie vytvorila, potrebuje v organizácii rolu správcu alebo vlastníka. Znova ho pripojte pomocou účtu, ktorý ju má. Spúšťací Zap, ktorý je už zapnutý, naďalej prijíma udalosti hovorov po zmene roly alebo zrušení pripojenia. Vypnite ho, aby ste ich zastavili. **Chcete odpojiť aplikáciu.** Pred zrušením pripojenia vypnite svoje Zapy ThunderPhone, pretože vypnutie Zapu odstráni jeho koncový bod a vyžaduje funkčné pripojenie. Ak ste pripojenie zrušili najskôr, odstráňte zostávajúci koncový bod **Zapier: …** pomocou `DELETE /v1/developer/webhook-endpoints/{id}` s použitím rozhrania API správcu. Pozrite si [Koncové body webhookov](/sk/webhooks/endpoints). **Zap má používať inú organizáciu.** Každé pripojenie sa vzťahuje na jednu organizáciu. Najskôr Zap vypnite, aby sa jeho koncový bod webhooku odstránil z aktuálnej organizácie. Potom v Zapier pripojte nový účet ThunderPhone, pri schvaľovaní vyberte druhú organizáciu a toto pripojenie zvoľte v každom kroku ThunderPhone. Agenti, čísla a kampane sa medzi organizáciami líšia, preto v každom kroku, ktorý ich obsahuje, znova vyberte **Agent**, **Číslo odosielateľa** a **Kampaň**. Potom Zap znova zapnite. **Spúšťač prestal fungovať.** Každý Zap so spúšťačom ThunderPhone má vo vašej organizácii jeden koncový bod webhooku s názvom **Zapier: Call Completed** alebo **Zapier: Call Graded**. Vytvorí sa pri zapnutí Zapu a odstráni sa pri jeho vypnutí. Nechajte ho bez zmien. Ak bol v ThunderPhone upravený alebo odstránený, vypnite a znova zapnite Zap, aby sa vytvoril nový. S použitím rozhrania API správcu [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) zobrazíte nedávne pokusy o doručenie. Chcete, aby agent počas hovoru používal akcie Zapier namiesto až po ňom? Pripojte koncový bod Zapier MCP v časti **Pripojenia → MCP**. Pozrite si [Servery MCP](/sk/guides/mcp-servers). Ak chcete odosielať rovnaké udalosti hovorov na vlastný server, pozrite si [Koncové body webhookov](/sk/webhooks/endpoints).