--- title: "Izmantojiet ThunderPhone ar Zapier" description: "Savienojiet ThunderPhone lietotni Zapier platformā ar savu organizāciju un izveidojiet Zap, kas tiek palaists ikreiz, kad zvans beidzas." --- [Zapier](https://zapier.com) savieno lietotnes ar automatizētām darbplūsmām, ko sauc par Zap. ThunderPhone lietotne pakalpojumā Zapier nodrošina: - **Trigeri:** **Zvans pabeigts** tiek aktivizēts, kad beidzas tālruņa, tīmekļa vai testa zvans. **Zvans novērtēts** tiek aktivizēts, kad ir pieejams pabeigta zvana novērtējums. - **Darbības:** **Veikt izejošo zvanu**, **Pievienot kontaktpersonas kampaņai** un **Sākt kampaņu**. - **Meklēšana:** **Atrast zvanu** atrod zvanu pēc ID un atgriež to kopā ar tā transkriptu un parakstītu ieraksta URL, ja tas ir pieejams. Atrodiet to vietnē [ThunderPhone pakalpojumā Zapier](https://zapier.com/apps/thunderphone/integrations). Lai iegūtu pārskatu par abiem veidiem, kā izmantot Zapier ar ThunderPhone, skatiet [Zapier integrācijas lapu](https://thunderphone.com/integrations/zapier). ## Savienojiet savu organizāciju Lietotne izveido savienojumu, izmantojot OAuth. Jūs pierakstāties ThunderPhone un apstiprināt piekļuvi vienai organizācijai, un neviena API atslēga netiek kopēta uz Zapier. Zap redaktorā meklējiet **ThunderPhone** (redzams ar Beta etiķeti) un izvēlieties trigeri vai darbību. Kad Zapier pieprasa kontu, pievienojiet jaunu kontu. Zapier atver ThunderPhone pierakstīšanās logu. Pierakstieties, pārbaudiet pieprasītās atļaujas, izvēlieties organizāciju un atlasiet **Apstiprināt**. Lietotne pieprasa atļauju lasīt jūsu balss aģentus un tālruņa numurus, lasīt un rakstīt zvanus un kampaņas, pārvaldīt integrācijas, piemēram, tīmekļa aizķeres galapunktus, un skatīt jūsu konta e-pasta adresi. Zapier nosauc savienojumu tās organizācijas vārdā, kuru apstiprinājāt, tāpēc varat atšķirt savienojumus, ja piederat vairāk nekā vienai organizācijai. Izveidojiet savienojumu ar kontu, kam šajā organizācijā ir administratora vai īpašnieka loma. Lai ieslēgtu vai izslēgtu trigera Zap, kā arī veiktu jebkuru darbību, ir nepieciešama šī loma. Jau ieslēgts trigera Zap turpina saņemt zvanu notikumus pēc lomas maiņas vai savienojuma atsaukšanas. Izslēdziet to, lai tos apturētu. **Atrast zvanu** darbojas jebkuram dalībniekam. Lietotnei nav atsevišķas ThunderPhone maksas. Tās veiktie vai sāktie zvani tiek norēķināti pēc jūsu parastajiem ThunderPhone tarifiem, un Zapier uzskaita uzdevumus atbilstoši jūsu Zapier plānam. ## Izveidojiet pirmo Zap Šis Zap pievieno rindu Google izklājlapai ikreiz, kad zvans beidzas. Atveriet balss aģentu veidotājā, noklikšķiniet uz **Runāt** un pabeidziet zvanu. Veidotāja testa zvani izraisa notikumu **Zvans pabeigts**, tāpēc trigerim būs nesens zvans, ko ielādēt. Izvēlieties **ThunderPhone** kā trigera lietotni, iestatiet notikumu uz **Zvans pabeigts** un atlasiet savu ThunderPhone savienojumu. Pārbaudiet trigeri. Zapier ielādē jūsu pēdējos pabeigtos zvanus kā paraugus tādā pašā formātā kā tiešraides notikums. Pievienojiet Google Sheets darbību, kas izveido izklājlapas rindu. Izvēlieties lapu ar galvenes rindu, pēc tam saistiet katru kolonnu ar trigera lauku (skatiet tabulu tālāk). Publicējiet un ieslēdziet Zap. To ieslēdzot, jūsu ThunderPhone organizācijā tiek izveidots tīmekļa aizķeres galapunkts ar nosaukumu **Zapier: Zvans pabeigts**. Izslēdzot Zap, šis galapunkts tiek dzēsts. Veiciet vēl vienu veidotāja testa zvanu. Kad tas beidzas, tiek palaists Zap un tiek parādīta rinda. Noderīgas kolonnas: | Kolonna | Lauks Zvans pabeigts | |---|---| | Zvana ID | Zvana ID | | Aģents | Aģenta nosaukums | | Virziens | Virziens | | No | Numurs, no kura zvanīts | | Uz | Numurs, uz kuru zvanīts | | Sākts | Sākuma laiks | | Beidzies | Beigu laiks | | Ilgums (s) | Ilgums sekundēs | | Statuss | Statuss | | Beigšanas iemesls | Beigšanas iemesls | | Zvana saite | Ierakstiet `https://app.thunderphone.com/dashboard/call-history/`, pēc tam ievietojiet zvana ID | Zvana saite atver zvanu ThunderPhone informācijas panelī jūsu organizācijas dalībniekiem kopā ar tā transkripciju un ierakstu, tāpēc tie nav jāglabā izklājlapā. Notikumā var būt arī transkripcija kā sarunas gājienu saraksts un ieraksta URL — parakstīta saite ar derīguma termiņu. Pievienojiet tos tikai tad, ja tie ir nepieciešami izklājlapai. Zvana transkripcijās, kopsavilkumos un ierakstos var būt personas vai veselības informācija. Nosūtiet tos tikai lietotnēm, ko jūsu organizācijai ir atļauts izmantot šiem datiem, ar BAA, ja ir iesaistīta veselības informācija, un glabājiet tikai nepieciešamos laukus. Skatiet [`telephony.complete` / `web.complete`](/lv/webhooks/call-complete), lai uzzinātu par visiem laukiem. Katra piegāde ir parakstīta. Lietotne pārbauda `X-ThunderPhone-Signature` HMAC pret galapunkta slepeno atslēgu pirms Zap palaišanas un aptur visu, kas nav parakstīts vai ir nederīgs. Ja Zapier nepieņem piegādi, ThunderPhone mēģina to nosūtīt atkārtoti līdz 24 stundām. Skatiet [tīmekļa aizķeru pārskatu](/lv/webhooks/overview). ## Aktivizētāji, darbības un meklēšana **Zvans novērtēts** nodrošina zvana ID, aģenta ID, aģenta nosaukumu un novērtējumu: novērtējuma ID, punktu skaitu, zvana iznākumu, kopsavilkumu, vērtētāja modeli un novērtēšanas laiku. Ieslēdzot Zap, tiek izveidots galapunkts ar nosaukumu **Zapier: Zvans novērtēts**. Zvanu var novērtēt vairāk nekā vienu reizi, un katra pabeigtā novērtēšanas izpilde aktivizē aktivizētāju. Skatiet [`call.graded`](/lv/webhooks/events). **Atrast zvanu** izmanto zvana ID ar neseno zvanu nolaižamo sarakstu. Tas atgriež zvana aģentu, virzienu, numurus, sākuma un beigu laikus, statusu, beigu iemeslu, novērtējuma punktu skaitu un zvana iznākumu, transkripciju un parakstītu ieraksta URL, ja tāds ir pieejams. Nezināms zvana ID kļūdas vietā neatgriež rezultātu. **Veikt izejošo zvanu** izmanto: | Lauks | Nozīme | |---|---| | Aģents | Saglabāts aģents. Nolaižamajā sarakstā ir jūsu aģenti. | | Numurs, uz kuru zvanīt | Galamērķis E.164 formātā, piemēram, `+14155552671`. | | Numurs, no kura zvanīt | Nolaižamajā sarakstā ir tikai izejošajiem zvaniem iespējotie numuri. | | Mainīgie | Neobligāts JSON objekts ar vērtībām aģenta uzvednē izmantotajiem vietturiem. | | Idempotences atslēga | Stabils ID no aktivizētāja vai avota ieraksta. Obligāts. | Tas atgriež zvana ID, statusu un idempotentu atkārtojumu. **Pievienot kontaktpersonas kampaņai** pievieno kontaktpersonas melnraksta kampaņai. Vienai kontaktpersonai aizpildiet **Tālruņa numurs** E.164 formātā un pēc izvēles **Kontaktpersonas mainīgie** — JSON objektu, kura rekvizīti kļūst par kampaņas mainīgajiem. Paketveida pievienošanai aizpildiet **Kontaktpersonu JSON** ar masīvu, kurā ir līdz 5 000 objektiem. Katram ir nepieciešams `phone_number`, un tā pārējie rekvizīti kļūst par mainīgajiem. Solis neizdodas, ja tiek noraidītas visas kontaktpersonas, un iestata **Daļēja veiksme**, ja tiek noraidīta tikai daļa. **Sākt kampaņu** sāk vai atsāk kampaņu, kurā ir vismaz viena kontaktpersona. Tam nepieciešama **Piekrišana maksai**. Skatiet [Izejošās kampaņas](/lv/guides/outbound-campaigns). ## Pirms Zap veic zvanus Veikt izejošo zvanu un Sākt kampaņu zvana uz reāliem tālruņa numuriem un sāk rēķinā iekļaujamus zvanus. - Ja ThunderPhone lūdz jūsu organizācijai apstiprināt, ka tās izejošie zvani atbilst TCPA un citiem zvanu regulējošiem tiesību aktiem, administratoram šis apstiprinājums ir jāreģistrē informācijas panelī, pirms Zap var sākt zvanus. - Numuram, no kura zvanīt, ir jābūt iespējotam izejošajiem zvaniem. Numuri, kurus izmantojat no sava telekomunikāciju operatora, ir piemēroti pēc to verificēšanas. ThunderPhone nodrošinātie numuri sākotnēji ir pieejami tikai ienākošajiem zvaniem, un informācijas panelī varat pieprasīt tiem piekļuvi izejošajiem zvaniem. Skatiet [Iegūt tālruņa numuru](/lv/guides/get-a-phone-number). - Veikt izejošo zvanu nepieciešama **Idempotences atslēga**. Saistiet stabilu ID no aktivizētāja vai avota ieraksta, piemēram, ThunderPhone notikuma ID vai CRM ieraksta ID. Ja Zapier atkārtoti mēģina izpildīt soli, ThunderPhone atpazīst atslēgu un otrā zvana veikšanas vietā atgriež sākotnējo zvanu. Neizmantojiet laikspiedolus, nejaušas vērtības vai tikai Zap ID. - Sākt kampaņu nepieciešama **Piekrišana maksai**, kas apstiprina, ka Zap drīkst jūsu kontā sākt rēķinā iekļaujamus izejošos zvanus. - Jūsu organizācija ir atbildīga par piekrišanas saņemšanu zvanīšanai uz katru numuru un par piemērojamo zvanu regulējošo tiesību aktu ievērošanu. Skatiet [izejošo zvanu tiesību akti](/lv/guides/outbound-calling-laws). Idempotences atslēga ir unikāla visā jūsu organizācijā, un tā var būt ne garāka par 128 rakstzīmēm. Atkārtota atslēgas izmantošana ar citu aģentu, numuru vai mainīgajiem neizdodas konflikta dēļ, tāpēc, ja divi Zap var zvanīt par vienu un to pašu ierakstu, pirms ieraksta ID piešķiriet katram Zap savu fiksētu prefiksu. [Veikt izejošos zvanus](/lv/guides/place-outbound-calls) apraksta šīs darbības pamatā esošo API. ## Zap piemēri - **Pabeigts zvans uz CRM.** Reģistrējiet darbību katram pabeigtajam zvanam ar tā statusu, beigu iemeslu un transkriptu. - **Novērtēts zvans turpmākai darbībai.** Filtrējiet pēc zvana rezultāta vai vērtējuma un novirziet zvanu uz atbilstošo turpmāko darbību darbplūsmu. - **Jauns potenciālais klients uz kampaņu.** Pievienojiet potenciālo klientu melnraksta kampaņai, izmantojot Pievienot kontaktpersonas kampaņai, pēc tam palaidiet Sākt kampaņu, kad kāds apstiprina sarakstu. Zvanu transkripti, kopsavilkumi un ieraksti var saturēt personas vai veselības informāciju. Sūtiet tos tikai uz lietotnēm, kuras jūsu organizācijai ir atļauts izmantot šādiem datiem, saskaņā ar BAA, ja ir iesaistīta veselības informācija, un glabājiet tikai nepieciešamos laukus. ## Problēmu novēršana **Darbība neizdodas autorizācijas kļūdas dēļ.** Atkārtoti savienojiet ThunderPhone savienojumu Zapier un vēlreiz apstipriniet to. Savienojums pārstāj darboties, kad persona, kas to savienoja, atsauc to ThunderPhone sadaļā **Organizācija → Atslēgas → Autorizētās lietotnes**, kad šī persona pamet organizāciju vai kad 30 dienas nav veikta veiksmīga tokena atjaunošana. Skatiet [Izveidot savienojumu ar OAuth](/lv/guides/oauth). **Neizdodas ieslēgt vai izslēgt Zap, vai darbība tiek noraidīta.** Personai, kas izveidoja savienojumu, organizācijā ir nepieciešama administratora vai īpašnieka loma. Atkārtoti savienojiet ar kontu, kuram tā ir. Aktivizētāja Zap, kas jau ir ieslēgts, turpina saņemt zvanu notikumus pēc lomas maiņas vai savienojuma atsaukšanas. Izslēdziet to, lai tos apturētu. **Vēlaties atvienot lietotni.** Pirms savienojuma atsaukšanas izslēdziet savus ThunderPhone Zap, jo Zap izslēgšana dzēš tā galapunktu un prasa darbojošos savienojumu. Ja vispirms atsaucāt savienojumu, izdzēsiet atlikušo galapunktu **Zapier: …** ar `DELETE /v1/developer/webhook-endpoints/{id}`, izmantojot administratora API atslēgu. Skatiet [Tīmekļa aizķeres galapunkti](/lv/webhooks/endpoints). **Zap jāizmanto cita organizācija.** Katrs savienojums aptver vienu organizāciju. Vispirms izslēdziet Zap, lai tā tīmekļa aizķeres galapunkts tiktu izdzēsts no pašreizējās organizācijas. Pēc tam Zapier savienojiet jaunu ThunderPhone kontu, apstiprinot izvēlieties otru organizāciju un katrā ThunderPhone darbībā atlasiet šo savienojumu. Balss aģenti, numuri un kampaņas dažādās organizācijās atšķiras, tāpēc katrā darbībā, kurā tie ir pieejami, vēlreiz atlasiet **Balss aģents**, **No numura** un **Kampaņa**. Pēc tam atkal ieslēdziet Zap. **Trigeris vairs nedarbojas.** Katram Zap ar ThunderPhone trigeri jūsu organizācijā pieder viens tīmekļa aizķeres galapunkts ar nosaukumu **Zapier: Pabeigts zvans** vai **Zapier: Novērtēts zvans**. Tas tiek izveidots, kad Zap tiek ieslēgts, un dzēsts, kad tas tiek izslēgts. Atstājiet to nemainītu. Ja tas tika rediģēts vai dzēsts ThunderPhone, izslēdziet un atkal ieslēdziet Zap, lai izveidotu jaunu. Izmantojot administratora API atslēgu, [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) parāda nesenos piegādes mēģinājumus. Vai vēlaties, lai balss aģents zvana laikā izmantotu Zapier darbības, nevis pēc tā? Savienojiet Zapier MCP galapunktu sadaļā **Savienojumi → MCP**. Skatiet [MCP serveri](/lv/guides/mcp-servers). Lai tos pašus zvanu notikumus nosūtītu uz savu serveri, skatiet [Tīmekļa aizķeres galapunkti](/lv/webhooks/endpoints).