Gebruik ThunderPhone met Zapier

Koppel de ThunderPhone-app op Zapier aan je organisatie en bouw een Zap die wordt uitgevoerd telkens wanneer een oproep eindigt.

Zapier koppelt apps met geautomatiseerde workflows die Zaps worden genoemd. De ThunderPhone-app op Zapier voegt het volgende toe:

• Triggers: Oproep voltooid wordt geactiveerd wanneer een telefoon-, web- of testoproep eindigt. Oproep beoordeeld wordt geactiveerd wanneer de beoordeling van een voltooide oproep beschikbaar is.
• Acties: Uitgaande oproep plaatsen, Contactpersonen aan campagne toevoegen en Campagne starten.
• Zoeken: Oproep zoeken zoekt een oproep op ID op en retourneert deze met het transcript en een ondertekende opname-URL wanneer die beschikbaar is.

Je vindt de app bij ThunderPhone op Zapier. Voor een overzicht van beide manieren om Zapier met ThunderPhone te gebruiken, zie de Zapier-integratiepagina.

Je organisatie koppelen#

De app maakt verbinding via OAuth. Je logt in bij ThunderPhone en keurt toegang voor één organisatie goed. Er wordt geen API-sleutel naar Zapier gekopieerd.

1. Een ThunderPhone-stap toevoegen

   Zoek in de Zap-editor naar ThunderPhone (weergegeven met een Beta-label) en kies een trigger of actie. Wanneer Zapier om een account vraagt, koppel je een nieuw account. Zapier opent een ThunderPhone-inlogvenster.

2. Inloggen en de organisatie kiezen

   Log in, controleer de gevraagde machtigingen, kies de organisatie en selecteer Goedkeuren. De app vraagt om je spraakagenten en telefoonnummers te lezen, oproepen en campagnes te lezen en te schrijven, integraties zoals webhook- eindpunten te beheren en het e-mailadres van je account te bekijken.

3. De verbindingsnaam controleren

   Zapier geeft de verbinding de naam van de organisatie die je hebt goedgekeurd, zodat je verbindingen kunt onderscheiden wanneer je bij meer dan één organisatie hoort.

Koppel met een account dat de beheerders- of eigenaarsrol in die organisatie heeft. Het in- of uitschakelen van een trigger-Zap, en elke actie, vereist die rol. Een trigger-Zap die al is ingeschakeld, blijft oproepgebeurtenissen ontvangen nadat de rol verandert of de verbinding wordt ingetrokken. Schakel deze uit om dit te stoppen. Oproep zoeken werkt voor elk lid.

De app heeft geen eigen ThunderPhone-kosten. Oproepen die de app plaatst of start, worden gefactureerd tegen je normale ThunderPhone-tarieven, en Zapier telt taken binnen je Zapier-pakket.

Bouw je eerste Zap#

Deze Zap voegt telkens wanneer een oproep eindigt een rij toe aan een Google Sheet.

1. Maak een oproep om als voorbeeldgegevens te gebruiken

   Open een agent in de builder, klik op Praten en beëindig de oproep. Testoproepen in de builder activeren Oproep voltooid, dus dit geeft de trigger een recente oproep om te laden.

2. Voeg de trigger toe

   Kies ThunderPhone als trigger-app, stel de gebeurtenis in op Oproep voltooid en selecteer je ThunderPhone-verbinding. Test de trigger. Zapier laadt je meest recente voltooide oproepen als voorbeelden, in dezelfde vorm als een live gebeurtenis.

3. Voeg Google Sheets toe

   Voeg een Google Sheets-actie toe die een rij in een spreadsheet maakt. Kies een werkblad met een koprij en koppel vervolgens elke kolom aan een veld van de trigger (zie de onderstaande tabel).

4. Publiceer de Zap

   Publiceer de Zap en schakel deze in. Door deze in te schakelen, wordt in je ThunderPhone-organisatie een webhook-eindpunt met de naam Zapier: Oproep voltooid gemaakt. Door de Zap uit te schakelen, wordt dat eindpunt verwijderd.

