---
title: "Tumia ThunderPhone na Zapier"
description: "Unganisha programu ya ThunderPhone kwenye Zapier na shirika lako, kisha unda Zap inayotekelezwa kila simu inapomalizika."
---

[Zapier](https://zapier.com) huunganisha programu kwa mtiririko wa kazi wa kiotomatiki unaoitwa
Zaps. Programu ya ThunderPhone kwenye Zapier inaongeza:

- **Vichochezi:** **Simu Imekamilika** huanzishwa simu ya simu, wavuti au majaribio inapoisha.
  **Simu Imepimwa** huanzishwa daraja la simu iliyokamilika linapopatikana.
- **Vitendo:** **Piga Simu ya Kutoka**, **Ongeza Anwani kwenye Kampeni**, na
  **Anzisha Kampeni**.
- **Utafutaji:** **Tafuta Simu** hutafuta simu kwa kitambulisho na kuirejesha pamoja na
  nakala yake na URL ya rekodi iliyosainiwa inapopatikana.

Ipate kwenye [ThunderPhone kwenye Zapier](https://zapier.com/apps/thunderphone/integrations).
Kwa muhtasari wa njia zote mbili za kutumia Zapier na ThunderPhone, angalia
[ukurasa wa ujumuishaji wa Zapier](https://thunderphone.com/integrations/zapier).

## Unganisha shirika lako

Programu huunganishwa kupitia OAuth. Unaingia kwenye ThunderPhone na kuidhinisha
ufikiaji wa shirika moja, na hakuna ufunguo wa API unaonakiliwa kwenye Zapier.

<Steps>
  <Step title="Ongeza hatua ya ThunderPhone">
    Kwenye kihariri cha Zap, tafuta **ThunderPhone** (inayoonyeshwa kwa lebo ya Beta)
    na uchague kichochezi au kitendo. Zapier inapouliza akaunti, unganisha akaunti mpya. Zapier hufungua
    dirisha la kuingia kwenye ThunderPhone.
  </Step>
  <Step title="Ingia na uchague shirika">
    Ingia, hakiki ruhusa zilizoombwa, chagua shirika, na
    uchague **Idhinisha**. Programu huomba kusoma maejenti na nambari zako za simu,
    kusoma na kuandika simu na kampeni, kusimamia miunganisho kama vile vituo vya webhook,
    na kuona barua pepe ya akaunti yako.
  </Step>
  <Step title="Kagua jina la muunganisho">
    Zapier hutaja muunganisho kwa jina la shirika uliloidhinisha, ili
    uweze kutofautisha miunganisho unapokuwa mwanachama wa zaidi ya shirika moja.
  </Step>
</Steps>

Unganisha kwa akaunti yenye jukumu la msimamizi au mmiliki katika
shirika hilo. Kuwasha au kuzima Zap ya kichochezi, na kila kitendo, kunahitaji
jukumu hilo. Zap ya kichochezi ambayo tayari imewashwa huendelea kupokea matukio ya simu baada ya
jukumu kubadilishwa au muunganisho kubatilishwa. Izime ili kuyakomesha. Tafuta
Simu hufanya kazi kwa mwanachama yeyote.

Programu haina gharama yake ya ThunderPhone. Simu inazopiga au kuanzisha
hutozwa kwa viwango vyako vya kawaida vya ThunderPhone, na Zapier huhesabu kazi kwenye
mpango wako wa Zapier.

## Unda Zap ya kwanza

Zap hii huongeza mstari kwenye Google Sheet kila simu inapomalizika.

<Steps>
  <Step title="Piga simu ya kutumia kama data ya mfano">
    Fungua ejenti kwenye builder, bofya **Ongea**, kisha maliza simu. Simu za
    majaribio za builder huanzisha Simu Imekamilika, hivyo hii huipa kichochezi
    simu ya hivi karibuni ya kupakia.
  </Step>
  <Step title="Ongeza kichochezi">
    Chagua **ThunderPhone** kama programu ya kichochezi, weka tukio kuwa **Simu
    Imekamilika**, kisha chagua muunganisho wako wa ThunderPhone. Jaribu
    kichochezi. Zapier hupakia simu zako zilizokamilika hivi karibuni kama
    mifano, zikiwa na muundo sawa na tukio la moja kwa moja.
  </Step>
  <Step title="Ongeza Google Sheets">
    Ongeza kitendo cha Google Sheets kinachounda mstari wa lahajedwali. Chagua
    laha yenye mstari wa vichwa, kisha oanisha kila safu na sehemu kutoka kwenye
    kichochezi (tazama jedwali hapa chini).
  </Step>
  <Step title="Chapisha Zap">
    Chapisha na uwashe Zap. Kuiwasha huunda anwani ya webhook katika shirika
    lako la ThunderPhone inayoitwa **Zapier: Simu Imekamilika**. Kuzima Zap
    hufuta anwani hiyo.
  </Step>
  <Step title="Ijaribu">
    Piga simu nyingine ya majaribio ya builder. Inapomalizika, Zap huendeshwa
    na mstari huonekana.
  </Step>
</Steps>

Safu muhimu:

| Safu | Sehemu ya Simu Imekamilika |
|---|---|
| Kitambulisho cha Simu | Kitambulisho cha Simu |
| Ejenti | Jina la Ejenti |
| Mwelekeo | Mwelekeo |
| Kutoka | Namba ya Kutoka |
| Kwenda | Namba ya Kwenda |
| Ilianza | Ilianza Saa |
| Iliisha | Iliisha Saa |
| Muda (s) | Muda kwa Sekunde |
| Hali | Hali |
| Sababu ya kumalizika | Sababu ya Kumalizika |
| Kiungo cha simu | Andika `https://app.thunderphone.com/dashboard/call-history/`, kisha ingiza Kitambulisho cha Simu |

Kiungo cha simu hufungua simu kwenye dashibodi ya ThunderPhone kwa wanachama
wa shirika lako, pamoja na nakala yake na rekodi, hivyo laha haihitaji
kuhifadhi mojawapo.

Tukio linaweza pia kubeba nakala, kama orodha ya zamu, na URL ya Rekodi,
kiungo kilichosainiwa kinachoisha muda wake. Ziongeze tu ikiwa laha
inazihitaji. Nakala za simu, muhtasari na rekodi zinaweza kuwa na taarifa
za binafsi au za afya. Zitumie tu kwa programu ambazo shirika lako
linaruhusiwa kutumia kwa data hiyo, chini ya BAA pale taarifa za afya
zinapohusika, na hifadhi sehemu unazohitaji pekee. Tazama
[`telephony.complete` / `web.complete`](/sw/webhooks/call-complete) kwa kila
sehemu.

<Note>
  Kila utumaji umesainiwa. Programu hukagua HMAC ya
  `X-ThunderPhone-Signature` dhidi ya siri ya anwani kabla ya Zap kuendeshwa
  na husimamisha chochote kisichosainiwa au batili. Ikiwa Zapier haikubali
  utumaji, ThunderPhone hujaribu tena kwa hadi saa 24. Tazama [Muhtasari wa Webhooks](/sw/webhooks/overview).
</Note>

## Vichochezi, vitendo na utafutaji

**Simu Iliyotathminiwa** hutoa Kitambulisho cha Simu, Kitambulisho cha Ejenti, Jina la Ejenti, na tathmini: Kitambulisho cha Tathmini, Alama, Matokeo ya Simu, Muhtasari, Modeli ya Mtathmini, na Muda wa Kutathmini. Kuwasha Zap huunda endpoint inayoitwa **Zapier: Simu Iliyotathminiwa**. Simu inaweza kutathminiwa zaidi ya mara moja, na kila utekelezaji wa tathmini unaokamilika huwasha kichochezi. Tazama
[`call.graded`](/sw/webhooks/events).

**Tafuta Simu** hupokea Kitambulisho cha Simu, pamoja na orodha kunjuzi ya simu za karibuni. Hurejesha ejenti wa simu, mwelekeo, nambari, muda wa kuanza na kuisha, hali, sababu ya kuisha, alama ya tathmini na matokeo ya simu, nakala ya mazungumzo, na URL ya rekodi iliyotiwa saini inapopatikana. Kitambulisho cha Simu kisichojulikana hakirejeshi matokeo badala ya hitilafu.

**Piga Simu ya Kutoka** hupokea:

| Sehemu | Maana |
|---|---|
| Ejenti | Ejenti iliyohifadhiwa. Orodha kunjuzi huonyesha ejenti zako. |
| Nambari ya Kwenda | Lengwa katika muundo wa E.164, kama vile `+14155552671`. |
| Nambari ya Kutoka | Orodha kunjuzi huonyesha nambari zilizowezeshwa kwa simu za kutoka pekee. |
| Vigeu | Kitu cha JSON cha hiari chenye thamani za nafasi-jaza katika prompt ya ejenti. |
| Ufunguo wa Idempotensi | Kitambulisho thabiti kutoka kwenye kichochezi au rekodi chanzo. Kinahitajika. |

Hurejesha Kitambulisho cha Simu, Hali, na Uchezaji Upya wa Idempotensi.

**Ongeza Anwani kwenye Kampeni** huongeza anwani kwenye kampeni ya rasimu. Kwa anwani moja, jaza **Nambari ya Simu** katika muundo wa E.164 na, kwa hiari, **Vigeu vya Anwani**, kitu cha JSON ambacho sifa zake huwa vigeu vya kampeni. Kwa kundi, jaza **JSON ya Anwani** kwa mkusanyiko wa hadi vitu 5,000. Kila kimoja kinahitaji `phone_number`, na sifa zake nyingine huwa vigeu. Hatua hushindwa wakati kila anwani inakataliwa, na huweka **Mafanikio ya Sehemu** wakati baadhi pekee ndizo zinakubaliwa.

**Anzisha Kampeni** huanzisha au huendeleza kampeni yenye angalau anwani moja. Inahitaji **Idhini ya Kutozwa Malipo**. Tazama
[Kampeni za kutoka](/sw/guides/outbound-campaigns).

## Kabla ya Zap kupiga simu

Piga Simu ya Kutoka na Anzisha Kampeni hupiga nambari halisi za simu na kuanzisha simu zinazotozwa malipo.

- Ikiwa ThunderPhone itaomba shirika lako kuthibitisha kuwa simu zake za kutoka zinatii TCPA na sheria nyingine za kupiga simu, msimamizi lazima arekodi uthibitisho huo kwenye dashibodi kabla Zap haijaanzisha simu.
- Nambari ya Kutoka lazima iwe imewezeshwa kwa simu za kutoka. Nambari unazoleta kutoka kwa mtoa huduma wako mwenyewe zinahitimu baada ya kuthibitishwa. Nambari zinazotolewa na ThunderPhone huanza zikiwa za simu zinazoingia pekee, na unaweza kuomba ufikiaji wa simu za kutoka kwa nambari hizo kwenye dashibodi. Tazama [Pata nambari ya simu](/sw/guides/get-a-phone-number).
- Piga Simu ya Kutoka inahitaji **Ufunguo wa Idempotensi**. Weka ramani ya kitambulisho thabiti kutoka kwenye kichochezi au rekodi chanzo, kama vile kitambulisho cha tukio la ThunderPhone au kitambulisho cha rekodi ya CRM. Ikiwa Zapier itajaribu tena hatua hiyo, ThunderPhone hutambua ufunguo huo na kurejesha simu ya awali badala ya kupiga nyingine. Epuka mihuri ya muda, thamani za nasibu, au kitambulisho cha Zap pekee.
- Anzisha Kampeni inahitaji **Idhini ya Kutozwa Malipo**, ambayo huthibitisha kwamba Zap inaweza kuanzisha simu za kutoka zinazotozwa malipo kwenye akaunti yako.
- Shirika lako lina wajibu wa kuwa na idhini ya kupiga kila nambari na kufuata sheria za kupiga simu zinazotumika. Tazama
[sheria za simu za kutoka](/sw/guides/outbound-calling-laws).

Ufunguo wa idempotensi ni wa kipekee katika shirika lako na unaweza kuwa na upeo wa herufi 128. Kutumia tena ufunguo wenye ejenti, nambari au vigeu tofauti hushindwa kwa mgongano, kwa hivyo ikiwa Zap mbili zinaweza kupiga simu kuhusu rekodi ileile, ipe kila Zap kiambishi awali chake thabiti kabla ya kitambulisho cha rekodi.
[Piga simu za kutoka](/sw/guides/place-outbound-calls) inaeleza API inayotumika na kitendo hiki.

## Zaps za Mfano

- **Simu Iliyokamilika kwenda CRM.** Rekodi shughuli kwa kila simu iliyokamilika pamoja na hali yake, sababu ya kumalizika na transkripti.
- **Simu Iliyotathminiwa kwa ufuatiliaji.** Chuja kwa matokeo au alama ya simu, kisha elekeza simu kwenye mtiririko sahihi wa kazi wa ufuatiliaji.
- **Lead mpya kwenda kwenye kampeni.** Ongeza lead kwenye kampeni ya rasimu ukitumia Ongeza Anwani kwenye Kampeni, kisha endesha Anzisha Kampeni baada ya mtu kuidhinisha orodha.

Transkripti za simu, muhtasari na rekodi zinaweza kuwa na taarifa za kibinafsi au za afya. Zitume tu kwenye programu ambazo shirika lako linaruhusiwa kutumia kwa data hiyo, kwa mujibu wa BAA inapohusika taarifa za afya, na uhifadhi sehemu unazohitaji pekee.

## Utatuzi wa matatizo

**Hatua imeshindwa kwa hitilafu ya uidhinishaji.** Unganisha upya muunganisho wa ThunderPhone katika Zapier na uidhinishe tena. Muunganisho huacha kufanya kazi wakati mtu aliyeuunganisha anapoubatilisha katika ThunderPhone chini ya **Shirika → Funguo → Programu zilizoidhinishwa**, mtu huyo anapoondoka kwenye shirika, au unapofika siku 30 bila ufanyaji upya wa tokeni uliofaulu. Tazama
[Unganisha kwa OAuth](/sw/guides/oauth).

**Kuwasha au kuzima Zap kunashindwa, au kitendo kinakataliwa.** Mtu aliyeunganisha anahitaji jukumu la msimamizi au mmiliki katika shirika. Unganisha upya kwa akaunti yenye jukumu hilo. Zap ya kichocheo ambayo tayari imewashwa huendelea kupokea matukio ya simu baada ya jukumu kubadilishwa au muunganisho kubatilishwa. Izime ili kuyasimamisha.

**Unataka kutenganisha programu.** Zima Zaps zako za ThunderPhone kabla ya kubatilisha muunganisho, kwa kuwa kuzima Zap hufuta kituo chake cha mwisho na kunahitaji muunganisho unaofanya kazi. Ikiwa ulibatilisha kwanza, futa kituo cha mwisho kilichosalia cha **Zapier: …** kwa `DELETE /v1/developer/webhook-endpoints/{id}` ukitumia ufunguo wa API wa msimamizi. Tazama [Vituo vya mwisho vya webhook](/sw/webhooks/endpoints).

**Zap inapaswa kutumia shirika tofauti.** Kila muunganisho unahusu shirika moja. Zima Zap kwanza, ili kituo chake cha mwisho cha webhook kifutwe kutoka kwenye shirika la sasa. Kisha unganisha akaunti mpya ya ThunderPhone katika Zapier, chagua shirika lingine unapoidhinisha, na uchague muunganisho huo katika kila hatua ya ThunderPhone. Ejenti, nambari na kampeni hutofautiana kati ya mashirika, hivyo chagua **Ejenti**, **Nambari ya Kutuma** na **Kampeni** tena katika kila hatua inayovitumia. Kisha washa Zap tena.

**Kichocheo kimeacha kufanya kazi.** Kila Zap yenye kichocheo cha ThunderPhone ina kituo kimoja cha mwisho cha webhook katika shirika lako, kinachoitwa **Zapier: Simu Iliyokamilika** au **Zapier: Simu Iliyotathminiwa**. Huundwa Zap inapowashwa na hufutwa inapozimwa. Kihifadhi jinsi kilivyo. Ikiwa kilihaririwa au kufutwa katika ThunderPhone, zima Zap na uiwashe tena ili kuunda kipya.
Kwa ufunguo wa API wa msimamizi,
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
huonyesha majaribio ya hivi karibuni ya utumaji.

<Note>
  Je, unataka ejenti itumie vitendo vya Zapier wakati wa simu badala ya baada yake?
  Unganisha kituo cha mwisho cha Zapier MCP chini ya **Miunganisho → MCP**. Tazama
  [Seva za MCP](/sw/guides/mcp-servers). Ili kutuma matukio yale yale ya simu kwenye
  seva yako mwenyewe, tazama [Vituo vya mwisho vya webhook](/sw/webhooks/endpoints).
</Note>
