Brug ThunderPhone med Zapier

Forbind ThunderPhone-appen på Zapier med din organisation, og opbyg en Zap, der kører, hver gang et opkald afsluttes.

Zapier forbinder apps med automatiserede arbejdsgange kaldet Zaps. ThunderPhone-appen på Zapier tilføjer:

• Udløsere: Opkald afsluttet udløses, når et telefon-, web- eller testopkald afsluttes. Opkald vurderet udløses, når vurderingen af et afsluttet opkald er tilgængelig.
• Handlinger: Foretag udgående opkald, Føj kontakter til kampagne og Start kampagne.
• Søgning: Find opkald slår et opkald op efter ID og returnerer det med dets transskription og en signeret URL til optagelsen, når en sådan er tilgængelig.

Find den på ThunderPhone på Zapier. Du kan få et overblik over begge måder at bruge Zapier med ThunderPhone på på integrationssiden for Zapier.

Forbind din organisation#

Appen forbindes via OAuth. Du logger ind på ThunderPhone og godkender adgang for én organisation, og ingen API-nøgle kopieres til Zapier.

1. Tilføj et ThunderPhone-trin

   I Zap-editoren skal du søge efter ThunderPhone (vist med mærkatet Beta) og vælge en udløser eller handling. Når Zapier beder om en konto, skal du oprette forbindelse til en ny. Zapier åbner et ThunderPhone-logindvindue.

2. Log ind, og vælg organisationen

   Log ind, gennemgå de anmodede tilladelser, vælg organisationen, og vælg Godkend. Appen anmoder om at læse dine agenter og telefonnumre, læse og skrive opkald og kampagner, administrere integrationer såsom webhook- slutpunkter og se din kontos e-mailadresse.

3. Kontrollér forbindelsens navn

   Zapier navngiver forbindelsen efter den organisation, du godkendte, så du kan skelne mellem forbindelser, når du tilhører mere end én.

Brug en konto, der har administrator- eller ejersrollen i den pågældende organisation. Aktivering eller deaktivering af en udløser-Zap og alle handlinger kræver denne rolle. En udløser-Zap, der allerede er aktiv, bliver ved med at modtage opkaldshændelser, efter rollen ændres, eller forbindelsen tilbagekaldes. Deaktiver den for at stoppe dem. Find opkald fungerer for alle medlemmer.

Appen har ingen egne ThunderPhone-omkostninger. Opkald, den foretager eller starter, faktureres efter dine normale ThunderPhone-priser, og Zapier tæller opgaver på dit Zapier-abonnement.

Opret din første Zap#

Denne Zap tilføjer en række i et Google-ark, hver gang et opkald afsluttes.

1. Foretag et opkald, der kan bruges som eksempeldata

   Åbn en agent i byggeren, klik på Tal, og afslut opkaldet. Testopkald i byggeren udløser Opkald fuldført, så dette giver udløseren et nyligt opkald at indlæse.

2. Tilføj udløseren

   Vælg ThunderPhone som udløserapp, indstil hændelsen til Opkald fuldført, og vælg din ThunderPhone-forbindelse. Test udløseren. Zapier indlæser dine senest fuldførte opkald som eksempler i samme format som en aktiv hændelse.

3. Tilføj Google Sheets

   Tilføj en Google Sheets-handling, der opretter en regnearksrække. Vælg et ark med en overskriftsrække, og tilknyt derefter hver kolonne til et felt fra udløseren (se tabellen nedenfor).

4. Udgiv Zap'en

   Udgiv og slå Zap'en til. Når du slår den til, oprettes der et webhook-slutpunkt i din ThunderPhone-organisation med navnet Zapier: Opkald fuldført. Når du slår Zap'en fra, slettes dette slutpunkt.

5. Test den

   Foretag endnu et testopkald i byggeren. Når det afsluttes, kører Zap'en, og der vises en række.

Nyttige kolonner:

Opkaldslinket åbner opkaldet i ThunderPhone-dashboardet for medlemmer af din organisation sammen med dets transskription og optagelse, så arket ikke behøver at indeholde nogen af delene.

Hændelsen kan også indeholde transskriptionen som en liste over replikskift samt en optagelses-URL, et signeret link, der udløber. Tilføj dem kun, hvis arket har brug for dem. Opkaldstransskriptioner, resuméer og optagelser kan indeholde person- eller helbredsoplysninger. Send dem kun til apps, som din organisation har tilladelse til at bruge til disse data, i henhold til en BAA, når der er tale om helbredsoplysninger, og behold kun de felter, du har brug for. Se telephony.complete / web.complete for alle felter.

Udløsere, handlinger og søgning#

Opkald bedømt giver opkalds-id, agent-id, agentnavn og bedømmelsen: Bedømmelses-id, score, opkaldsresultat, opsummering, bedømmermodel og bedømt kl. Når du aktiverer en Zap, oprettes et endpoint med navnet Zapier: Opkald bedømt. Et opkald kan bedømmes mere end én gang, og hver afsluttet bedømmelseskørsel udløser udløseren. Se call.graded.

Find opkald tager et opkalds-id med en rullemenu over seneste opkald. Den returnerer opkaldets agent, retning, numre, start- og sluttidspunkter, status, afslutningsårsag, bedømmelsesscore og opkaldsresultat, transskriptionen og en signeret optagelses-URL, når en er tilgængelig. Et ukendt opkalds-id returnerer intet resultat i stedet for en fejl.

Foretag udgående opkald tager:

Den returnerer opkalds-id, status og idempotent gentagelse.

