Uporabljajte ThunderPhone z Zapierjem

Povežite aplikacijo ThunderPhone v Zapierju s svojo organizacijo in ustvarite Zap, ki se zažene ob vsakem koncu klica.

Zapier povezuje aplikacije z avtomatiziranimi poteki dela, imenovanimi Zaps. Aplikacija ThunderPhone v Zapierju dodaja:

• Sprožilci: Klic dokončan se sproži, ko se telefonski, spletni ali testni klic konča. Klic ocenjen se sproži, ko je na voljo ocena dokončanega klica.
• Dejanja: Vzpostavi odhodni klic, Dodaj stike v kampanjo in Začni kampanjo.
• Iskanje: Najdi klic poišče klic po ID-ju in ga vrne skupaj z njegovim prepisom ter podpisanim URL-jem posnetka, kadar je ta na voljo.

Najdete jo na ThunderPhone v Zapierju. Za pregled obeh načinov uporabe Zapierja s ThunderPhone si oglejte stran integracije Zapier.

Povežite svojo organizacijo#

Aplikacija se poveže prek OAuth. Prijavite se v ThunderPhone in odobrite dostop za eno organizacijo, pri čemer se v Zapier ne kopira noben ključ API.

1. Dodajte korak ThunderPhone

   V urejevalniku Zap poiščite ThunderPhone (prikazan z oznako Beta) in izberite sprožilec ali dejanje. Ko Zapier zahteva račun, povežite novega. Zapier odpre okno za prijavo v ThunderPhone.

2. Prijavite se in izberite organizacijo

   Prijavite se, preverite zahtevana dovoljenja, izberite organizacijo in izberite Odobri. Aplikacija zahteva dovoljenja za branje vaših agentov in telefonskih številk, branje in zapisovanje klicev ter kampanj, upravljanje integracij, kot so končne točke webhookov, in ogled e-poštnega naslova vašega računa.

3. Preverite ime povezave

   Zapier povezavo poimenuje po organizaciji, ki ste jo odobrili, zato lahko povezave razlikujete, kadar pripadate več kot eni organizaciji.

Povežite račun, ki ima v tej organizaciji vlogo skrbnika ali lastnika. Za vklop ali izklop sprožilnega Zapa ter za vsako dejanje potrebujete to vlogo. Sprožilni Zap, ki je že vklopljen, še naprej prejema dogodke klicev po spremembi vloge ali preklicu povezave. Če jih želite ustaviti, ga izklopite. Funkcija Najdi klic deluje za vse člane.

Aplikacija sama nima stroškov ThunderPhone. Klici, ki jih vzpostavi ali začne, se zaračunajo po vaših običajnih cenah ThunderPhone, Zapier pa opravila šteje v okviru vašega paketa Zapier.

Ustvarite prvi Zap#

Ta Zap doda vrstico v Google Sheet vsakič, ko se klic konča.

1. Opravite klic za uporabo kot vzorčne podatke

   Odprite agenta v gradniku, kliknite Pogovor in končajte klic. Testni klici v gradniku sprožijo dogodek Klic zaključen, zato ima sprožilec nedavni klic, ki ga lahko naloži.

2. Dodajte sprožilec

   Kot aplikacijo sprožilca izberite ThunderPhone, dogodek nastavite na Klic zaključen in izberite svojo povezavo ThunderPhone. Preizkusite sprožilec. Zapier naloži vaše najnovejše zaključene klice kot vzorce v enaki obliki kot dogodek v živo.

3. Dodajte Google Sheets

   Dodajte dejanje Google Sheets, ki ustvari vrstico v preglednici. Izberite list z vrstico z glavami, nato pa vsak stolpec preslikajte v polje iz sprožilca (glejte spodnjo tabelo).

4. Objavite Zap

   Objavite in vklopite Zap. Z vklopom ustvarite končno točko webhooka v svoji organizaciji ThunderPhone z imenom Zapier: Klic zaključen. Z izklopom Zapa to končno točko izbrišete.

