SMS und WhatsApp mit Ihrem eigenen Telnyx-Konto senden
Verbinden Sie Telnyx, 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 Telnyx-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 Telnyx-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 Telnyx 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 Telnyx-Konto mit einer Telefonnummer, die Nachrichten senden kann und einem Messaging Profile zugeordnet ist.
- Für WhatsApp: ein in Telnyx verbundenes WhatsApp-Business-Konto auf einer Telnyx-Nummer (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 Telnyx nutzt
- SMS und WhatsApp. Sobald Sie Telnyx 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 Telnyx.
- Was es kostet. Telnyx 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: Telnyx einrichten
- Kaufen oder portieren Sie im Telnyx-Portal eine Nummer, die Nachrichten senden kann, für jedes Zielland.
- Legen Sie unter Messaging ein Messaging Profile an und ordnen Sie ihm Ihre Nummer zu. Ein Profil regelt Nummernpools und Zustelleinstellungen.
- Legen Sie unter API Keys einen Schlüssel an und kopieren Sie ihn. Telnyx zeigt ihn nur einmal.
- Öffnen Sie unter Keys & Credentials den Bereich Public Key und kopieren Sie den Schlüssel. Polzy prüft damit, dass Zustellbestätigungen und Antworten wirklich von Telnyx kommen.
Um mit einem Namen statt einer Nummer zu senden, etwa Acme, legen Sie eine alphanumerische Absender-ID im Messaging Profile fest. Darauf kann niemand antworten, sie erreicht die USA und Kanada nicht, und manche Länder verlangen, dass sie zuvor registriert wird.
Siehe Telnyx: Create and manage API keys, Telnyx: Messaging profiles und Telnyx: Alphanumeric sender ID.
Schritt 2: Telnyx in Polzy verbinden
- Öffnen Sie Integrationen in der Seitenleiste, den Tab Verfügbar, und klicken Sie in der Zeile von Telnyx auf Verbinden. Oder öffnen Sie Nachrichten, den Tab Integrationen, und klicken Sie bei Telnyx auf Einrichten.
- Füllen Sie im Fenster Telnyx verbinden die Felder aus:
| Feld | Was Sie eingeben |
|---|---|
| API key | Den Schlüssel aus Schritt 1. Erforderlich. |
| Messaging profile ID | Die ID des Profils, dem Ihre Nummer zugeordnet ist. Empfohlen für SMS. |
| Absendernummer | Ihre Telnyx-Nummer im internationalen Format (E.164), etwa +15550000000. |
| Alpha sender | Ein Absendername für internationale SMS, 3 bis 11 Buchstaben oder Ziffern, derselbe wie im Messaging Profile. Darauf kann niemand antworten. |
| WhatsApp-Nummer | Die bei Ihrem WhatsApp-Business-Konto registrierte Nummer, für WhatsApp. |
| Öffentlicher Webhook-Schlüssel | Der öffentliche Schlüssel aus Schritt 1. Ohne ihn werden Zustellbestätigungen und Antworten abgelehnt. |
Geben Sie für SMS eine Absendernummer oder einen Alpha sender ein: Polzy braucht eines davon zum Senden, auch mit Messaging Profile. Sind beide ausgefüllt, wird die Nummer genutzt, sodass Empfänger antworten können.
- Klicken Sie auf Verbindung testen. Sie sollten Connected to Telnyx mit der Zahl der für den Schlüssel sichtbaren Messaging Profiles sehen (diese Meldung ist auf Englisch).
- Klicken Sie auf Verbinden.
Schritt 3: Telnyx 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 Telnyx, und achten Sie darauf, dass der Schalter eingeschaltet ist.
- Um auch WhatsApp zu senden, tun Sie dasselbe in der Zeile WhatsApp.
Eine Kampagne sendet dann über Telnyx, 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 Telnyx mit jeder Nachricht eine Bestätigung an. Für Antworten ist eine Einstellung in Telnyx nötig.
- Öffnen Sie in Polzy die Seite von Telnyx über Integrationen und suchen Sie Empfang. Kopieren Sie die dort angezeigte Adresse.
- Öffnen Sie im Telnyx-Portal Ihr Messaging Profile und fügen Sie die Adresse als Inbound-Webhook-URL ein. Speichern Sie.
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 Telnyx: Receiving webhooks for messaging.
WhatsApp-Nachrichten laufen über ein WhatsApp-Business-Konto, das Sie in Telnyx unter Messaging → WhatsApp verbinden, indem Sie sich mit Ihrem Meta-Unternehmenskonto anmelden und Ihre Nummer verifizieren. Geben Sie diese Nummer in Polzy als WhatsApp-Nummer ein. Siehe Telnyx: Send your first WhatsApp message.
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. 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 fehl, und ihr Protokoll zeigt den Grund von Telnyx. 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. Wählen Sie unter Wählen Sie eine genehmigte Vorlage eine Vorlage und klicken Sie auf Vorlage senden.
- Vorlagen. Vorlagen werden in Telnyx erstellt und von Meta genehmigt, meist innerhalb von ein bis zwei Tagen. Die Liste in Polzy zeigt die für Ihren Arbeitsbereich registrierten Vorlagen; Polzy hat keinen Bildschirm, um eine hinzuzufügen. Steht dort Noch keine genehmigten Vorlagen, geht das Gespräch weiter, sobald die Person wieder schreibt.
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 Telnyx 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 Telnyx.
Fehlerbehebung
| Was Sie sehen | Warum, und was zu tun ist |
|---|---|
| A from number, alpha sender, or WhatsApp number is required | Geben Sie mindestens einen Absender ein. Für SMS eine Absendernummer oder einen Alpha sender. |
| Der Test scheitert mit einer Meldung von Telnyx zur Authentifizierung | Der API-Schlüssel ist vertippt, gelöscht oder abgelaufen. Legen Sie einen neuen an. |
| Nachrichten scheitern mit No SMS sender configured | Nur ein Messaging Profile ist eingestellt. Ergänzen Sie eine Absendernummer oder einen Alpha sender. |
| Nachrichten scheitern mit No WhatsApp sender configured | Füllen Sie WhatsApp-Nummer aus. |
| SMS ist in einer Kampagne nicht verfügbar | SMS ist unter Einstellungen → Benachrichtigungen → Kanäle ausgeschaltet oder hat keinen Anbieter. |
| Status kommen nie über Gesendet hinaus, oder Antworten kommen nicht an | Der Öffentliche Webhook-Schlüssel ist leer oder falsch: Der Abschnitt Aktivität auf der Seite von Telnyx zeigt Eingehende Nachricht abgelehnt. Prüfen Sie für Antworten auch die Inbound-Webhook-URL im Messaging Profile. |
| Empfänger können nicht antworten | Die Nachricht ging von einem Alpha sender aus. Ergänzen Sie eine Absendernummer. |
| WhatsApp-Nachrichten scheitern | Die Person hat Ihrer Nummer in den letzten 24 Stunden nicht geschrieben (siehe WhatsApp), oder die Nummer ist in Telnyx nicht für WhatsApp registriert. |
Gut zu wissen
- 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 Telnyx 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. API-Schlüssel und öffentlicher Schlüssel werden 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.