Føj kontakter til kampagne føjer kontakter til en kladdekampagne. For én kontakt skal du udfylde Telefonnummer i E.164-format og eventuelt Kontaktvariabler, et JSON-objekt, hvis egenskaber bliver kampagnevariabler. For en batch skal du udfylde Kontakter JSON med et array på op til 5.000 objekter. Hvert objekt skal have phone_number, og dets øvrige egenskaber bliver variabler. Trinnet fejler, når alle kontakter afvises, og angiver Delvis succes, når kun nogle af dem afvises.

Start kampagne starter eller genoptager en kampagne, der har mindst én kontakt. Den kræver Samtykke til opkrævning. Se Udgående kampagner.

Før en Zap foretager opkald#

Foretag udgående opkald og Start kampagne ringer til rigtige telefonnumre og starter opkald, der faktureres.

• Hvis ThunderPhone beder din organisation om at bekræfte, at dens udgående opkald overholder TCPA og andre opkaldslove, skal en administrator registrere den bekræftelse i dashboardet, før en Zap kan starte opkald.
• Fra-nummeret skal være aktiveret til udgående opkald. Numre, du medbringer fra din egen operatør, kvalificerer sig, når de er verificeret. Numre leveret af ThunderPhone starter kun med indgående opkald, og du kan anmode om udgående adgang til dem i dashboardet. Se Få et telefonnummer.
• Foretag udgående opkald kræver en Idempotensnøgle. Knyt et stabilt id fra udløseren eller kildeposten, f.eks. ThunderPhone-hændelses-id'et eller et CRM-post-id. Hvis Zapier prøver trinnet igen, genkender ThunderPhone nøglen og returnerer det oprindelige opkald i stedet for at foretage et andet. Undgå tidsstempler, tilfældige værdier eller Zap-id'et alene.
• Start kampagne kræver Samtykke til opkrævning, som bekræfter, at Zap'en må starte fakturerbare udgående opkald på din konto.
• Din organisation er ansvarlig for at have samtykke til at ringe til hvert nummer og for at overholde de gældende opkaldslove. Se love for udgående opkald.

En idempotensnøgle er unik på tværs af din organisation og kan højst være 128 tegn. Genbrug af en nøgle med en anden agent, et andet nummer eller andre variabler fejler med en konflikt, så hvis to Zaps kan ringe vedrørende den samme post, skal hver Zap have sit eget faste præfiks før post-id'et. Foretag udgående opkald dækker API'et bag denne handling.

Eksempel-Zaps#

• Gennemført opkald til et CRM. Registrer en aktivitet for hvert afsluttet opkald med dets status, afslutningsårsag og transskription.
• Vurderet opkald til opfølgning. Filtrer efter opkaldsresultatet eller scoren, og send opkaldet til det rette opfølgningsworkflow.
• Nyt lead til en kampagne. Føj leadet til en kladdekampagne med Tilføj kontakter til kampagne, og kør derefter Start kampagne, når nogen har godkendt listen.

Opkaldstransskriptioner, opsummeringer og optagelser kan indeholde person- eller helbredsoplysninger. Send dem kun til apps, som din organisation har tilladelse til at bruge til disse data, under en BAA, når der er tale om helbredsoplysninger, og gem kun de felter, du har brug for.

Fejlfinding#

Et trin fejler med en autorisationsfejl. Genopret ThunderPhone-forbindelsen i Zapier, og godkend den igen. En forbindelse holder op med at virke, når personen, der oprettede forbindelsen, tilbagekalder den i ThunderPhone under Organisation → Nøgler → Autoriserede apps, når personen forlader organisationen, eller hvis der går 30 dage uden en vellykket tokenfornyelse. Se Forbind med OAuth.

Det fejler at slå en Zap til eller fra, eller en handling afvises. Personen, der oprettede forbindelsen, skal have rollen som administrator eller ejer i organisationen. Genopret forbindelsen med en konto, der har rollen. En trigger-Zap, der allerede er slået til, fortsætter med at modtage opkaldshændelser, efter rollen ændres, eller forbindelsen tilbagekaldes. Slå den fra for at stoppe dem.

Du vil afbryde appen. Slå dine ThunderPhone-Zaps fra, før du tilbagekalder forbindelsen, da det at slå en Zap fra sletter dens endpoint og kræver en fungerende forbindelse. Hvis du tilbagekaldte først, skal du slette det resterende Zapier: …-endpoint med DELETE /v1/developer/webhook-endpoints/{id} ved hjælp af en administrator-API-nøgle. Se Webhook-endpoints.

Zappen skal bruge en anden organisation. Hver forbindelse dækker én organisation. Slå først Zappen fra, så dens webhook-endpoint slettes fra den aktuelle organisation. Tilslut derefter en ny ThunderPhone-konto i Zapier, vælg den anden organisation, når du godkender, og vælg den forbindelse på hvert ThunderPhone-trin. Agenter, numre og kampagner er forskellige mellem organisationer, så vælg Agent, Fra-nummer og Kampagne igen på hvert trin, der har dem. Slå derefter Zappen til igen.

Triggeren holdt op med at udløses. Hver Zap med en ThunderPhone-trigger har sit eget webhook-endpoint i din organisation med navnet Zapier: Opkald gennemført eller Zapier: Opkald vurderet. Det oprettes, når Zappen slås til, og slettes, når den slås fra. Lad det være, som det er. Hvis det blev redigeret eller slettet i ThunderPhone, skal du slå Zappen fra og til igen for at oprette et nyt. Med en administrator-API-nøgle viser GET /v1/developer/webhook-deliveries seneste leveringsforsøg.