ThunderPhone mit Zapier verwenden

Verbinden Sie die ThunderPhone-App auf Zapier mit Ihrer Organisation und erstellen Sie einen Zap, der jedes Mal ausgeführt wird, wenn ein Anruf endet.

Zapier verbindet Apps mit automatisierten Workflows, die Zaps genannt werden. Die ThunderPhone-App auf Zapier bietet:

• Auslöser: Anruf abgeschlossen wird ausgelöst, wenn ein Telefon-, Web- oder Testanruf endet. Anruf bewertet wird ausgelöst, wenn die Bewertung eines abgeschlossenen Anrufs verfügbar ist.
• Aktionen: Ausgehenden Anruf tätigen, Kontakte zu Kampagne hinzufügen und Kampagne starten.
• Suche: Anruf suchen sucht einen Anruf anhand seiner ID und gibt ihn mit seinem Transkript und einer signierten Aufzeichnungs-URL zurück, sofern eine verfügbar ist.

Sie finden die App unter ThunderPhone auf Zapier. Eine Übersicht über beide Möglichkeiten, Zapier mit ThunderPhone zu verwenden, finden Sie auf der Zapier-Integrationsseite.

Ihre Organisation verbinden#

Die App wird über OAuth verbunden. Sie melden sich bei ThunderPhone an und genehmigen den Zugriff für eine Organisation. Dabei wird kein API-Schlüssel in Zapier kopiert.

1. Einen ThunderPhone-Schritt hinzufügen

   Suchen Sie im Zap-Editor nach ThunderPhone (mit einer Beta-Kennzeichnung) und wählen Sie einen Auslöser oder eine Aktion aus. Wenn Zapier nach einem Konto fragt, verbinden Sie ein neues. Zapier öffnet ein ThunderPhone-Anmeldefenster.

2. Anmelden und Organisation auswählen

   Melden Sie sich an, prüfen Sie die angeforderten Berechtigungen, wählen Sie die Organisation aus und klicken Sie auf Genehmigen. Die App fordert Berechtigungen zum Lesen Ihrer Agenten und Telefonnummern, zum Lesen und Schreiben von Anrufen und Kampagnen, zum Verwalten von Integrationen wie Webhook- Endpunkten sowie zum Anzeigen Ihrer Konto-E-Mail-Adresse an.

3. Den Verbindungsnamen prüfen

   Zapier benennt die Verbindung nach der Organisation, die Sie genehmigt haben. So können Sie Verbindungen unterscheiden, wenn Sie mehreren Organisationen angehören.

Verbinden Sie sich mit einem Konto, das in dieser Organisation die Administrator- oder Inhaberrolle hat. Zum Aktivieren oder Deaktivieren eines Auslöser-Zaps sowie für jede Aktion ist diese Rolle erforderlich. Ein bereits aktivierter Auslöser-Zap empfängt weiterhin Anrufereignisse, wenn sich die Rolle ändert oder die Verbindung widerrufen wird. Deaktivieren Sie ihn, um dies zu beenden. Die Funktion Anruf suchen steht jedem Mitglied zur Verfügung.

Für die App selbst fallen keine ThunderPhone-Gebühren an. Von ihr getätigte oder gestartete Anrufe werden zu Ihren regulären ThunderPhone-Tarifen abgerechnet, und Zapier zählt Aufgaben gemäß Ihrem Zapier-Tarif.

Erstellen Sie Ihren ersten Zap#

Dieser Zap fügt jedes Mal, wenn ein Anruf endet, eine Zeile zu einer Google-Tabelle hinzu.

1. Tätigen Sie einen Anruf für Beispieldaten

   Öffnen Sie einen Agenten im Builder, klicken Sie auf Sprechen, und beenden Sie den Anruf. Testanrufe im Builder lösen „Anruf abgeschlossen“ aus, sodass der Auslöser einen aktuellen Anruf zum Laden erhält.

2. Fügen Sie den Auslöser hinzu

   Wählen Sie ThunderPhone als Auslöser-App, legen Sie das Ereignis auf Anruf abgeschlossen fest und wählen Sie Ihre ThunderPhone-Verbindung aus. Testen Sie den Auslöser. Zapier lädt Ihre zuletzt abgeschlossenen Anrufe als Beispiele im selben Format wie ein Live-Ereignis.

3. Fügen Sie Google Sheets hinzu

   Fügen Sie eine Google-Sheets-Aktion hinzu, die eine Tabellenzeile erstellt. Wählen Sie eine Tabelle mit einer Kopfzeile aus und ordnen Sie dann jede Spalte einem Feld des Auslösers zu (siehe Tabelle unten).

4. Veröffentlichen Sie den Zap

   Veröffentlichen und aktivieren Sie den Zap. Durch die Aktivierung wird in Ihrer ThunderPhone-Organisation ein Webhook-Endpunkt mit dem Namen Zapier: Anruf abgeschlossen erstellt. Durch die Deaktivierung des Zap wird dieser Endpunkt gelöscht.

