---
title: "Naudokite ThunderPhone su Zapier"
description: "Prijunkite ThunderPhone programėlę Zapier platformoje prie savo organizacijos ir sukurkite Zap, kuris bus vykdomas kiekvieną kartą, kai baigiasi skambutis."
---

[Zapier](https://zapier.com) sujungia programas naudodama automatizuotas darbo eigas, vadinamas
„Zaps“. ThunderPhone programa sistemoje Zapier suteikia:

- **Paleidikliai:** **Skambutis baigtas** suveikia, kai baigiasi telefono, žiniatinklio ar bandomasis skambutis.
  **Skambutis įvertintas** suveikia, kai tampa pasiekiamas baigto skambučio įvertinimas.
- **Veiksmai:** **Skambinti į išorę**, **Pridėti kontaktus prie kampanijos** ir
  **Pradėti kampaniją**.
- **Paieška:** **Rasti skambutį** suranda skambutį pagal ID ir grąžina jį su
  jo transkriptu bei pasirašytu įrašo URL, jei jis pasiekiamas.

Ją rasite [ThunderPhone sistemoje Zapier](https://zapier.com/apps/thunderphone/integrations).
Abiejų Zapier naudojimo su ThunderPhone būdų apžvalgą rasite
[Zapier integracijos puslapyje](https://thunderphone.com/integrations/zapier).

## Prijunkite savo organizaciją

Programa jungiasi per OAuth. Prisijungiate prie ThunderPhone ir patvirtinate
prieigą vienai organizacijai, o API raktas į Zapier nekopijuojamas.

<Steps>
  <Step title="Pridėkite ThunderPhone veiksmą">
    Zap redaktoriuje ieškokite **ThunderPhone** (rodomas su Beta žyma)
    ir pasirinkite paleidiklį arba veiksmą. Kai Zapier paprašys paskyros, prijunkite naują. Zapier atidarys
    ThunderPhone prisijungimo langą.
  </Step>
  <Step title="Prisijunkite ir pasirinkite organizaciją">
    Prisijunkite, patikrinkite prašomus leidimus, pasirinkite organizaciją ir
    pasirinkite **Patvirtinti**. Programa prašo leisti skaityti jūsų agentus ir telefono numerius,
    skaityti bei rašyti skambučių ir kampanijų duomenis, tvarkyti integracijas, pvz., webhook
    galinius taškus, ir peržiūrėti jūsų paskyros el. paštą.
  </Step>
  <Step title="Patikrinkite ryšio pavadinimą">
    Zapier pavadina ryšį pagal jūsų patvirtintą organizaciją, todėl
    galite atskirti ryšius, kai priklausote daugiau nei vienai organizacijai.
  </Step>
</Steps>

Prisijunkite naudodami paskyrą, kuri turi administratoriaus arba savininko vaidmenį
toje organizacijoje. Įjungti ar išjungti paleidiklio Zap ir atlikti bet kurį veiksmą reikia šio
vaidmens. Jau įjungtas paleidiklio Zap ir toliau gauna skambučių įvykius, kai
pasikeičia vaidmuo arba panaikinamas ryšys. Išjunkite jį, kad juos sustabdytumėte. Funkcija
Rasti skambutį veikia bet kuriam nariui.

Programa pati už ThunderPhone papildomai neapmokestinama. Už skambučius, kuriuos ji atlieka arba pradeda,
mokate pagal įprastus ThunderPhone tarifus, o Zapier skaičiuoja užduotis pagal jūsų
Zapier planą.

## Sukurkite pirmąjį Zap

Šis Zap prideda eilutę į Google Sheets kaskart, kai baigiasi skambutis.

<Steps>
  <Step title="Atlikite skambutį, kurį naudosite kaip pavyzdinius duomenis">
    Atidarykite agentą kūrimo įrankyje, spustelėkite **Kalbėtis** ir baikite
    skambutį. Kūrimo įrankio bandomieji skambučiai suaktyvina įvykį **Skambutis
    baigtas**, todėl aktyviklis gauna neseną skambutį įkelti.
  </Step>
  <Step title="Pridėkite aktyviklį">
    Pasirinkite **ThunderPhone** kaip aktyviklio programą, nustatykite įvykį
    **Skambutis baigtas** ir pasirinkite savo ThunderPhone ryšį. Išbandykite
    aktyviklį. Zapier įkelia jūsų naujausius užbaigtus skambučius kaip
    pavyzdžius, tokios pat struktūros kaip tiesioginis įvykis.
  </Step>
  <Step title="Pridėkite Google Sheets">
    Pridėkite Google Sheets veiksmą, kuris sukuria skaičiuoklės eilutę.
    Pasirinkite lapą su antraščių eilute, tada susiekite kiekvieną stulpelį su
    aktyviklio lauku (žr. toliau pateiktą lentelę).
  </Step>
  <Step title="Paskelbkite Zap">
    Paskelbkite ir įjunkite Zap. Jį įjungus, jūsų ThunderPhone organizacijoje
    sukuriamas žiniatinklio kablio galinis taškas pavadinimu **Zapier:
    Skambutis baigtas**. Išjungus Zap, tas galinis taškas ištrinamas.
  </Step>
  <Step title="Išbandykite">
    Atlikite dar vieną kūrimo įrankio bandomąjį skambutį. Jam pasibaigus,
    paleidžiamas Zap ir atsiranda eilutė.
  </Step>
</Steps>

Naudingi stulpeliai:

| Stulpelis | Skambučio baigimo laukas |
|---|---|
| Skambučio ID | Skambučio ID |
| Agentas | Agento pavadinimas |
| Kryptis | Kryptis |
| Iš | Numeris, iš kurio skambinta |
| Kam | Numeris, kuriuo skambinta |
| Pradėta | Pradžios laikas |
| Baigta | Pabaigos laikas |
| Trukmė (s) | Trukmė sekundėmis |
| Būsena | Būsena |
| Pabaigos priežastis | Pabaigos priežastis |
| Skambučio nuoroda | Įveskite `https://app.thunderphone.com/dashboard/call-history/`, tada įterpkite skambučio ID |

Skambučio nuoroda atidaro skambutį ThunderPhone valdymo skydelyje jūsų
organizacijos nariams kartu su jo nuorašu ir įrašu, todėl lape nereikia
saugoti nė vieno iš jų.

Įvykis taip pat gali perduoti nuorašą kaip dialogo replikų sąrašą ir įrašo
URL – pasirašytą nuorodą, kurios galiojimas baigiasi. Pridėkite juos tik tada,
jei jų reikia lape. Skambučių nuorašuose, suvestinėse ir įrašuose gali būti
asmens ar sveikatos informacijos. Siųskite juos tik į programas, kurias jūsų
organizacijai leidžiama naudoti tokiems duomenims, pagal BAA, kai naudojama
sveikatos informacija, ir saugokite tik reikalingus laukus. Visus laukus
rasite [`telephony.complete` / `web.complete`](/lt/webhooks/call-complete).

<Note>
  Kiekvienas pristatymas yra pasirašytas. Programa prieš paleidžiant Zap
  tikrina `X-ThunderPhone-Signature` HMAC pagal galinio taško paslaptį ir
  sustabdo viską, kas nepasirašyta arba neteisinga. Jei Zapier nepriima
  pristatymo, ThunderPhone bando jį pristatyti pakartotinai iki 24 valandų.
  Žr. [Žiniatinklio kablių apžvalga](/lt/webhooks/overview).
</Note>

## Paleidikliai, veiksmai ir paieška

**Skambutis įvertintas** pateikia skambučio ID, agento ID, agento pavadinimą ir įvertinimo duomenis: įvertinimo ID, balą, skambučio baigtį, suvestinę, vertintojo modelį ir įvertinimo laiką. Įjungus Zap sukuriamas galinis taškas pavadinimu **Zapier: Skambutis įvertintas**. Skambutis gali būti įvertintas daugiau nei vieną kartą, o kiekvienas užbaigtas vertinimo vykdymas suaktyvina paleidiklį. Žr. [`call.graded`](/lt/webhooks/events).

**Rasti skambutį** priima skambučio ID ir pateikia neseniai vykusių skambučių išskleidžiamąjį sąrašą. Grąžinamas skambučio agentas, kryptis, numeriai, pradžios ir pabaigos laikas, būsena, pabaigos priežastis, įvertinimo balas ir skambučio baigtis, transkripcija bei pasirašytas įrašo URL, jei jis pasiekiamas. Nežinomas skambučio ID vietoj klaidos negrąžina jokio rezultato.

**Vykdyti išeinantį skambutį** priima:

| Laukas | Reikšmė |
|---|---|
| Agentas | Išsaugotas agentas. Išskleidžiamajame sąraše pateikiami jūsų agentai. |
| Numeris gavėjui | Paskirties numeris E.164 formatu, pvz., `+14155552671`. |
| Numeris skambučiui | Išskleidžiamajame sąraše pateikiami tik išeinantiems skambučiams įjungti numeriai. |
| Kintamieji | Pasirinktinis JSON reikšmių objektas agento raginimo vietos rezervavimo ženklams. |
| Idempotentiškumo raktas | Pastovus ID iš paleidiklio arba šaltinio įrašo. Privalomas. |

Grąžinamas skambučio ID, būsena ir idempotentinis pakartojimas.

**Pridėti kontaktus prie kampanijos** prideda kontaktus prie juodraštinės kampanijos. Vienam kontaktui užpildykite **Telefono numeris** E.164 formatu ir pasirinktinai **Kontakto kintamieji** – JSON objektą, kurio ypatybės tampa kampanijos kintamaisiais. Paketui užpildykite **Kontaktų JSON** masyvu, kuriame gali būti iki 5 000 objektų. Kiekvienam reikia `phone_number`, o kitos jo ypatybės tampa kintamaisiais. Veiksmas nepavyksta, kai atmetami visi kontaktai, ir nustato **Dalinis sėkmingumas**, kai atmetama tik dalis kontaktų.

**Pradėti kampaniją** pradeda arba tęsia kampaniją, kurioje yra bent vienas kontaktas. Reikalingas **Sutikimas apmokestinti**. Žr. [Išeinančios kampanijos](/lt/guides/outbound-campaigns).

## Prieš Zap vykdant skambučius

Vykdyti išeinantį skambutį ir Pradėti kampaniją skambina tikrais telefono numeriais ir pradeda apmokestinamus skambučius.

- Jei ThunderPhone paprašo jūsų organizacijos patvirtinti, kad jos išeinantys skambučiai atitinka TCPA ir kitus skambinimo įstatymus, administratorius turi užregistruoti šį patvirtinimą valdymo skydelyje, kad Zap galėtų pradėti skambučius.
- Numeris skambučiui turi būti įjungtas išeinantiems skambučiams. Iš savo ryšio operatoriaus perkelti numeriai tampa tinkami juos patvirtinus. ThunderPhone teikiami numeriai iš pradžių skirti tik įeinantiems skambučiams, o valdymo skydelyje galite paprašyti jiems suteikti išeinančių skambučių prieigą. Žr. [Gauti telefono numerį](/lt/guides/get-a-phone-number).
- Vykdyti išeinantį skambutį reikalauja **Idempotentiškumo rakto**. Susiekite pastovų ID iš paleidiklio arba šaltinio įrašo, pvz., ThunderPhone įvykio ID arba CRM įrašo ID. Jei Zapier pakartoja veiksmą, ThunderPhone atpažįsta raktą ir grąžina pradinį skambutį, užuot vykdęs antrą. Venkite laiko žymų, atsitiktinių reikšmių arba vien Zap ID.
- Pradėti kampaniją reikalauja **Sutikimo apmokestinti**, kuriuo patvirtinama, kad Zap gali jūsų paskyroje pradėti apmokestinamus išeinančius skambučius.
- Jūsų organizacija atsako už sutikimą skambinti kiekvienu numeriu ir už taikomų skambinimo įstatymų laikymąsi. Žr. [išeinančių skambučių įstatymai](/lt/guides/outbound-calling-laws).

Idempotentiškumo raktas yra unikalus visoje jūsų organizacijoje ir gali būti ne ilgesnis nei 128 simboliai. Pakartotinai naudojant raktą su kitu agentu, numeriu arba kintamaisiais įvyksta konfliktas, todėl, jei du Zap gali skambinti dėl to paties įrašo, prieš įrašo ID kiekvienam Zap pridėkite atskirą pastovų priešdėlį.
[Išeinantys skambučiai](/lt/guides/place-outbound-calls) aprašo už šio veiksmo esančią API.

## Pavyzdiniai Zap

- **Baigtas skambutis į CRM.** Užregistruokite veiklą kiekvienam užbaigtam skambučiui, nurodydami jo būseną, pabaigos priežastį ir transkriptą.
- **Įvertintas skambutis tolesniems veiksmams.** Filtruokite pagal skambučio rezultatą arba įvertį ir nukreipkite skambutį į tinkamą tolesnių veiksmų darbo eigą.
- **Naujas potencialus klientas į kampaniją.** Pridėkite potencialų klientą prie juodraštinės kampanijos naudodami Add Contacts to Campaign, tada paleiskite Start Campaign, kai kas nors patvirtins sąrašą.

Skambučių transkriptuose, suvestinėse ir įrašuose gali būti asmens arba sveikatos informacijos. Siųskite juos tik į programas, kurias jūsų organizacijai leidžiama naudoti tokiems duomenims, kai naudojama sveikatos informacija – pagal BAA, ir saugokite tik jums reikalingus laukus.

## Trikčių šalinimas

**Veiksmas nepavyksta dėl autorizacijos klaidos.** Iš naujo prijunkite ThunderPhone ryšį Zapier sistemoje ir dar kartą patvirtinkite. Ryšys nustoja veikti, kai jį prijungęs asmuo atšaukia jį ThunderPhone skiltyje **Organizacija → Raktai → Autorizuotos programos**, kai tas asmuo palieka organizaciją arba kai per 30 dienų nepavyksta sėkmingai atnaujinti prieigos rakto. Žr. [Prisijungimas naudojant OAuth](/lt/guides/oauth).

**Nepavyksta įjungti arba išjungti Zap arba veiksmas atmetamas.** Prisijungęs asmuo organizacijoje turi turėti administratoriaus arba savininko vaidmenį. Prisijunkite iš naujo naudodami paskyrą, kuri jį turi. Jau įjungtas trigerio Zap ir toliau gauna skambučių įvykius pasikeitus vaidmeniui arba atšaukus ryšį. Išjunkite jį, kad tai sustabdytumėte.

**Norite atjungti programą.** Prieš atšaukdami ryšį išjunkite savo ThunderPhone Zap, nes išjungus Zap ištrinamas jo galinis taškas ir reikalingas veikiantis ryšys. Jei pirmiausia atšaukėte ryšį, ištrinkite likusį **Zapier: …** galinį tašką naudodami `DELETE /v1/developer/webhook-endpoints/{id}` ir administratoriaus API raktą. Žr. [Webhook galiniai taškai](/lt/webhooks/endpoints).

**Zap turėtų naudoti kitą organizaciją.** Kiekvienas ryšys apima vieną organizaciją. Pirmiausia išjunkite Zap, kad jo webhook galinis taškas būtų ištrintas iš dabartinės organizacijos. Tada Zapier sistemoje prijunkite naują ThunderPhone paskyrą, patvirtindami pasirinkite kitą organizaciją ir kiekviename ThunderPhone veiksme pasirinkite tą ryšį. Agentai, numeriai ir kampanijos skirtingose organizacijose skiriasi, todėl kiekviename veiksme, kuriame jie yra, dar kartą pasirinkite **Agentas**, **Siuntėjo numeris** ir **Kampanija**. Tada vėl įjunkite Zap.

**Trigeris nustojo veikti.** Kiekvienas Zap su ThunderPhone trigeriu turi vieną webhook galinį tašką jūsų organizacijoje, pavadintą **Zapier: Call Completed** arba **Zapier: Call Graded**. Jis sukuriamas įjungus Zap ir ištrinamas jį išjungus. Palikite jį nepakeistą. Jei jis buvo redaguotas arba ištrintas ThunderPhone sistemoje, išjunkite ir vėl įjunkite Zap, kad sukurtumėte naują.

Naudojant administratoriaus API raktą,
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
rodomi naujausi pristatymo bandymai.

<Note>
  Norite, kad agentas skambučio metu naudotų Zapier veiksmus, o ne po jo?
  Prijunkite Zapier MCP galinį tašką skiltyje **Ryšiai → MCP**. Žr.
  [MCP serveriai](/lt/guides/mcp-servers). Norėdami siųsti tuos pačius skambučių įvykius į savo
  serverį, žr. [Webhook galiniai taškai](/lt/webhooks/endpoints).
</Note>