Používajte ThunderPhone so Zapierom

Pripojte aplikáciu ThunderPhone v Zapieri k svojej organizácii a vytvorte Zap, ktorý sa spustí po každom ukončení hovoru.

Zapier 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. Prehľad oboch spôsobov používania Zapier s ThunderPhone nájdete na stránke integrácie 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.

1. Pridanie kroku ThunderPhone

   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.

2. Prihlásenie a výber organizácie

   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.

3. Kontrola názvu pripojenia

   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čí.

1. Uskutočnite hovor, ktorý použijete ako vzorové údaje

   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.

2. Pridajte spúšťač

   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ť.

3. Pridajte Tabuľky Google

   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).

4. Publikujte Zap

   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.

5. Otestujte ho

   Uskutočnite ďalší testovací hovor v editore. Keď sa skončí, Zap sa spustí a zobrazí sa riadok.

Užitočné stĺpce:

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.

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.

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:

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.

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.
• 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.

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 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.

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.

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 zobrazíte nedávne pokusy o doručenie.