5. Test de Zap

   Maak nog een testoproep in de builder. Wanneer deze eindigt, wordt de Zap uitgevoerd en verschijnt er een rij.

Handige kolommen:

De oproeplink opent de oproep in het ThunderPhone-dashboard voor leden van je organisatie, inclusief transcript en opname, zodat het werkblad geen van beide hoeft te bevatten.

De gebeurtenis kan ook het transcript bevatten, als een lijst met gespreksbeurten, en een opname-URL, een ondertekende link die verloopt. Voeg deze alleen toe als het werkblad ze nodig heeft. Oproeptranscripten, samenvattingen en opnamen kunnen persoons- of gezondheidsinformatie bevatten. Verstuur ze alleen naar apps die je organisatie voor die gegevens mag gebruiken, onder een BAA wanneer er gezondheidsinformatie bij betrokken is, en bewaar alleen de velden die je nodig hebt. Zie telephony.complete / web.complete voor elk veld.

Triggers, acties en zoeken#

Oproep beoordeeld geeft de oproep-ID, agent-ID, agentnaam en de beoordeling: beoordelings-ID, score, oproepuitkomst, samenvatting, beoordelingsmodel en beoordeeld op. Door een Zap in te schakelen, wordt een endpoint met de naam Zapier: Oproep beoordeeld gemaakt. Een oproep kan meer dan één keer worden beoordeeld en elke voltooide beoordelingsuitvoering activeert de trigger. Zie call.graded.

Oproep zoeken gebruikt een oproep-ID, met een vervolgkeuzelijst met recente oproepen. De actie retourneert de agent, richting, nummers, begin- en eindtijden, status, eindreden, beoordelingsscore en oproepuitkomst, het transcript en een ondertekende opname-URL wanneer die beschikbaar is. Een onbekende oproep-ID retourneert geen resultaat in plaats van een fout.

Uitgaande oproep plaatsen gebruikt:

De actie retourneert de oproep-ID, status en idempotente herhaling.

Contacten aan campagne toevoegen voegt contacten toe aan een campagneconcept. Vul voor één contact Telefoonnummer in E.164-indeling in en optioneel Contactvariabelen, een JSON-object waarvan de eigenschappen campagnevariabelen worden. Vul voor een batch Contacten-JSON in met een array van maximaal 5.000 objecten. Elk object heeft phone_number nodig en de andere eigenschappen worden variabelen. De stap mislukt wanneer elk contact wordt afgewezen en stelt Gedeeltelijk geslaagd in wanneer slechts enkele contacten worden geaccepteerd.

Campagne starten start of hervat een campagne met ten minste één contact. Hiervoor is Toestemming voor kosten vereist. Zie Uitgaande campagnes.

Voordat een Zap oproepen plaatst#

Uitgaande oproep plaatsen en Campagne starten bellen echte telefoonnummers en starten factureerbare oproepen.

• Als ThunderPhone je organisatie vraagt te bevestigen dat de uitgaande oproepen voldoen aan de TCPA en andere belwetgeving, moet een beheerder die bevestiging in het dashboard vastleggen voordat een Zap oproepen kan starten.
• Het Van-nummer moet zijn ingeschakeld voor uitgaande oproepen. Nummers die je van je eigen provider meebrengt, komen na verificatie in aanmerking. Door ThunderPhone verstrekte nummers zijn aanvankelijk alleen beschikbaar voor inkomende oproepen en je kunt in het dashboard toegang voor uitgaande oproepen aanvragen. Zie Een telefoonnummer verkrijgen.
• Uitgaande oproep plaatsen vereist een Idempotentiesleutel. Koppel een stabiele ID uit de trigger of het bronrecord, zoals de ThunderPhone-gebeurtenis-ID of een CRM-record-ID. Als Zapier de stap opnieuw probeert, herkent ThunderPhone de sleutel en retourneert het de oorspronkelijke oproep in plaats van een tweede oproep te plaatsen. Vermijd tijdstempels, willekeurige waarden of alleen de Zap-ID.
• Campagne starten vereist Toestemming voor kosten, waarmee wordt bevestigd dat de Zap factureerbare uitgaande oproepen op je account mag starten.
• Je organisatie is verantwoordelijk voor het hebben van toestemming om elk nummer te bellen en voor het naleven van de toepasselijke belwetgeving. Zie wetgeving voor uitgaand bellen.

