---
title: "Uporabljajte ThunderPhone z Zapierjem"
description: "Povežite aplikacijo ThunderPhone v Zapierju s svojo organizacijo in ustvarite Zap, ki se zažene ob vsakem koncu klica."
---
[Zapier](https://zapier.com) 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](https://zapier.com/apps/thunderphone/integrations).
Za pregled obeh načinov uporabe Zapierja s ThunderPhone si oglejte
[stran integracije Zapier](https://thunderphone.com/integrations/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.
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.
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.
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.
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.
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.
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).
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.
Opravite še en testni klic v gradniku. Ko se konča, se Zap zažene in pojavi
se vrstica.
Uporabni stolpci:
| Stolpec | Polje Klic zaključen |
|---|---|
| ID klica | ID klica |
| Agent | Ime agenta |
| Smer | Smer |
| Od | Številka klicatelja |
| Za | Številka prejemnika |
| Začetek | Začetek ob |
| Konec | Konec ob |
| Trajanje (s) | Trajanje v sekundah |
| Stanje | Stanje |
| Razlog konca | Razlog konca |
| Povezava do klica | Vnesite `https://app.thunderphone.com/dashboard/call-history/`, nato vstavite ID klica |
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`](/sl/webhooks/call-complete).
Vsaka dostava je podpisana. Aplikacija pred zagonom Zapa preveri HMAC
`X-ThunderPhone-Signature` glede na skrivnost končne točke in se ustavi ob
vsakem nepodpisanem ali neveljavnem zahtevku. Če Zapier dostave ne sprejme,
jo ThunderPhone ponovno poskuša dostaviti do 24 ur. Glejte
[Pregled webhookov](/sl/webhooks/overview).
## 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`](/sl/webhooks/events).
**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:
| Polje | Pomen |
|---|---|
| Agent | Shranjen agent. Spustni seznam prikazuje vaše agente. |
| Številka za klic | Ciljna številka v obliki E.164, na primer `+14155552671`. |
| Številka klicatelja | Spustni seznam prikazuje samo številke, omogočene za odhodne klice. |
| Spremenljivke | Izbirni objekt JSON z vrednostmi za ograde v pozivu agenta. |
| Ključ idempotentnosti | Stabilen ID iz sprožilca ali izvornega zapisa. Obvezno. |
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](/sl/guides/outbound-campaigns).
## 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](/sl/guides/get-a-phone-number).
- 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](/sl/guides/outbound-calling-laws).
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](/sl/guides/place-outbound-calls) 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](/sl/guides/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](/sl/webhooks/endpoints).
**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`](/api-reference/webhook-deliveries)
prikaže nedavne poskuse dostave.
Želite, da agent med klicem uporablja dejanja Zapier namesto po njem?
Povežite končno točko MCP Zapier v razdelku **Povezave → MCP**. Oglejte si
[strežnike MCP](/sl/guides/mcp-servers). Če želite iste dogodke klicev pošiljati
na lasten strežnik, si oglejte [Končne točke webhookov](/sl/webhooks/endpoints).