Integration mit Twilio
Tabs
PlatoForms kann Textnachrichten (SMS) für Ihre Formulare senden: Übermittlungsbenachrichtigungen, Einladungen, Dokumentanforderungen, Erneuerungen und Workflow-Aufgaben. Standardmäßig werden sie über PlatoForms SMS gesendet, das von Ihrem Guthaben bezahlt wird und einen festen Text verwendet. Wenn Sie ein Twilio-Konto haben, können Sie es verbinden und diese Texte stattdessen über Ihr eigenes Twilio senden.
PlatoForms SMS oder Ihr eigenes Twilio
| PlatoForms SMS | Ihr eigenes Twilio | |
|---|---|---|
| Absender | Ein PlatoForms-Absender | Ihr Twilio Messaging Service: Ihre Telefonnummer oder Absender-ID |
| Kosten | Bezahlt von Ihrem PlatoForms-Guthaben | Von Twilio auf Ihr Konto abgerechnet. Kein PlatoForms-Guthaben wird verwendet |
| Länder | Die Länder, die PlatoForms SMS unterstützt | Jedes Land, in das Ihr Twilio-Konto SMS senden kann |
| Nachrichtentext | Festgelegt von PlatoForms | Sie schreiben ihn, mit Variablen wie dem Namen des Empfängers und dem Link |
| Genehmigung für neue Konten | Einmalige Genehmigung | Nicht erforderlich |
Kein Twilio-Konto? Sie benötigen keines: PlatoForms SMS sendet Ihre Texte ohne Einrichtung, und ein US-amerikanisches oder kanadisches Unternehmen kann sich dort registrieren, um US-Nummern zu texten. Siehe Textnachrichten (SMS) senden. Die beiden Dienste sind getrennt: Die Registrierung bei PlatoForms ändert nichts daran, was Ihr Twilio-Konto senden kann.
Sie verbinden Twilio einmal für Ihr Team. Danach wählen Sie den Dienst an jedem Ort, der Texte sendet, sodass ein Formular Ihr Twilio verwenden kann, während ein anderes bei PlatoForms SMS bleibt.
Textnachrichten erfordern einen bezahlten Plan. Die Verbindung mit Twilio wird vom Teamleiter oder einem Mitglied mit Abrechnungszugang hergestellt. Wenn Sie die Twilio-Karte auf der Integrationen-Seite eines Formulars nicht sehen, ist die Funktion für Ihr Team noch nicht aktiviert: kontaktieren Sie uns.
Bevor Sie beginnen: Was Sie von Twilio benötigen
Sammeln Sie diese im Twilio Console:
-
Ein Messaging-Service mit einem Absender in seinem Pool. Gehen Sie zu Messaging > Services, öffnen oder erstellen Sie einen Service und fügen Sie eine Telefonnummer oder eine alphanumerische Absender-ID zu seinem Absenderpool hinzu. Kopieren Sie die Messaging Service SID (beginnt mit
MG). -
Ihre Account SID (beginnt mit
AC), angezeigt unter Account info. -
Ein Standard-API-Schlüssel. Gehen Sie zu Account > API keys & tokens, erstellen Sie einen Standard-Schlüssel und kopieren Sie dessen SID (beginnt mit
SK) und dessen secret. Twilio zeigt das Secret nur einmal an. Lassen Sie den Regionsauswahl auf United States (US1), dem Standard. Die Region begrenzt nicht, in welche Länder Sie SMS senden können.
Verwenden Sie einen API-Schlüssel, niemals Ihr Twilio Auth Token. Ein API-Schlüssel kann eigenständig widerrufen werden, ohne dass andere Teile Ihres Twilio-Kontos betroffen sind.
Um US-Nummern zu texten, erfordert Twilio, dass der Messaging-Service eine registrierte A2P 10DLC-Kampagne oder eine verifizierte gebührenfreie Nummer hat. Andere Länder haben ihre eigenen Absenderregeln, und viele akzeptieren eine alphanumerische Absender-ID. Überprüfen Sie Twilios Richtlinien für die Länder, in die Sie texten.
Verbinden Sie Ihr Twilio-Konto
-
Bewegen Sie auf dem Dashboard den Mauszeiger über ein beliebiges Formular, klicken Sie oben rechts auf das Einstellungen-Symbol (Zahnradsymbol) und dann auf Formular verwalten.
-
Klicken Sie in der linken Seitenleiste auf Integrationen.
-
Finden Sie die Twilio-Karte und klicken Sie auf Verbinden. Die Seite Textnachrichten öffnet sich in einem neuen Browser-Tab auf ihrer Ihr eigenes Twilio-Registerkarte.
NoteDie Verbindung gilt für Ihr gesamtes Team, daher tun Sie dies einmal, von jedem Formular aus. Sie können die Seite auch von Plan und Abrechnung > Guthabenkonto öffnen: Klicken Sie auf Textnachrichteneinstellungen neben SMS-Nachrichten, dann auf die Registerkarte Ihr eigenes Twilio.
-
Geben Sie unter Verbinden Sie Ihr Twilio die Account SID, Messaging Service SID, API Key SID und das API Key Secret ein und klicken Sie auf Verbinden.
PlatoForms überprüft das Konto, den Messaging-Service und seine Absender mit diesen Anmeldeinformationen. Es wird nichts gesendet. Das API Key Secret wird verschlüsselt gespeichert.
-
Wenn die Überprüfung erfolgreich ist, zeigt Ihr eigenes Twilio Verbunden an, mit den Nummern oder Absender-IDs Ihres Messaging-Services.
-
(Optional) Geben Sie unter Senden Sie einen Testtext eine Mobilnummer ein und klicken Sie auf Testtext senden, um die Zustellung zu bestätigen. Twilio berechnet Ihnen diesen Text.
Verwenden Sie Ihr Twilio für die Texte eines Formulars
Das Verbinden von Twilio ändert nichts von selbst. Jeder SMS-Bereich verwendet weiterhin PlatoForms SMS, bis Sie es umschalten.
-
Öffnen Sie die SMS-Einstellungen, die Sie ändern möchten, z. B. Formular verwalten > Einladungen oder Formular verwalten > Benachrichtigungen, und aktivieren Sie SMS.
-
Wählen Sie Ihr eigenes Twilio.
-
Schreiben Sie die Textnachricht. Klicken Sie auf eine Variable neben Einfügen, um sie hinzuzufügen. Was das Telefon zeigt zeigt die Nachricht mit Beispielwerten an und gibt deren Länge und die Anzahl der gesendeten Texte an.
-
Speichern Sie Ihre Änderungen.
Sie können diese Wahl an jedem dieser Orte treffen:
| Wo | Welche Texte |
|---|---|
| Benachrichtigungen | Der Text, der gesendet wird, wenn das Formular übermittelt wird |
| Einladungen | Die Einladung und ihre Erinnerung |
| Dokumentanforderungen | Der Dokumentenlink, die Erinnerungen und die Aufforderung zu einem neuen Upload |
| Erneuerung | Die Erneuerungsmitteilung |
| Workflow-Schritt-Benachrichtigungen | Der Text, der für eine Workflow-Aufgabe gesendet wird |
Regeln für Ihren eigenen Text
- Ein Text kann bis zu 320 Zeichen lang sein. Eine lange Nachricht wird als mehrere Texte gesendet; die Vorschau zeigt, wie viele.
- Verwenden Sie nur die für diesen Text angebotenen Variablen. Wo der Text einen Link liefert (Einladungen, Dokumentanforderungen, Erneuerungen und Workflow-Aufgaben), muss er
{{ link }}enthalten. - PlatoForms fügt jedem Text eine Opt-out-Zeile hinzu: “Antworten Sie mit STOP, um sich abzumelden.” wenn der Absender eine Telefonnummer ist, oder einen Opt-out-Link, wenn es sich um eine alphanumerische Absender-ID handelt, die keine Antworten empfangen kann. Wenn Ihr Messaging-Service beides hat, verwendet Twilio die alphanumerische Absender-ID, wo immer das Land eine erlaubt (überall außer in den USA und Kanada), sodass diese Texte mit dem Opt-out-Link enden.
- Ein Text wird überprüft, wenn Sie ihn speichern. Ein Text, der nach Passwörtern, Zahlungsdetails oder persönlichen Informationen fragt, wird nicht akzeptiert.
- Texten Sie nur Personen, die zugestimmt haben, Texte von Ihnen zu erhalten. Tägliche Limits pro Empfänger und pro Formular gelten weiterhin, um die Personen zu schützen, die Sie texten.
| Variable | Einfügen | Verfügbar in |
|---|---|---|
{{ team }} |
Ihr Teamname | Jeder Text |
{{ form }} |
Der Formularname | Jeder Text |
{{ name }} |
Der Vorname des Empfängers | Einladungen |
{{ link }} |
Der Link, den der Empfänger öffnet | Einladungen, Dokumentanforderungen, Erneuerung, Workflow-Schritte |
{{ workflow }}, {{ step }} |
Der Workflow-Name und der Schrittname | Workflow-Schritte |
{{ item }}, {{ expires }} |
Der Dokumentname und das Fälligkeitsdatum | Erneuerung |
Abrechnung und Nutzung
- Texte, die über Ihr Twilio gesendet werden, werden von Twilio auf Ihr Konto abgerechnet. PlatoForms berechnet dafür nichts und sie verwenden nicht Ihr Guthaben.
- Sie erscheinen weiterhin auf der Nutzung-Seite unter SMS, mit $0,00.
- Bereiche, die auf PlatoForms SMS verbleiben, funktionieren wie zuvor und werden von Ihrem Guthaben bezahlt.
Ersetzen Sie den API-Schlüssel oder trennen Sie die Verbindung
- Schlüssel ersetzen: Erstellen Sie einen neuen API-Schlüssel in Twilio, öffnen Sie die Textnachrichten-Seite (klicken Sie auf Konfigurieren auf der Twilio-Karte) und geben Sie den Schlüssel unter Ihr Twilio erneut verbinden ein.
- Verbindung trennen: Klicken Sie auf Ihr Twilio trennen. Das API Key Secret wird aus PlatoForms entfernt. Bereiche, die auf Ihr eigenes Twilio eingestellt sind, kehren zu PlatoForms SMS mit dem Standardtext zurück. Ihre Wahl und Ihre Texte werden beibehalten und erneut verwendet, wenn Sie die Verbindung wiederherstellen.
- Benötigt Aufmerksamkeit: Wenn Twilio aufhört, den Schlüssel zu akzeptieren, zum Beispiel nachdem Sie ihn widerrufen haben, zeigt die Verbindung Benötigt Aufmerksamkeit an und der Teamleiter erhält eine E-Mail. Bis Sie die Verbindung wiederherstellen, verwenden diese Bereiche PlatoForms SMS, das Guthaben in Ihrem Konto benötigt.
Fehlerbehebung
| Was Sie sehen | Was zu tun ist |
|---|---|
| “Dieser Messaging-Service hat keinen Absender.” | Fügen Sie in Twilio eine Telefonnummer oder eine alphanumerische Absender-ID zum Absenderpool des Services hinzu und verbinden Sie sich erneut |
| Texte an US-Nummern werden nicht zugestellt | Registrieren Sie eine A2P 10DLC-Kampagne für den Messaging-Service oder verwenden Sie eine verifizierte gebührenfreie Nummer |
| “Verbinden Sie zuerst Ihr Twilio-Konto.” | Verbinden Sie Twilio auf der Textnachrichten-Seite, bevor Sie Ihr eigenes Twilio wählen |
| “Dieser Text wurde nicht akzeptiert.” | Entfernen Sie Formulierungen, die nach Passwörtern, Zahlungsdetails oder persönlichen Informationen fragen |
| Ein Bereich, der auf Ihr eigenes Twilio eingestellt ist, verwendet Ihr Guthaben | Ihr Twilio ist getrennt oder benötigt Aufmerksamkeit. Stellen Sie die Verbindung auf der Ihr eigenes Twilio-Registerkarte wieder her |
| “Dieser Messaging-Service hat keinen registrierten US-Absender” | Registrieren Sie eine A2P 10DLC-Kampagne oder verifizieren Sie eine gebührenfreie Nummer in Ihrer Twilio-Konsole. Die Registrierung Ihres Unternehmens unter PlatoForms SMS behebt dies nicht |