5. Testen Sie ihn

   Tätigen Sie einen weiteren Testanruf im Builder. Wenn er endet, wird der Zap ausgeführt und eine Zeile erscheint.

Nützliche Spalten:

Der Anruflink öffnet den Anruf im ThunderPhone-Dashboard für Mitglieder Ihrer Organisation, einschließlich Abschrift und Aufzeichnung, sodass die Tabelle keines von beidem enthalten muss.

Das Ereignis kann außerdem die Abschrift als Liste von Gesprächsbeiträgen sowie eine Aufzeichnungs-URL enthalten, einen signierten Link, der abläuft. Fügen Sie diese nur hinzu, wenn die Tabelle sie benötigt. Anrufabschriften, Zusammenfassungen und Aufzeichnungen können personenbezogene oder Gesundheitsdaten enthalten. Senden Sie sie nur an Apps, die Ihre Organisation für diese Daten verwenden darf, bei Gesundheitsdaten im Rahmen eines BAA, und speichern Sie nur die benötigten Felder. Siehe telephony.complete / web.complete für alle Felder.

Auslöser, Aktionen und Suche#

Anruf bewertet liefert die Anruf-ID, Agenten-ID, den Agentennamen und die Bewertung: Bewertungs-ID, Punktzahl, Anrufergebnis, Zusammenfassung, Bewertungsmodell und Bewertet am. Durch das Aktivieren eines Zaps wird ein Endpunkt mit dem Namen Zapier: Anruf bewertet erstellt. Ein Anruf kann mehr als einmal bewertet werden, und jeder abgeschlossene Bewertungslauf löst den Auslöser aus. Siehe call.graded.

Anruf suchen verwendet eine Anruf-ID mit einer Dropdown-Liste kürzlich erfolgter Anrufe. Die Aktion gibt den Agenten, die Richtung, Nummern, Start- und Endzeiten, Status, Endgrund, Bewertungspunktzahl und Anrufergebnis, das Transkript sowie eine signierte Aufnahme-URL zurück, wenn eine verfügbar ist. Eine unbekannte Anruf-ID gibt statt eines Fehlers kein Ergebnis zurück.

Ausgehenden Anruf starten verwendet:

Die Aktion gibt die Anruf-ID, den Status und die idempotente Wiederholung zurück.

Kontakte zu Kampagne hinzufügen fügt Kontakte zu einer Entwurfskampagne hinzu. Füllen Sie für einen Kontakt Telefonnummer im E.164-Format und optional Kontaktvariablen aus, ein JSON-Objekt, dessen Eigenschaften zu Kampagnenvariablen werden. Füllen Sie für einen Batch Kontakte JSON mit einem Array aus bis zu 5.000 Objekten aus. Jedes benötigt phone_number; seine weiteren Eigenschaften werden zu Variablen. Der Schritt schlägt fehl, wenn jeder Kontakt abgelehnt wird, und setzt Teilweiser Erfolg, wenn nur einige abgelehnt werden.

Kampagne starten startet oder setzt eine Kampagne mit mindestens einem Kontakt fort. Dafür ist Zustimmung zur Abrechnung erforderlich. Siehe Ausgehende Kampagnen.

Bevor ein Zap Anrufe startet#

Ausgehenden Anruf starten und Kampagne starten wählen echte Telefonnummern und beginnen abrechenbare Anrufe.

• Wenn ThunderPhone Ihre Organisation auffordert zu bestätigen, dass ihre ausgehenden Anrufe dem TCPA und anderen Anrufgesetzen entsprechen, muss ein Administrator diese Bestätigung im Dashboard hinterlegen, bevor ein Zap Anrufe starten kann.
• Die Von-Nummer muss für ausgehende Anrufe aktiviert sein. Nummern, die Sie von Ihrem eigenen Anbieter einbringen, sind nach der Verifizierung berechtigt. Von ThunderPhone bereitgestellte Nummern sind zunächst nur für eingehende Anrufe verfügbar; Sie können im Dashboard ausgehenden Zugriff dafür anfordern. Siehe Telefonnummer erhalten.
• Ausgehenden Anruf starten erfordert einen Idempotenzschlüssel. Ordnen Sie eine stabile ID aus dem Auslöser oder Quelldatensatz zu, beispielsweise die ThunderPhone-Ereignis-ID oder eine CRM-Datensatz-ID. Wenn Zapier den Schritt wiederholt, erkennt ThunderPhone den Schlüssel und gibt den ursprünglichen Anruf zurück, statt einen zweiten zu starten. Vermeiden Sie Zeitstempel, Zufallswerte oder nur die Zap-ID.
• Kampagne starten erfordert Zustimmung zur Abrechnung, die bestätigt, dass der Zap abrechenbare ausgehende Anrufe für Ihr Konto starten darf.
• Ihre Organisation ist dafür verantwortlich, für jede Nummer die Zustimmung zum Anrufen einzuholen und die geltenden Anrufgesetze einzuhalten. Siehe Gesetze für ausgehende Anrufe.

