SMS mit Twilio

Der SMS-Kanal verwendet Twilio Messaging: Eingehende Nachrichten und Zustell-Callbacks kommen per Webhook, ausgehende Nachrichten verwenden Twilios REST-API.

Voraussetzungen

• Twilio Account SID (AC gefolgt von 32 Hexadezimalzeichen);
• eine SMS-fähige from_number im E.164-Format;
• API Key SID (SK gefolgt von 32 Hexadezimalzeichen);
• API Key Secret für ausgehende REST-Aufrufe;
• Auth Token zur Prüfung von Twilio-Webhook-Signaturen; und
• eine öffentliche HTTPS-Callback-URL.

Aktuelle Nummern- und Webhook-Einrichtung finden Sie in der Twilio-Messaging-Dokumentation.

Im Dashboard verbinden

1. Öffnen Sie Dashboard → Kanal → Hinzufügen.
2. Wählen Sie SMS (Twilio).
3. Geben Sie Account SID, Absendernummer, API Key SID und Status-Callback-URL ein.
4. Ergänzen Sie API Key Secret und Auth Token.
5. Speichern Sie Zugangsdaten, prüfen Sie Richtlinie im CLI-Assistenten und konfigurieren Sie den eingehenden Webhook der Twilio-Nummer.

Aktivieren Sie gemeinsamen Anyy-Webhook-Listener und HTTPS-Proxy gemäß Nachrichtenplattformen. Die Callback-URL muss HTTPS verwenden und mit der Kontoroute enden:

https://YOUR_HOST/channels/sms/ACCOUNT_ID/webhook

Die Standard-Konto-ID ist twilio. Verwenden Sie dieselbe Route für eingehende Nachrichten und den konfigurierten Status-Callback.

Zugriffsrichtlinie

SMS verwendet standardmäßig open und unterstützt open, allowlist oder disabled. Wählen Sie SMS im interaktiven Assistenten anyy setup channel zum Ändern. Das Dashboard-Zugangsdatenformular bietet dies nicht; aktuelle Einrichtungsaktionen bearbeiten keine SMS-Listeneinträge. Kopplung ist nicht verfügbar; allowlist allein fügt keine erlaubte Nummer hinzu.

Telefonnummern sollten ins E.164-Format normalisiert werden, etwa +14155550123.

Endet HTTPS an einem Proxy auf demselben Host, leiten Sie über Loopback mit korrektem X-Forwarded-Proto: https und X-Forwarded-Host weiter. Dieser Adapter vertraut Weiterleitungs-URL-Headern nicht bei Nicht-Loopback-Verbindungen. Bewahren Sie ursprüngliche öffentliche URL und Formular-Body zur Signaturprüfung.

Zustellbelege

Twilio kann Zustellfortschritt an die Callback-URL melden. Ein erfolgreicher Anyy-Versand belegt zunächst Übergabe an den Anbieter; prüfen Sie späteren Beleg/Status vor Wiederholung einer ungewissen Nachricht.

SMS können direkte Kosten verursachen

Gebühren für eingehende, ausgehende, Netzbetreiber- und internationale Nachrichten hängen von Twilio-Konto und Ziel ab. Beschränken Sie Zugriff und testen Sie vor Automatisierung mit einer bekannten Nummer.

Die Verbindung prüfen

anyy channel doctor sms
anyy channel reload

Senden Sie eine eingehende SMS, bestätigen Sie die Absenderrichtlinie und testen Sie dann Antwort und Zustellstatus.

Fehlerbehebung

Problem	Prüfung
Twilio lehnt Callback-URL ab	Exakter HTTPS-Pfad /channels/sms/ACCOUNT_ID/webhook
Webhook-Signatur schlägt fehl	Auth Token und Proxy-Erhalt ursprünglicher URL/Body
Ausgehende API schlägt fehl	Account SID, API Key SID/Secret und Absendernummer-Fähigkeit
Absender ignoriert	DM-Richtlinie und E.164-Zulassungslistenwert
Status schreitet nie fort	Status-Callback-URL und Twilio-Zustellcallback-Konfiguration