SMS und WhatsApp mit Ihrem eigenen Twilio-Konto senden
Verbinden Sie Twilio, um Umfrage-Einladungen per SMS und WhatsApp von Ihren eigenen Nummern zu senden, Antworten in Gesprächen zu empfangen und den Zustellstatus jeder Nachricht zu sehen.
Auf dieser Seite
Verbinden Sie Ihr Twilio-Konto, und Polzy sendet die SMS- und WhatsApp-Nachrichten dieses Arbeitsbereichs — Einladungen und Erinnerungen von Kampagnen, Workflow-Nachrichten und Antworten in einem Gespräch — von Ihren eigenen Twilio-Nummern. Empfänger können zurückschreiben: Antworten kommen im Gespräch in Polzy an, und das Protokoll jeder Nachricht zeigt, ob sie zugestellt wurde.
SMS und WhatsApp gibt es ab dem Tarif Business, und nur Admins können einen Anbieter verbinden. Verbinden Sie Twilio auf der Seite Integrationen oder unter Nachrichten → Integrationen.
Bevor Sie beginnen
Sie brauchen:
- Einen Arbeitsbereich im Tarif Business oder höher und darin die Rolle Admin.
- Ein bezahltes Twilio-Konto (keine Testversion) mit einer Nummer, die SMS senden kann, oder einem Messaging Service.
- Für WhatsApp: einen in Twilio registrierten WhatsApp-Absender (siehe WhatsApp).
- Die Mobilnummern Ihrer Teilnehmenden in deren Daten. Polzy speichert sie im internationalen Format, etwa
+49 151 23456789; eine Nummer ohne Ländervorwahl wird im Land Ihrer Organisation gelesen, dem aus den Rechnungsangaben.
Wie Polzy Twilio nutzt
- SMS und WhatsApp. Sobald Sie Twilio für SMS, WhatsApp oder beides wählen, geht jede Nachricht des Arbeitsbereichs auf diesem Kanal über Ihr Konto.
- Antworten. Schreibt jemand zurück, wird die Antwort seinem offenen Gespräch in Polzy hinzugefügt (siehe Gespräche).
- Zustellung. Das Protokoll jeder Nachricht unter Nachrichten zeigt Zugestellt oder Fehlgeschlagen, mit dem Grund von Twilio.
- Was es kostet. Twilio stellt Ihnen diese Nachrichten in Rechnung. Sie zählen nicht zu den monatlichen Nachrichten Ihrer Organisation in Polzy; diese gelten nur für den Absender von Polzy.
Schritt 1: Twilio einrichten
- Kaufen Sie in der Twilio Console eine Nummer, die SMS in die gewünschten Länder senden kann, oder legen Sie unter Messaging → Services einen Messaging Service an und fügen Sie Ihre Nummern seinem Sender Pool hinzu. Ein Messaging Service wählt für jede Nachricht die passende Nummer.
- Kopieren Sie Account SID und Auth Token aus Account Info auf der Startseite der Console.
- Wenn Sie in andere Länder senden, prüfen Sie, dass diese in den geografischen SMS-Berechtigungen (Geo Permissions) Ihres Kontos erlaubt sind.
Siehe Twilio: Messaging Services.
Schritt 2: Twilio in Polzy verbinden
- Öffnen Sie Integrationen in der Seitenleiste, den Tab Verfügbar, und klicken Sie in der Zeile von Twilio auf Verbinden. Oder öffnen Sie Nachrichten, den Tab Integrationen, und klicken Sie bei Twilio auf Einrichten.
- Füllen Sie im Fenster Twilio verbinden die Felder aus:
| Feld | Was Sie eingeben |
|---|---|
| Account SID | Beginnt mit AC. Erforderlich. |
| Auth Token | Erforderlich. Polzy prüft damit auch, dass Zustellbestätigungen und Antworten von Twilio kommen. |
| Messaging Service SID | Beginnt mit MG. Empfohlen für SMS. |
| Absender-Telefonnummer | Eine Twilio-Nummer im internationalen Format, wenn Sie keinen Messaging Service nutzen. |
| WhatsApp-Absendernummer | Die Nummer Ihres WhatsApp-Absenders, etwa +15550000000, für WhatsApp. |
Geben Sie eine Messaging Service SID oder eine Absender-Telefonnummer ein: Polzy braucht eines davon, auch wenn Sie nur WhatsApp senden. Sind beide ausgefüllt, wird für SMS der Messaging Service genutzt.
- Klicken Sie auf Verbindung testen. Sie sollten Connected to Twilio account: mit dem Namen Ihres Kontos sehen (diese Meldung ist auf Englisch).
- Klicken Sie auf Verbinden.
Schritt 3: Twilio für SMS und WhatsApp auswählen
- Öffnen Sie Einstellungen, dann den Tab Benachrichtigungen, und scrollen Sie zu Kanäle.
- Ändern Sie in der Zeile SMS Polzy · gemeinsames Konto in Twilio, und achten Sie darauf, dass der Schalter eingeschaltet ist.
- Um auch WhatsApp zu senden, tun Sie dasselbe in der Zeile WhatsApp.
Slack
TeamsEine Kampagne sendet dann über Twilio, wenn Sie im Tab Versand SMS oder WhatsApp als Kanal wählen. Eine Kampagne nutzt einen Kanal.
Schritt 4: Antworten empfangen
Zustellbestätigungen brauchen nichts weiter: Polzy fordert bei Twilio mit jeder Nachricht einen Status Callback an. Für Antworten ist eine Einstellung in Twilio nötig.
- Öffnen Sie in Polzy die Seite von Twilio über Integrationen und suchen Sie Empfang. Kopieren Sie die dort angezeigte Adresse.
- Öffnen Sie in der Twilio Console die Messaging-Konfiguration Ihrer Nummer und stellen Sie den Webhook für eingehende Nachrichten („a message comes in“) auf diese Adresse, mit der Methode HTTP POST. Bei einem Messaging Service stellen Sie ihn stattdessen in dessen Integrationseinstellungen ein. Für WhatsApp stellen Sie ihn beim WhatsApp-Absender ein.
- Fügen Sie die Adresse genau wie angezeigt ein: Twilio signiert jede Anfrage zusammen mit der Adresse, eine veränderte Adresse besteht die Prüfung also nicht.
Die Antwort einer Person mit offenem Gespräch auf diesem Kanal wird diesem hinzugefügt, und wer das Gespräch eröffnet hat, wird benachrichtigt. Eine Nachricht von jemand anderem erscheint nicht in Polzy. Siehe Twilio: Messaging webhooks.
WhatsApp-Nachrichten laufen über einen WhatsApp-Absender, den Sie in der Twilio Console unter Messaging → Senders → WhatsApp senders registrieren: Sie verknüpfen ein WhatsApp-Business-Konto über Meta, verifizieren die Nummer und schließen vor dem Livegang die Unternehmensverifizierung von Meta ab. Geben Sie die Nummer in Polzy als WhatsApp-Absendernummer ein. Siehe Twilio: Register WhatsApp senders using Self Sign-up.
WhatsApp erlaubt einem Unternehmen freie Nachrichten nur innerhalb von 24 Stunden nach der letzten Nachricht der Person. Außerhalb dieses Fensters akzeptiert es nur eine von Meta genehmigte Vorlage, und Twilio lehnt alles andere mit dem Fehler 63016 ab. Was das in Polzy bedeutet:
- Kampagnen-Einladungen werden als normale Nachrichten gesendet, daher stellt WhatsApp sie nur Personen zu, die Ihrer WhatsApp-Nummer in den letzten 24 Stunden geschrieben haben. Für alle anderen schlägt die Nachricht mit dem Fehler 63016 fehl. Für einen ersten Kontakt senden Sie per SMS oder E-Mail.
- Gespräche. Innerhalb von 24 Stunden nach der letzten Nachricht der Person antworten Sie frei. Danach zeigt Polzy WhatsApp erlaubt freie Antworten nur innerhalb von 24 Stunden nach der letzten Nachricht. Senden Sie eine genehmigte Vorlage, um sie wieder zu öffnen.
- Vorlagen. Twilio sendet eine genehmigte Vorlage nur über ihre Content-ID, die Polzy nicht mitschickt: Eine mit Vorlage senden gewählte Vorlage geht über Twilio als normaler Text hinaus, und Twilio lehnt sie außerhalb des Fensters ab. Mit Twilio geht das Gespräch weiter, sobald die Person wieder schreibt.
Siehe Twilio: Send WhatsApp notification messages with templates und Twilio: Error 63016.
Limits und Kosten
- SMS-Segmente. Eine SMS fasst bis zu 160 Zeichen oder 70, wenn der Text ein Zeichen außerhalb des Standard-GSM-Alphabets enthält — ein Emoji oder eine Schrift wie Arabisch. Eine längere Nachricht wird in Teilen gesendet, und Twilio berechnet jeden Teil.
- Ruhezeiten. Mit eingeschaltetem Ruhezeiten einhalten unter Einstellungen → Benachrichtigungen warten Kampagnennachrichten bis 08:00 in der Zeitzone des Empfängers, statt zwischen 20:00 und 08:00 hinauszugehen.
- Die Limits Ihres Kontos. Es gelten die Sendelimits und Länderregeln von Twilio.
Fehlerbehebung
| Was Sie sehen | Warum, und was zu tun ist |
|---|---|
| Authenticate | Twilio hat Account SID und Auth Token abgelehnt. Kopieren Sie beide erneut; wurde der Token in Twilio geändert, nutzen Sie den neuen. |
| Either Messaging Service SID or From Number is required | Geben Sie eine Messaging Service SID oder eine Absender-Telefonnummer ein. |
| Nachrichten scheitern mit Permission to send an SMS has not been enabled for the region | Erlauben Sie dieses Land in den geografischen SMS-Berechtigungen Ihres Twilio-Kontos. |
| WhatsApp-Nachrichten scheitern mit Fehler 63016 | Die Person hat Ihrer WhatsApp-Nummer in den letzten 24 Stunden nicht geschrieben (siehe WhatsApp). |
| SMS ist in einer Kampagne nicht verfügbar | SMS ist unter Einstellungen → Benachrichtigungen → Kanäle ausgeschaltet oder hat keinen Anbieter. |
| Antworten kommen nicht an | Prüfen Sie den Webhook für eingehende Nachrichten in Twilio und dass die Adresse genau eingefügt wurde. Der Abschnitt Aktivität auf der Seite von Twilio zeigt Eingehende Nachricht abgelehnt, wenn die Prüfung scheitert, etwa nachdem der Auth Token in Twilio, aber nicht in Polzy geändert wurde. |
Gut zu wissen
- Ein neuer Auth Token. Wenn Sie den Auth Token in Twilio ändern, tragen Sie den neuen sofort in Polzy ein (Konfigurieren): Senden, Zustellbestätigungen und Antworten nutzen ihn alle.
- Der Absender von Polzy. Ohne eigenen Anbieter gehen SMS als Einbahnnachricht vom gemeinsamen Absender von Polzy hinaus, zählen zu den monatlichen Nachrichten Ihrer Organisation, und niemand kann darauf antworten. WhatsApp läuft über Ihr eigenes Telnyx- oder Twilio-Konto, bis die WhatsApp-Nummer von Polzy verifiziert ist.
- Wenn Twilio nicht mehr funktioniert, versucht Polzy es weiter und markiert es mit Erfordert Aufmerksamkeit. Trennen Sie es, gehen SMS wieder über den gemeinsamen Absender von Polzy.
- Was Polzy speichert. Der Auth Token wird verschlüsselt gespeichert und nie wieder angezeigt.
Nützliche Links
Verwandte Artikel
Angemeldete Mitglieder können Polzy fragen oder dem Team über Support schreiben. Wie schnell wir antworten, hängt von Ihrem Tarif ab.