Ein Idempotenzschlüssel ist innerhalb Ihrer Organisation eindeutig und darf maximal 128 Zeichen lang sein. Die Wiederverwendung eines Schlüssels mit einem anderen Agenten, einer anderen Nummer oder anderen Variablen schlägt mit einem Konflikt fehl. Wenn zwei Zaps denselben Datensatz anrufen können, geben Sie jedem Zap vor der Datensatz-ID ein eigenes festes Präfix. Ausgehende Anrufe starten beschreibt die API hinter dieser Aktion.

Beispiel-Zaps#

• Abgeschlossener Anruf an ein CRM. Pro abgeschlossenem Anruf eine Aktivität mit Status, Beendigungsgrund und Transkript protokollieren.
• Bewerteter Anruf zur Nachverfolgung. Nach Anrufergebnis oder Bewertung filtern und den Anruf dem richtigen Nachverfolgungs-Workflow zuordnen.
• Neuer Lead zu einer Kampagne. Den Lead mit Kontakte zu Kampagne hinzufügen zu einer Entwurfskampagne hinzufügen und anschließend Kampagne starten ausführen, sobald jemand die Liste genehmigt.

Anruftranskripte, Zusammenfassungen und Aufzeichnungen können personenbezogene Daten oder Gesundheitsdaten enthalten. Senden Sie sie nur an Apps, die Ihre Organisation für diese Daten verwenden darf, bei Gesundheitsdaten im Rahmen eines BAA, und speichern Sie nur die benötigten Felder.

Fehlerbehebung#

Ein Schritt schlägt mit einem Autorisierungsfehler fehl. Verbinden Sie die ThunderPhone-Verbindung in Zapier erneut und genehmigen Sie sie erneut. Eine Verbindung funktioniert nicht mehr, wenn die Person, die sie verbunden hat, sie in ThunderPhone unter Organisation → Schlüssel → Autorisierte Apps widerruft, wenn diese Person die Organisation verlässt oder wenn 30 Tage lang keine erfolgreiche Token-Aktualisierung erfolgt. Siehe Mit OAuth verbinden.

Das Ein- oder Ausschalten eines Zap schlägt fehl oder eine Aktion wird verweigert. Die Person, die die Verbindung hergestellt hat, benötigt in der Organisation die Rolle Administrator oder Inhaber. Stellen Sie die Verbindung mit einem Konto mit dieser Rolle erneut her. Ein bereits aktivierter Trigger-Zap empfängt weiterhin Anrufereignisse, nachdem sich die Rolle geändert hat oder die Verbindung widerrufen wurde. Schalten Sie ihn aus, um dies zu beenden.

Sie möchten die App trennen. Schalten Sie Ihre ThunderPhone-Zaps aus, bevor Sie die Verbindung widerrufen, da das Ausschalten eines Zap seinen Endpunkt löscht und eine funktionierende Verbindung benötigt. Wenn Sie die Verbindung zuerst widerrufen haben, löschen Sie den verbliebenen Endpunkt Zapier: … mit DELETE /v1/developer/webhook-endpoints/{id} unter Verwendung eines Admin-API-Schlüssels. Siehe Webhook-Endpunkte.

Der Zap soll eine andere Organisation verwenden. Jede Verbindung gilt für eine Organisation. Schalten Sie den Zap zuerst aus, damit sein Webhook-Endpunkt aus der aktuellen Organisation gelöscht wird. Verbinden Sie dann ein neues ThunderPhone-Konto in Zapier, wählen Sie bei der Genehmigung die andere Organisation aus und wählen Sie diese Verbindung in jedem ThunderPhone-Schritt aus. Agenten, Nummern und Kampagnen unterscheiden sich zwischen Organisationen. Wählen Sie daher Agent, Von-Nummer und Kampagne erneut in jedem Schritt aus, der diese Optionen enthält. Schalten Sie den Zap anschließend wieder ein.

Der Trigger wird nicht mehr ausgelöst. Jeder Zap mit einem ThunderPhone-Trigger besitzt einen Webhook-Endpunkt in Ihrer Organisation mit dem Namen Zapier: Call Completed oder Zapier: Call Graded. Er wird erstellt, wenn der Zap eingeschaltet wird, und gelöscht, wenn er ausgeschaltet wird. Lassen Sie ihn unverändert. Wenn er in ThunderPhone bearbeitet oder gelöscht wurde, schalten Sie den Zap aus und wieder ein, um einen neuen zu erstellen. Mit einem Admin-API-Schlüssel zeigt GET /v1/developer/webhook-deliveries aktuelle Zustellversuche an.