Een idempotentiesleutel is uniek binnen je organisatie en mag maximaal 128 tekens bevatten. Het hergebruiken van een sleutel met een andere agent, ander nummer of andere variabelen mislukt met een conflict. Als twee Zaps dus over hetzelfde record kunnen bellen, geef elke Zap dan een eigen vast voorvoegsel vóór de record-ID. Uitgaande oproepen plaatsen behandelt de API achter deze actie.

Voorbeeld-Zaps#

• Voltooide oproep naar een CRM. Registreer een activiteit voor elke voltooide oproep met de status, eindreden en transcriptie.
• Beoordeelde oproep voor opvolging. Filter op het oproepresultaat of de score en stuur de oproep naar de juiste workflow voor opvolging.
• Nieuwe lead naar een campagne. Voeg de lead toe aan een conceptcampagne met Add Contacts to Campaign en voer vervolgens Start Campaign uit zodra iemand de lijst goedkeurt.

Oproeptranscripties, samenvattingen en opnamen kunnen persoonlijke of gezondheidsinformatie bevatten. Stuur ze alleen naar apps die je organisatie voor die gegevens mag gebruiken, onder een BAA wanneer het om gezondheidsinformatie gaat, en bewaar alleen de velden die je nodig hebt.

Problemen oplossen#

Een stap mislukt met een autorisatiefout. Verbind de ThunderPhone-verbinding opnieuw in Zapier en keur deze opnieuw goed. Een verbinding werkt niet meer wanneer de persoon die deze heeft verbonden de verbinding intrekt in ThunderPhone onder Organisatie → Sleutels → Geautoriseerde apps, wanneer die persoon de organisatie verlaat, of wanneer er 30 dagen geen succesvolle tokenvernieuwing plaatsvindt. Zie Verbinden met OAuth.

Een Zap in- of uitschakelen mislukt, of een actie wordt geweigerd. De persoon die de verbinding heeft gemaakt, heeft de beheerders- of eigenaarsrol in de organisatie nodig. Verbind opnieuw met een account dat deze rol heeft. Een trigger-Zap die al is ingeschakeld, blijft oproepgebeurtenissen ontvangen nadat de rol is gewijzigd of de verbinding is ingetrokken. Schakel deze uit om dit te stoppen.

Je wilt de app loskoppelen. Schakel je ThunderPhone-Zaps uit voordat je de verbinding intrekt, omdat het uitschakelen van een Zap het eindpunt verwijdert en een werkende verbinding nodig heeft. Als je deze eerst hebt ingetrokken, verwijder dan het overgebleven eindpunt Zapier: … met DELETE /v1/developer/webhook-endpoints/{id} met een API-sleutel voor beheerders. Zie Webhookeindpunten.

De Zap moet een andere organisatie gebruiken. Elke verbinding omvat één organisatie. Schakel de Zap eerst uit, zodat het webhookeindpunt uit de huidige organisatie wordt verwijderd. Verbind vervolgens een nieuw ThunderPhone-account in Zapier, kies de andere organisatie wanneer je goedkeurt en selecteer die verbinding bij elke ThunderPhone-stap. Agenten, nummers en campagnes verschillen per organisatie, dus kies Agent, Van-nummer en Campagne opnieuw bij elke stap die deze bevat. Schakel de Zap vervolgens weer in.

De trigger wordt niet meer geactiveerd. Elke Zap met een ThunderPhone-trigger heeft één webhookeindpunt in je organisatie, met de naam Zapier: Oproep voltooid of Zapier: Oproep beoordeeld. Het wordt gemaakt wanneer de Zap wordt ingeschakeld en verwijderd wanneer deze wordt uitgeschakeld. Laat het ongewijzigd. Als het in ThunderPhone is bewerkt of verwijderd, schakel de Zap dan uit en weer in om een nieuw eindpunt te maken. Met een API-sleutel voor beheerders toont GET /v1/developer/webhook-deliveries recente bezorgpogingen.