--- title: "Koristite ThunderPhone sa Zapierom" description: "Povežite aplikaciju ThunderPhone na Zapieru sa svojom organizacijom i izradite Zap koji se pokreće svaki put kada poziv završi." --- [Zapier](https://zapier.com) povezuje aplikacije automatiziranim tijekovima rada koji se nazivaju Zapovi. Aplikacija ThunderPhone na Zapieru dodaje: - **Okidači:** **Poziv dovršen** aktivira se kada završi telefonski, web ili testni poziv. **Poziv ocijenjen** aktivira se kada ocjena dovršenog poziva postane dostupna. - **Radnje:** **Uputite odlazni poziv**, **Dodajte kontakte u kampanju** i **Pokrenite kampanju**. - **Pretraživanje:** **Pronađite poziv** traži poziv prema ID-u i vraća ga s njegovim prijepisom i potpisanim URL-om snimke kada je dostupan. Pronađite je na [ThunderPhone na Zapieru](https://zapier.com/apps/thunderphone/integrations). Za pregled oba načina upotrebe Zapiera s ThunderPhoneom pogledajte [stranicu integracije sa Zapierom](https://thunderphone.com/integrations/zapier). ## Povežite svoju organizaciju Aplikacija se povezuje putem OAutha. Prijavljujete se u ThunderPhone i odobravate pristup jednoj organizaciji, a API ključ ne kopira se u Zapier. U uređivaču Zapova potražite **ThunderPhone** (prikazan s oznakom Beta) i odaberite okidač ili radnju. Kada Zapier zatraži račun, povežite novi račun. Zapier otvara prozor za prijavu u ThunderPhone. Prijavite se, provjerite zatražene dozvole, odaberite organizaciju i odaberite **Odobrite**. Aplikacija traži dozvolu za čitanje vaših agenata i telefonskih brojeva, čitanje i pisanje poziva i kampanja, upravljanje integracijama kao što su krajnje točke webhooka te pregled e-adrese vašeg računa. Zapier vezu imenuje prema organizaciji koju ste odobrili kako biste mogli razlikovati veze kada pripadate više organizacija. Povežite račun koji ima administratorsku ili vlasničku ulogu u toj organizaciji. Uključivanje ili isključivanje Zapa s okidačem te svaka radnja zahtijevaju tu ulogu. Zap s okidačem koji je već uključen nastavlja primati događaje poziva nakon promjene uloge ili opoziva veze. Isključite ga da biste ih zaustavili. Pronađite poziv radi za svakog člana. Aplikacija nema zasebnu naknadu za ThunderPhone. Pozivi koje upućuje ili pokreće naplaćuju se po vašim uobičajenim cijenama ThunderPhonea, a Zapier broji zadatke u okviru vašeg Zapier paketa. ## Izradite prvi Zap Ovaj Zap dodaje redak u Google tablicu svaki put kada poziv završi. Otvorite agenta u alatu za izradu, kliknite **Razgovarajte** i završite poziv. Probni pozivi u alatu za izradu pokreću događaj Dovršeni poziv, pa okidač tako dobiva nedavni poziv za učitavanje. Odaberite **ThunderPhone** kao aplikaciju okidača, postavite događaj na **Dovršeni poziv** i odaberite svoju ThunderPhone vezu. Testirajte okidač. Zapier učitava vaše najnovije dovršene pozive kao ogledne podatke, u istom formatu kao događaj uživo. Dodajte radnju Google Sheets koja stvara redak u proračunskoj tablici. Odaberite tablicu s retkom zaglavlja, a zatim povežite svaki stupac s poljem iz okidača (pogledajte tablicu u nastavku). Objavite i uključite Zap. Uključivanjem se u vašoj organizaciji ThunderPhone stvara krajnja točka webhooka pod nazivom **Zapier: Call Completed**. Isključivanjem Zapa briše se ta krajnja točka. Uputite još jedan probni poziv u alatu za izradu. Kada završi, Zap se pokreće i pojavljuje se redak. Korisni stupci: | Stupac | Polje Dovršeni poziv | |---|---| | ID poziva | ID poziva | | Agent | Ime agenta | | Smjer | Smjer | | Od | Broj pozivatelja | | Za | Broj primatelja | | Početak | Vrijeme početka | | Završetak | Vrijeme završetka | | Trajanje (s) | Trajanje u sekundama | | Status | Status | | Razlog završetka | Razlog završetka | | Poveznica na poziv | Upišite `https://app.thunderphone.com/dashboard/call-history/`, a zatim umetnite ID poziva | Poveznica na poziv otvara poziv na nadzornoj ploči ThunderPhone za članove vaše organizacije, zajedno s prijepisom i snimkom, tako da tablica ne mora sadržavati nijedno od toga. Događaj može sadržavati i prijepis kao popis izmjena govornika te URL snimke, potpisanu poveznicu koja istječe. Dodajte ih samo ako su potrebni tablici. Prijepisi poziva, sažeci i snimke mogu sadržavati osobne ili zdravstvene podatke. Šaljite ih samo aplikacijama koje vaša organizacija smije koristiti za takve podatke, uz BAA kada se radi o zdravstvenim podacima, i zadržite samo polja koja su vam potrebna. Pogledajte [`telephony.complete` / `web.complete`](/hr/webhooks/call-complete) za svako polje. Svaka isporuka je potpisana. Aplikacija provjerava HMAC `X-ThunderPhone-Signature` u odnosu na tajnu krajnje točke prije pokretanja Zapa i zaustavlja ga ako je bilo što nepotpisano ili nevaljano. Ako Zapier ne prihvati isporuku, ThunderPhone je ponovno pokušava poslati do 24 sata. Pogledajte [Pregled webhookova](/hr/webhooks/overview). ## Okidači, radnje i pretraživanje **Poziv ocijenjen** pruža ID poziva, ID agenta, naziv agenta i ocjenu: ID ocjene, rezultat, ishod poziva, sažetak, model ocjenjivača i vrijeme ocjenjivanja. Uključivanjem Zapa stvara se krajnja točka pod nazivom **Zapier: Poziv ocijenjen**. Poziv se može ocijeniti više puta, a svako dovršeno pokretanje ocjenjivanja aktivira okidač. Pogledajte [`call.graded`](/hr/webhooks/events). **Pronađi poziv** prima ID poziva uz padajući izbornik nedavnih poziva. Vraća agenta poziva, smjer, brojeve, vrijeme početka i završetka, status, razlog završetka, rezultat ocjene i ishod poziva, prijepis te potpisani URL snimke kada je dostupan. Nepoznat ID poziva ne vraća rezultat umjesto pogreške. **Uputi odlazni poziv** prima: | Polje | Značenje | |---|---| | Agent | Spremljeni agent. Padajući izbornik navodi vaše agente. | | Broj za poziv | Odredište u formatu E.164, primjerice `+14155552671`. | | Broj s kojeg se poziva | Padajući izbornik navodi samo brojeve omogućene za odlazne pozive. | | Varijable | Neobavezni JSON objekt vrijednosti za rezervirana mjesta u upitu agenta. | | Ključ idempotentnosti | Stabilni ID iz okidača ili izvornog zapisa. Obavezno. | Vraća ID poziva, status i idempotentno ponavljanje. **Dodaj kontakte u kampanju** dodaje kontakte u skicu kampanje. Za jedan kontakt ispunite **Broj telefona** u formatu E.164 i, prema potrebi, **Varijable kontakta**, JSON objekt čija svojstva postaju varijable kampanje. Za skup kontakata ispunite **JSON kontakata** poljem s nizom od najviše 5.000 objekata. Svaki mora sadržavati `phone_number`, a njegova druga svojstva postaju varijable. Korak ne uspijeva kada se odbiju svi kontakti, a postavlja **Djelomičan uspjeh** kada se odbiju samo neki. **Pokreni kampanju** pokreće ili nastavlja kampanju koja ima najmanje jedan kontakt. Zahtijeva **Pristanak na naplatu**. Pogledajte [Odlazne kampanje](/hr/guides/outbound-campaigns). ## Prije nego što Zap uputi pozive Uputi odlazni poziv i Pokreni kampanju biraju stvarne telefonske brojeve i pokreću naplative pozive. - Ako ThunderPhone zatraži od vaše organizacije potvrdu da su njezini odlazni pozivi usklađeni s TCPA-om i drugim zakonima o pozivima, administrator mora zabilježiti tu potvrdu na nadzornoj ploči prije nego što Zap može pokretati pozive. - Broj s kojeg se poziva mora biti omogućen za odlazne pozive. Brojevi koje prenesete od vlastitog telekomunikacijskog operatora ispunjavaju uvjete nakon provjere. Brojevi koje pruža ThunderPhone u početku su samo za dolazne pozive, a za njih možete zatražiti pristup odlaznim pozivima na nadzornoj ploči. Pogledajte [Dohvatite telefonski broj](/hr/guides/get-a-phone-number). - Uputi odlazni poziv zahtijeva **Ključ idempotentnosti**. Mapirajte stabilni ID iz okidača ili izvornog zapisa, kao što je ID događaja ThunderPhonea ili ID zapisa u CRM-u. Ako Zapier ponovno pokuša izvršiti korak, ThunderPhone prepoznaje ključ i vraća izvorni poziv umjesto da uputi drugi. Izbjegavajte vremenske oznake, nasumične vrijednosti ili samo ID Zapa. - Pokreni kampanju zahtijeva **Pristanak na naplatu**, čime se potvrđuje da Zap može pokretati naplative odlazne pozive na vašem računu. - Vaša je organizacija odgovorna za pribavljanje pristanka za pozivanje svakog broja i za poštovanje primjenjivih zakona o pozivima. Pogledajte [zakoni o odlaznim pozivima](/hr/guides/outbound-calling-laws). Ključ idempotentnosti jedinstven je u cijeloj vašoj organizaciji i može imati najviše 128 znakova. Ponovna upotreba ključa s drugim agentom, brojem ili varijablama ne uspijeva zbog sukoba, stoga, ako dva Zapa mogu zvati u vezi s istim zapisom, svakom Zapu dodijelite vlastiti stalni prefiks prije ID-a zapisa. [Uputite odlazne pozive](/hr/guides/place-outbound-calls) opisuje API iza ove radnje. ## Primjeri Zapova - **Dovršeni poziv u CRM.** Zabilježite aktivnost za svaki dovršeni poziv s njegovim statusom, razlogom završetka i transkriptom. - **Ocijenjeni poziv za daljnje postupanje.** Filtrirajte prema ishodu ili ocjeni poziva i usmjerite poziv u odgovarajući tijek rada za daljnje postupanje. - **Novi potencijalni klijent u kampanju.** Dodajte potencijalnog klijenta u kampanju u nacrtu pomoću opcije Dodaj kontakte u kampanju, a zatim pokrenite opciju Pokreni kampanju kada netko odobri popis. Transkripti poziva, sažeci i snimke mogu sadržavati osobne ili zdravstvene podatke. Šaljite ih samo aplikacijama koje vaša organizacija smije koristiti za te podatke, na temelju sporazuma o poslovnom suradniku (BAA) kada su uključeni zdravstveni podaci, i zadržite samo polja koja su vam potrebna. ## Rješavanje problema **Korak ne uspijeva zbog pogreške autorizacije.** Ponovno povežite vezu s ThunderPhoneom u Zapieru i ponovno je odobrite. Veza prestaje raditi kada je osoba koja ju je povezala opozove u ThunderPhoneu u odjeljku **Organizacija → Ključevi → Ovlaštene aplikacije**, kada ta osoba napusti organizaciju ili kada 30 dana ne dođe do uspješnog osvježavanja tokena. Pogledajte [Povezivanje putem OAutha](/hr/guides/oauth). **Uključivanje ili isključivanje Zapa ne uspijeva ili je radnja odbijena.** Osoba koja je povezala račun mora imati ulogu administratora ili vlasnika u organizaciji. Ponovno se povežite računom koji ima tu ulogu. Zap s okidačem koji je već uključen nastavlja primati događaje poziva nakon promjene uloge ili opoziva veze. Isključite ga da biste to zaustavili. **Želite odspojiti aplikaciju.** Isključite svoje ThunderPhone Zapove prije nego što opozovete vezu jer se isključivanjem Zapa briše njegova krajnja točka i potrebna je ispravna veza. Ako ste vezu prvo opozvali, izbrišite preostalu krajnju točku **Zapier: …** pomoću naredbe `DELETE /v1/developer/webhook-endpoints/{id}` i administratorskog API ključa. Pogledajte [Krajnje točke webhooka](/hr/webhooks/endpoints). **Zap treba koristiti drugu organizaciju.** Svaka veza obuhvaća jednu organizaciju. Najprije isključite Zap kako bi se njegova krajnja točka webhooka izbrisala iz trenutačne organizacije. Zatim povežite novi ThunderPhone račun u Zapieru, odaberite drugu organizaciju kada odobravate vezu i odaberite tu vezu u svakom ThunderPhone koraku. Glasovni agenti, brojevi i kampanje razlikuju se među organizacijama, pa ponovno odaberite **Glasovni agent**, **Broj s kojeg se poziva** i **Kampanja** u svakom koraku koji ih sadrži. Zatim ponovno uključite Zap. **Okidač se prestao pokretati.** Svaki Zap s ThunderPhone okidačem ima jednu krajnju točku webhooka u vašoj organizaciji, nazvanu **Zapier: Dovršeni poziv** ili **Zapier: Ocijenjeni poziv**. Stvara se kada se Zap uključi, a briše kada se isključi. Ostavite je nepromijenjenom. Ako je uređena ili izbrisana u ThunderPhoneu, isključite Zap i ponovno ga uključite da biste stvorili novu. S administratorskim API ključem, [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) prikazuje nedavne pokušaje isporuke. Želite li da glasovni agent koristi Zapier radnje tijekom poziva umjesto nakon njega? Povežite Zapier MCP krajnju točku u odjeljku **Veze → MCP**. Pogledajte [MCP poslužitelji](/hr/guides/mcp-servers). Za slanje istih događaja poziva na vlastiti poslužitelj pogledajte [Krajnje točke webhooka](/hr/webhooks/endpoints).