--- title: "Kasuta ThunderPhone’i Zapieriga" description: "Ühenda Zapieris olev ThunderPhone’i rakendus oma organisatsiooniga ja loo Zap, mis käivitub iga kord, kui kõne lõpeb." --- [Zapier](https://zapier.com) ühendab rakendusi automatiseeritud töövoogudega, mida nimetatakse Zapideks. ThunderPhone'i rakendus Zapieris lisab: - **Käivitajad:** **Kõne lõpetatud** käivitub telefoni-, veebi- või testkõne lõppemisel. **Kõne hinnatud** käivitub, kui lõpetatud kõne hinne on saadaval. - **Toimingud:** **Tee väljaminev kõne**, **Lisa kontaktid kampaaniasse** ja **Alusta kampaaniat**. - **Otsing:** **Leia kõne** otsib kõnet ID järgi ning tagastab selle koos transkriptsiooni ja allkirjastatud salvestuse URL-iga, kui see on saadaval. Leia see aadressilt [ThunderPhone Zapieris](https://zapier.com/apps/thunderphone/integrations). Ülevaate saamiseks mõlemast viisist, kuidas Zapieri ThunderPhone'iga kasutada, vaata [Zapieri integratsiooni lehte](https://thunderphone.com/integrations/zapier). ## Ühenda oma organisatsioon Rakendus ühendub OAuthi kaudu. Logid ThunderPhone'i sisse ja kinnitad juurdepääsu ühele organisatsioonile ning Zapierisse ei kopeerita API-võtit. Otsi Zapi redaktoris **ThunderPhone** (kuvatakse Beta sildiga) ja vali käivitaja või toiming. Kui Zapier küsib kontot, ühenda uus konto. Zapier avab ThunderPhone'i sisselogimisakna. Logi sisse, kontrolli taotletud õigusi, vali organisatsioon ja vali **Kinnita**. Rakendus taotleb õigust lugeda sinu agente ja telefoninumbreid, lugeda ja kirjutada kõnesid ning kampaaniaid, hallata integratsioone, näiteks veebikonksu lõpp-punkte, ning näha sinu konto e-posti aadressi. Zapier nimetab ühenduse kinnitatud organisatsiooni järgi, et saaksid ühendusi eristada, kui kuulud rohkem kui ühte organisatsiooni. Ühenda kontoga, millel on selles organisatsioonis administraatori või omaniku roll. Käivitaja Zapi sisse- või väljalülitamiseks ja iga toimingu tegemiseks on seda rolli vaja. Juba sisse lülitatud käivitaja Zap saab kõnesündmusi edasi ka pärast rolli muutumist või ühenduse tühistamist. Nende peatamiseks lülita see välja. **Leia kõne** töötab iga liikme jaoks. Rakendusel ei ole eraldi ThunderPhone'i tasu. Selle tehtud või alustatud kõnede eest esitatakse arve sinu tavapäraste ThunderPhone'i hindade alusel ning Zapier arvestab ülesandeid sinu Zapieri paketi järgi. ## Loo esimene Zap See Zap lisab Google Sheetsi rea iga kord, kui kõne lõpeb. Ava koosturis häälagent, klõpsa **Räägi** ja lõpeta kõne. Koosturi testkõned käivitavad sündmuse Kõne lõpetatud, seega saab käivitaja laadida hiljutise kõne. Vali käivitajarakenduseks **ThunderPhone**, määra sündmuseks **Kõne lõpetatud** ja vali oma ThunderPhone'i ühendus. Testi käivitajat. Zapier laadib näidistena sinu viimati lõpetatud kõned samas vormingus nagu reaalajas sündmus. Lisa Google Sheetsi toiming, mis loob arvutustabelisse rea. Vali päisereaga leht, seejärel seo iga veerg käivitaja väljaga (vaata allolevat tabelit). Avalda Zap ja lülita see sisse. Sisselülitamine loob sinu ThunderPhone'i organisatsioonis webhooki lõpp-punkti nimega **Zapier: Kõne lõpetatud**. Zapi väljalülitamine kustutab selle lõpp-punkti. Tee veel üks koosturi testkõne. Kui see lõpeb, käivitub Zap ja ilmub uus rida. Kasulikud veerud: | Veerg | Kõne lõpetatud väli | |---|---| | Kõne ID | Kõne ID | | Häälagent | Häälagendi nimi | | Suund | Suund | | Kellelt | Saatja number | | Kellele | Saaja number | | Alustatud | Algusaeg | | Lõpetatud | Lõpuaeg | | Kestus (s) | Kestus sekundites | | Olek | Olek | | Lõpetamise põhjus | Lõpetamise põhjus | | Kõne link | Sisesta `https://app.thunderphone.com/dashboard/call-history/`, seejärel lisa kõne ID | Kõne link avab kõne ThunderPhone'i töölaual sinu organisatsiooni liikmetele koos transkriptsiooni ja salvestusega, seega ei pea tabel kumbagi sisaldama. Sündmus võib sisaldada ka transkriptsiooni kõnevoorude loendina ning salvestuse URL-i, mis on aeguv allkirjastatud link. Lisa need ainult siis, kui tabel neid vajab. Kõnede transkriptsioonid, kokkuvõtted ja salvestused võivad sisaldada isiku- või terviseandmeid. Saada need ainult rakendustesse, mida sinu organisatsioonil on õigus nende andmete jaoks kasutada, terviseandmete korral BAA alusel, ning säilita ainult vajalikud väljad. Kõigi väljade kohta vaata [`telephony.complete` / `web.complete`](/et/webhooks/call-complete). Iga edastus on allkirjastatud. Rakendus kontrollib enne Zapi käivitumist `X-ThunderPhone-Signature` HMAC-i lõpp-punkti salajase võtme alusel ning peatab kõik allkirjastamata või vigased edastused. Kui Zapier ei võta edastust vastu, proovib ThunderPhone seda uuesti kuni 24 tunni jooksul. Vaata [webhookide ülevaadet](/et/webhooks/overview). ## Käivitajad, toimingud ja otsing **Kõne hinnatud** annab kõne ID, agendi ID, agendi nime ja hinde: hinde ID, skoori, kõne tulemuse, kokkuvõtte, hindamismudeli ja hindamise aja. Zapi sisselülitamisel luuakse lõpp-punkt nimega **Zapier: Call Graded**. Kõnet saab hinnata rohkem kui ühe korra ning iga lõpetatud hindamiskäitus käivitab käivitaja. Vaata [`call.graded`](/et/webhooks/events). **Leia kõne** kasutab kõne ID-d koos hiljutiste kõnede rippmenüüga. See tagastab kõne agendi, suuna, numbrid, algus- ja lõpuajad, oleku, lõpetamise põhjuse, hinde skoori ja kõne tulemuse, transkriptsiooni ning allkirjastatud salvestise URL-i, kui see on saadaval. Tundmatu kõne ID ei tagasta vea asemel tulemust. **Tee väljaminev kõne** kasutab järgmist: | Väli | Tähendus | |---|---| | Agent | Salvestatud agent. Rippmenüüs kuvatakse sinu agendid. | | Sihtnumber | Sihtkoht E.164 vormingus, näiteks `+14155552671`. | | Lähtekõnenumber | Rippmenüüs kuvatakse ainult väljaminevateks kõnedeks lubatud numbrid. | | Muutujad | Valikuline JSON-objekt väärtustega agendi juhises olevate kohatäidete jaoks. | | Idempotentsusvõti | Käivitajast või lähtekirjest pärit püsiv ID. Kohustuslik. | See tagastab kõne ID, oleku ja idempotentse korduse. **Lisa kontaktid kampaaniasse** lisab kontaktid mustandkampaaniasse. Ühe kontakti jaoks täida **Telefoninumber** E.164 vormingus ja soovi korral **Kontakti muutujad**, JSON-objekt, mille omadustest saavad kampaania muutujad. Partii jaoks täida **Kontaktide JSON** kuni 5 000 objektist koosneva massiiviga. Iga objekt vajab `phone_number`-it ning selle muud omadused muutuvad muutujateks. Samm nurjub, kui kõik kontaktid lükatakse tagasi, ja määrab olekuks **Osaline õnnestumine**, kui tagasi lükatakse ainult osa kontaktidest. **Alusta kampaaniat** alustab või jätkab kampaaniat, millel on vähemalt üks kontakt. See nõuab **Nõusolekut tasu võtmiseks**. Vaata [Väljaminevad kampaaniad](/et/guides/outbound-campaigns). ## Enne kui Zap kõnesid teeb Väljamineva kõne tegemine ja kampaania alustamine helistavad päris telefoninumbritele ning alustavad tasulisi kõnesid. - Kui ThunderPhone palub sinu organisatsioonil kinnitada, et selle väljaminevad kõned järgivad TCPA-d ja muid helistamist käsitlevaid seadusi, peab administraator selle kinnituse juhtpaneelil registreerima, enne kui Zap saab kõnesid alustada. - Lähtekõnenumber peab olema väljaminevateks kõnedeks lubatud. Oma teenusepakkujalt toodud numbrid sobivad pärast kinnitamist. ThunderPhone'i pakutavad numbrid on algselt ainult sissetulevate kõnede jaoks ning nende jaoks saad juhtpaneelil taotleda väljaminevate kõnede juurdepääsu. Vaata [Hangi telefoninumber](/et/guides/get-a-phone-number). - Väljamineva kõne tegemine nõuab **idempotentsusvõtit**. Seo käivitajast või lähtekirjest pärit püsiv ID, näiteks ThunderPhone'i sündmuse ID või CRM-i kirje ID. Kui Zapier proovib sammu uuesti, tuvastab ThunderPhone võtme ja tagastab algse kõne, selle asemel et teha teine kõne. Väldi ajatemplite, juhuslike väärtuste või ainult Zapi ID kasutamist. - Kampaania alustamine nõuab **nõusolekut tasu võtmiseks**, mis kinnitab, et Zap võib sinu kontol alustada tasulisi väljaminevaid kõnesid. - Sinu organisatsioon vastutab selle eest, et iga numbri helistamiseks oleks nõusolek ja et järgitaks kohaldatavaid helistamist käsitlevaid seadusi. Vaata [väljaminevaid kõnesid käsitlevad seadused](/et/guides/outbound-calling-laws). Idempotentsusvõti on sinu organisatsioonis kordumatu ja võib olla kuni 128 märgi pikkune. Võtme taaskasutamine teise agendi, numbri või muutujatega nurjub konfliktiga, seega kui kaks Zapi võivad helistada sama kirje kohta, anna igale Zapile enne kirje ID-d oma kindel eesliide. [Väljaminevate kõnede tegemine](/et/guides/place-outbound-calls) käsitleb selle toimingu aluseks olevat API-t. ## Näidis-Zapid - **Lõpetatud kõne CRM-i.** Logi iga lõpetatud kõne kohta tegevus koos selle oleku, lõpetamise põhjuse ja transkriptsiooniga. - **Hinnatud kõne järeltegevusse.** Filtreeri kõne tulemuse või skoori järgi ja suuna kõne õigesse järeltegevuse töövoogu. - **Uus müügivihje kampaaniasse.** Lisa müügivihje mustandkampaaniasse toiminguga Lisa kontaktid kampaaniasse, seejärel käivita Alusta kampaaniat, kui keegi on loendi heaks kiitnud. Kõnede transkriptsioonid, kokkuvõtted ja salvestised võivad sisaldada isiku- või terviseandmeid. Saada neid ainult rakendustesse, mida sinu organisatsioonil on õigus nende andmete jaoks kasutada, terviseandmete korral BAA alusel, ja säilita ainult vajalikud väljad. ## Tõrkeotsing **Toiming nurjub autoriseerimisveaga.** Loo Zapieris ThunderPhone'i ühendus uuesti ja kinnita see uuesti. Ühendus lakkab töötamast, kui selle loonud isik tühistab selle ThunderPhone'is menüüs **Organisatsioon → Võtmed → Volitatud rakendused**, kui see isik lahkub organisatsioonist või kui 30 päeva jooksul ei õnnestu märgendi värskendamine. Vaata [OAuth-iga ühendamine](/et/guides/oauth). **Zapi sisse- või väljalülitamine nurjub või toimingust keeldutakse.** Ühenduse loonud isikul peab organisatsioonis olema administraatori või omaniku roll. Loo ühendus uuesti kontoga, millel see roll on. Juba sisse lülitatud käivitaja-Zap saab kõnesündmusi edasi ka pärast rolli muutmist või ühenduse tühistamist. Nende peatamiseks lülita see välja. **Soovid rakenduse ühenduse katkestada.** Lülita oma ThunderPhone'i Zapid välja enne ühenduse tühistamist, sest Zapi väljalülitamine kustutab selle lõpp-punkti ja vajab toimivat ühendust. Kui tühistasid ühenduse esmalt, kustuta allesjäänud **Zapier: …** lõpp-punkt käsuga `DELETE /v1/developer/webhook-endpoints/{id}`, kasutades administraatori API-võtit. Vaata [Veebihaagi lõpp-punktid](/et/webhooks/endpoints). **Zap peaks kasutama teist organisatsiooni.** Iga ühendus hõlmab üht organisatsiooni. Lülita Zap esmalt välja, et selle veebihaagi lõpp-punkt kustutataks praegusest organisatsioonist. Seejärel ühenda Zapieris uus ThunderPhone'i konto, vali kinnitamisel teine organisatsioon ja vali see ühendus igas ThunderPhone'i toimingus. Agendid, numbrid ja kampaaniad on organisatsiooniti erinevad, seega vali **Agent**, **Lähtekõnenumber** ja **Kampaania** uuesti igas toimingus, kus need esinevad. Seejärel lülita Zap uuesti sisse. **Käivitaja ei käivitu enam.** Iga ThunderPhone'i käivitajaga Zap on seotud ühe veebihaagi lõpp-punktiga sinu organisatsioonis, nimega **Zapier: Call Completed** või **Zapier: Call Graded**. See luuakse Zapi sisselülitamisel ja kustutatakse selle väljalülitamisel. Jäta see muutmata. Kui seda muudeti või kustutati ThunderPhone'is, lülita Zap välja ja uuesti sisse, et luua uus lõpp-punkt. Administraatori API-võtmega näitab [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) hiljutisi edastamiskatseid. Kas soovid, et häälagent kasutaks Zapieri toiminguid kõne ajal, mitte pärast seda? Ühenda Zapieri MCP lõpp-punkt menüüs **Ühendused → MCP**. Vaata [MCP-serverid](/et/guides/mcp-servers). Samade kõnesündmuste saatmiseks oma serverisse vaata [Veebihaagi lõpp-punktid](/et/webhooks/endpoints).