--- title: "Utilizați ThunderPhone cu Zapier" description: "Conectați aplicația ThunderPhone din Zapier la organizația dumneavoastră și creați un Zap care rulează de fiecare dată când se încheie un apel." --- [Zapier](https://zapier.com) conectează aplicații prin fluxuri de lucru automate numite Zaps. Aplicația ThunderPhone din Zapier adaugă: - **Declanșatoare:** **Apel finalizat** se activează când se încheie un apel telefonic, web sau de test. **Apel evaluat** se activează când devine disponibilă evaluarea unui apel finalizat. - **Acțiuni:** **Efectuați apel extern**, **Adăugați contacte la campanie** și **Porniți campania**. - **Căutare:** **Găsiți apelul** caută un apel după ID și îl returnează împreună cu transcrierea sa și un URL semnat pentru înregistrare, atunci când este disponibil. Găsiți aplicația la [ThunderPhone pe Zapier](https://zapier.com/apps/thunderphone/integrations). Pentru o prezentare generală a ambelor modalități de a utiliza Zapier cu ThunderPhone, consultați [pagina de integrare Zapier](https://thunderphone.com/integrations/zapier). ## Conectați organizația Aplicația se conectează prin OAuth. Vă conectați la ThunderPhone și aprobați accesul pentru o organizație, fără ca vreo cheie API să fie copiată în Zapier. În editorul Zap, căutați **ThunderPhone** (afișat cu eticheta Beta) și alegeți un declanșator sau o acțiune. Când Zapier solicită un cont, conectați unul nou. Zapier deschide o fereastră de conectare ThunderPhone. Conectați-vă, verificați permisiunile solicitate, alegeți organizația și selectați **Aprobați**. Aplicația solicită permisiunea de a citi agenții vocali și numerele dvs. de telefon, de a citi și scrie apeluri și campanii, de a gestiona integrări precum puncte finale webhook și de a vedea adresa de e-mail a contului dvs. Zapier denumește conexiunea după organizația pe care ați aprobat-o, astfel încât să puteți diferenția conexiunile atunci când aparțineți mai multor organizații. Conectați-vă cu un cont care are rolul de administrator sau proprietar în acea organizație. Activarea sau dezactivarea unui Zap cu declanșator, precum și fiecare acțiune, necesită acel rol. Un Zap cu declanșator deja activ continuă să primească evenimente de apel după schimbarea rolului sau revocarea conexiunii. Dezactivați-l pentru a le opri. Găsiți apelul funcționează pentru orice membru. Aplicația nu are costuri proprii ThunderPhone. Apelurile pe care le efectuează sau le pornește sunt facturate la tarifele obișnuite ThunderPhone, iar Zapier contorizează sarcinile conform planului dvs. Zapier. ## Creați primul Zap Acest Zap adaugă un rând într-o foaie Google Sheets de fiecare dată când se încheie un apel. Deschideți un agent în builder, faceți clic pe **Vorbește** și încheiați apelul. Apelurile de test din builder declanșează evenimentul Apel finalizat, astfel încât declanșatorul are un apel recent de încărcat. Alegeți **ThunderPhone** ca aplicație de declanșare, setați evenimentul la **Apel finalizat** și selectați conexiunea ThunderPhone. Testați declanșatorul. Zapier încarcă cele mai recente apeluri finalizate ca eșantioane, în același format ca un eveniment în direct. Adăugați o acțiune Google Sheets care creează un rând într-o foaie de calcul. Alegeți o foaie cu un rând de antet, apoi mapați fiecare coloană la un câmp din declanșator (consultați tabelul de mai jos). Publicați și activați Zap-ul. Activarea creează un endpoint webhook în organizația ThunderPhone numit **Zapier: Apel finalizat**. Dezactivarea Zap-ului șterge acel endpoint. Efectuați încă un apel de test din builder. Când se încheie, Zap-ul rulează și apare un rând. Coloane utile: | Coloană | Câmp Apel finalizat | |---|---| | ID apel | ID apel | | Agent | Nume agent | | Direcție | Direcție | | De la | Număr de la | | Către | Număr către | | Început | Început la | | Încheiat | Încheiat la | | Durată (s) | Durată în secunde | | Stare | Stare | | Motivul încheierii | Motivul încheierii | | Link apel | Introduceți `https://app.thunderphone.com/dashboard/call-history/`, apoi inserați ID-ul apelului | Linkul apelului deschide apelul în tabloul de bord ThunderPhone pentru membrii organizației dumneavoastră, împreună cu transcrierea și înregistrarea sa, astfel încât foaia nu trebuie să conțină niciuna dintre acestea. Evenimentul poate include și transcrierea, ca listă de replici, precum și un URL de înregistrare, un link semnat care expiră. Adăugați-le numai dacă foaia are nevoie de ele. Transcrierile, rezumatele și înregistrările apelurilor pot conține informații personale sau medicale. Trimiteți-le numai către aplicații pe care organizația dumneavoastră are voie să le utilizeze pentru aceste date, în baza unui BAA atunci când sunt implicate informații medicale, și păstrați numai câmpurile de care aveți nevoie. Consultați [`telephony.complete` / `web.complete`](/ro/webhooks/call-complete) pentru toate câmpurile. Fiecare livrare este semnată. Aplicația verifică HMAC-ul `X-ThunderPhone-Signature` față de secretul endpointului înainte ca Zap-ul să ruleze și oprește orice livrare nesemnată sau nevalidă. Dacă Zapier nu acceptă o livrare, ThunderPhone o reîncearcă timp de până la 24 de ore. Consultați [Prezentarea generală a webhookurilor](/ro/webhooks/overview). ## Declanșatoare, acțiuni și căutare **Apel evaluat** oferă ID-ul apelului, ID-ul agentului, numele agentului și evaluarea: ID-ul evaluării, scorul, rezultatul apelului, rezumatul, modelul evaluator și data evaluării. Activarea unui Zap creează un endpoint numit **Zapier: Apel evaluat**. Un apel poate fi evaluat de mai multe ori, iar fiecare rulare de evaluare finalizată declanșează declanșatorul. Consultați [`call.graded`](/ro/webhooks/events). **Găsiți apelul** primește un ID de apel, cu o listă derulantă de apeluri recente. Returnează agentul apelului, direcția, numerele, orele de început și de sfârșit, starea, motivul încheierii, scorul evaluării și rezultatul apelului, transcrierea și un URL semnat al înregistrării atunci când este disponibil. Un ID de apel necunoscut nu returnează niciun rezultat în locul unei erori. **Efectuați apel extern** primește: | Câmp | Semnificație | |---|---| | Agent | Un agent salvat. Lista derulantă afișează agenții dumneavoastră. | | Număr destinatar | Destinația în format E.164, cum ar fi `+14155552671`. | | Număr expeditor | Lista derulantă afișează doar numerele activate pentru apeluri externe. | | Variabile | Obiect JSON opțional cu valori pentru substituenții din promptul agentului. | | Cheie de idempotență | Un ID stabil din declanșator sau din înregistrarea sursă. Obligatoriu. | Returnează ID-ul apelului, starea și reluarea idempotentă. **Adăugați contacte la campanie** adaugă contacte la o campanie în schiță. Pentru un singur contact, completați **Număr de telefon** în format E.164 și, opțional, **Variabile de contact**, un obiect JSON ale cărui proprietăți devin variabile ale campaniei. Pentru un lot, completați **JSON contacte** cu o matrice de până la 5.000 de obiecte. Fiecare necesită `phone_number`, iar celelalte proprietăți ale sale devin variabile. Pasul eșuează atunci când fiecare contact este respins și setează **Succes parțial** atunci când sunt acceptate doar unele contacte. **Porniți campania** pornește sau reia o campanie care are cel puțin un contact. Necesită **Consimțământ pentru facturare**. Consultați [Campanii externe](/ro/guides/outbound-campaigns). ## Înainte ca un Zap să efectueze apeluri Efectuați apel extern și Porniți campania apelează numere de telefon reale și inițiază apeluri facturabile. - Dacă ThunderPhone solicită organizației dumneavoastră să confirme că apelurile sale externe respectă TCPA și alte legi privind apelurile, un administrator trebuie să înregistreze această confirmare în tabloul de bord înainte ca un Zap să poată iniția apeluri. - Numărul expeditor trebuie să fie activat pentru apeluri externe. Numerele pe care le aduceți de la propriul operator devin eligibile după verificare. Numerele furnizate de ThunderPhone sunt inițial doar pentru apeluri primite și puteți solicita acces pentru apeluri externe pentru acestea din tabloul de bord. Consultați [Obțineți un număr de telefon](/ro/guides/get-a-phone-number). - Efectuați apel extern necesită o **Cheie de idempotență**. Asociați un ID stabil din declanșator sau din înregistrarea sursă, cum ar fi ID-ul evenimentului ThunderPhone sau ID-ul unei înregistrări CRM. Dacă Zapier reîncearcă pasul, ThunderPhone recunoaște cheia și returnează apelul inițial în loc să efectueze un al doilea apel. Evitați marcajele temporale, valorile aleatorii sau numai ID-ul Zap. - Porniți campania necesită **Consimțământ pentru facturare**, care confirmă că Zap poate iniția apeluri externe facturabile în contul dumneavoastră. - Organizația dumneavoastră este responsabilă pentru obținerea consimțământului de a apela fiecare număr și pentru respectarea legilor aplicabile privind apelurile. Consultați [legile privind apelurile externe](/ro/guides/outbound-calling-laws). O cheie de idempotență este unică în organizația dumneavoastră și poate avea cel mult 128 de caractere. Reutilizarea unei chei cu un agent, număr sau variabile diferite eșuează cu un conflict, astfel încât, dacă două Zap-uri pot apela în legătură cu aceeași înregistrare, atribuiți fiecărui Zap propriul prefix fix înaintea ID-ului înregistrării. [Efectuați apeluri externe](/ro/guides/place-outbound-calls) prezintă API-ul din spatele acestei acțiuni. ## Exemple de Zap-uri - **Apel finalizat către un CRM.** Înregistrați o activitate pentru fiecare apel finalizat, cu starea, motivul încheierii și transcrierea acestuia. - **Apel evaluat pentru urmărire.** Filtrați după rezultatul sau scorul apelului și direcționați apelul către fluxul de lucru de urmărire potrivit. - **Client potențial nou într-o campanie.** Adăugați clientul potențial într-o campanie nepublicată cu Adăugare contacte în campanie, apoi rulați Pornire campanie după ce cineva aprobă lista. Transcrierile, rezumatele și înregistrările apelurilor pot conține informații personale sau medicale. Trimiteți-le numai către aplicațiile pe care organizația dumneavoastră are voie să le utilizeze pentru aceste date, în baza unui BAA atunci când sunt implicate informații medicale, și păstrați numai câmpurile de care aveți nevoie. ## Depanare **Un pas eșuează cu o eroare de autorizare.** Reconectați conexiunea ThunderPhone în Zapier și aprobați din nou. O conexiune nu mai funcționează atunci când persoana care a realizat conectarea o revocă în ThunderPhone, la **Organizație → Chei → Aplicații autorizate**, când acea persoană părăsește organizația sau când trec 30 de zile fără o reîmprospătare reușită a tokenului. Consultați [Conectare cu OAuth](/ro/guides/oauth). **Activarea sau dezactivarea unui Zap eșuează ori o acțiune este refuzată.** Persoana care a realizat conectarea trebuie să aibă rolul de administrator sau proprietar în organizație. Reconectați-vă cu un cont care are acest rol. Un Zap declanșator care este deja activ continuă să primească evenimente de apel după schimbarea rolului sau revocarea conexiunii. Dezactivați-l pentru a le opri. **Doriți să deconectați aplicația.** Dezactivați Zap-urile ThunderPhone înainte de a revoca conexiunea, deoarece dezactivarea unui Zap îi șterge endpointul și necesită o conexiune funcțională. Dacă ați revocat-o mai întâi, ștergeți endpointul rămas **Zapier: …** cu `DELETE /v1/developer/webhook-endpoints/{id}` folosind o cheie API de administrator. Consultați [Endpointuri webhook](/ro/webhooks/endpoints). **Zap-ul trebuie să utilizeze o altă organizație.** Fiecare conexiune acoperă o singură organizație. Dezactivați mai întâi Zap-ul, astfel încât endpointul său webhook să fie șters din organizația curentă. Apoi conectați un cont ThunderPhone nou în Zapier, alegeți cealaltă organizație când aprobați și selectați conexiunea respectivă la fiecare pas ThunderPhone. Agenții, numerele și campaniile diferă între organizații, așadar selectați din nou **Agent**, **Număr sursă** și **Campanie** la fiecare pas care le conține. Apoi reactivați Zap-ul. **Declanșatorul nu mai pornește.** Fiecare Zap cu un declanșator ThunderPhone deține un endpoint webhook în organizația dumneavoastră, denumit **Zapier: Apel finalizat** sau **Zapier: Apel evaluat**. Acesta este creat când Zap-ul este activat și șters când este dezactivat. Lăsați-l neschimbat. Dacă a fost modificat sau șters în ThunderPhone, dezactivați și reactivați Zap-ul pentru a crea unul nou. Cu o cheie API de administrator, [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) afișează încercările recente de livrare. Doriți ca agentul să utilizeze acțiuni Zapier în timpul unui apel, în loc de după acesta? Conectați un endpoint MCP Zapier la **Conexiuni → MCP**. Consultați [servere MCP](/ro/guides/mcp-servers). Pentru a trimite aceleași evenimente de apel către propriul server, consultați [Endpointuri webhook](/ro/webhooks/endpoints).