5. Preizkusite

   Opravite še en testni klic v gradniku. Ko se konča, se Zap zažene in pojavi se vrstica.

Uporabni stolpci:

Povezava do klica članom vaše organizacije odpre klic na nadzorni plošči ThunderPhone skupaj z njegovim prepisom in posnetkom, zato v preglednici ni treba hraniti nobenega od njiju.

Dogodek lahko vsebuje tudi prepis kot seznam izmenjav in URL posnetka, podpisano povezavo, ki poteče. Dodajte ju le, če ju preglednica potrebuje. Prepisi klicev, povzetki in posnetki lahko vsebujejo osebne ali zdravstvene podatke. Pošiljajte jih le v aplikacije, ki jih vaša organizacija sme uporabljati za te podatke, v skladu z BAA, kadar gre za zdravstvene podatke, in hranite le polja, ki jih potrebujete. Za vsa polja glejte telephony.complete / web.complete.

Sprožilci, dejanja in iskanje#

Klic ocenjen zagotavlja ID klica, ID agenta, ime agenta in oceno: ID ocene, rezultat, izid klica, povzetek, model ocenjevalnika in čas ocenjevanja. Vklop Zap-a ustvari končno točko z imenom Zapier: Klic ocenjen. Klic je lahko ocenjen več kot enkrat, vsak dokončan postopek ocenjevanja pa sproži sprožilec. Glejte call.graded.

Poišči klic sprejme ID klica s spustnim seznamom nedavnih klicev. Vrne agenta klica, smer, številke, čas začetka in konca, stanje, razlog zaključka, rezultat ocene in izid klica, prepis ter podpisan URL posnetka, kadar je na voljo. Neznan ID klica namesto napake ne vrne rezultata.

Vzpostavi odhodni klic sprejme:

Vrne ID klica, stanje in idempotentno ponovitev.

Dodaj stike v kampanjo doda stike v osnutek kampanje. Za en stik izpolnite Telefonska številka v obliki E.164 in po želji Spremenljivke stika, objekt JSON, katerega lastnosti postanejo spremenljivke kampanje. Za paket izpolnite JSON stikov s poljem do 5.000 predmetov. Vsak potrebuje phone_number, njegove druge lastnosti pa postanejo spremenljivke. Korak ne uspe, kadar so vsi stiki zavrnjeni, in nastavi Delni uspeh, kadar so zavrnjeni le nekateri.

Začni kampanjo začne ali nadaljuje kampanjo, ki ima vsaj en stik. Zahteva Soglasje za zaračunavanje. Glejte Odhodne kampanje.

Preden Zap vzpostavi klice#

Vzpostavi odhodni klic in Začni kampanjo kličeta resnične telefonske številke in začneta zaračunljive klice.

• Če ThunderPhone od vaše organizacije zahteva potrditev, da njeni odhodni klici upoštevajo TCPA in druge zakone o klicanju, mora skrbnik to potrditev zabeležiti na nadzorni plošči, preden lahko Zap začne klice.
• Številka klicatelja mora biti omogočena za odhodne klice. Številke, ki jih prinesete od lastnega operaterja, so upravičene po preverjanju. Številke, ki jih zagotovi ThunderPhone, so sprva samo za dohodne klice, za njih pa lahko na nadzorni plošči zahtevate dostop za odhodne klice. Glejte Pridobite telefonsko številko.
• Vzpostavi odhodni klic zahteva Ključ idempotentnosti. Preslikajte stabilen ID iz sprožilca ali izvornega zapisa, na primer ID dogodka ThunderPhone ali ID zapisa CRM. Če Zapier ponovi korak, ThunderPhone prepozna ključ in vrne prvotni klic, namesto da bi vzpostavil drugega. Izogibajte se časovnim žigom, naključnim vrednostim ali samo ID-ju Zap-a.
• Začni kampanjo zahteva Soglasje za zaračunavanje, ki potrjuje, da lahko Zap v vašem računu začne zaračunljive odhodne klice.
• Vaša organizacija je odgovorna za pridobitev soglasja za klicanje vsake številke in za upoštevanje veljavnih zakonov o klicanju. Glejte zakoni o odhodnem klicanju.

Ključ idempotentnosti je enoličen v vaši organizaciji in ima lahko največ 128 znakov. Ponovna uporaba ključa z drugim agentom, številko ali spremenljivkami ne uspe zaradi spora, zato vsakemu Zap-u, ki lahko kliče glede istega zapisa, dodelite lastno nespremenljivo predpono pred ID-jem zapisa. Vzpostavljanje odhodnih klicev opisuje API za tem dejanjem.

Primeri Zapov#

• Zaključen klic v CRM. Zabeležite dejavnost za vsak zaključen klic z njegovim stanjem, razlogom zaključka in prepisom.
• Ocenjen klic za nadaljnjo obravnavo. Filtrirajte glede na izid ali oceno klica in usmerite klic v ustrezen potek nadaljnje obravnave.
• Nov potencialni kontakt v kampanjo. Dodajte potencialni kontakt v osnutek kampanje z možnostjo Dodajte stike v kampanjo, nato pa zaženite Zaženite kampanjo, ko nekdo odobri seznam.

Prepisi, povzetki in posnetki klicev lahko vsebujejo osebne ali zdravstvene podatke. Pošiljajte jih samo aplikacijam, ki jih vaša organizacija sme uporabljati za te podatke, na podlagi pogodbe BAA, kadar gre za zdravstvene podatke, in hranite samo polja, ki jih potrebujete.

Odpravljanje težav#

Korak ne uspe zaradi napake pri avtorizaciji. Znova povežite povezavo ThunderPhone v Zapierju in jo znova odobrite. Povezava preneha delovati, ko jo oseba, ki jo je povezala, prekliče v ThunderPhoneu v razdelku Organizacija → Ključi → Pooblaščene aplikacije, ko ta oseba zapusti organizacijo ali ko 30 dni ne pride do uspešne osvežitve žetona. Oglejte si Povezovanje z OAuth.

Vklop ali izklop Zapa ne uspe oziroma je dejanje zavrnjeno. Oseba, ki je vzpostavila povezavo, potrebuje vlogo skrbnika ali lastnika v organizaciji. Znova se povežite z računom, ki ima to vlogo. Zap s sprožilcem, ki je že vklopljen, še naprej prejema dogodke klicev po spremembi vloge ali preklicu povezave. Izklopite ga, da jih ustavite.

Želite odklopiti aplikacijo. Preden prekličete povezavo, izklopite svoje Zape ThunderPhone, saj izklop Zapa izbriše njegovo končno točko in zahteva delujočo povezavo. Če ste povezavo najprej preklicali, izbrišite preostalo končno točko Zapier: … z ukazom DELETE /v1/developer/webhook-endpoints/{id} z uporabo skrbniškega ključa API. Oglejte si Končne točke webhookov.

Zap mora uporabljati drugo organizacijo. Vsaka povezava pokriva eno organizacijo. Najprej izklopite Zap, da se njegova končna točka webhooka izbriše iz trenutne organizacije. Nato v Zapierju povežite nov račun ThunderPhone, pri odobritvi izberite drugo organizacijo in na vsakem koraku ThunderPhone izberite to povezavo. Glasovni agenti, številke in kampanje se med organizacijami razlikujejo, zato znova izberite Glasovni agent, Številka klicatelja in Kampanja pri vsakem koraku, ki jih vsebuje. Nato Zap znova vklopite.

Sprožilec se ne izvaja več. Vsak Zap s sprožilcem ThunderPhone ima v vaši organizaciji svojo končno točko webhooka z imenom Zapier: Zaključen klic ali Zapier: Ocenjen klic. Ustvari se ob vklopu Zapa in izbriše ob njegovem izklopu. Pustite jo nespremenjeno. Če je bila v ThunderPhoneu urejena ali izbrisana, Zap izklopite in znova vklopite, da ustvarite novo. S skrbniškim ključem API GET /v1/developer/webhook-deliveries prikaže nedavne poskuse dostave.