Your AI Connector Docs

SMS-Anbieter (Bring Your Own Twilio)

Diese Seite steuert das Twilio-Konto, das für die WhatsApp Business API verwendet wird. Standardmäßig läuft die WhatsApp Business API über das verwaltete Twilio-Konto der Plattform – Sie sehen Twilio nie und müssen sich nicht selbst bei Twilio anmelden. Wenn Sie Ihren eigenen Anthropic-Schlüssel (BYOK) verbunden haben, kosten verwaltete WhatsApp-Nachrichten über Twilio jeweils 0,05 Credits, sowohl eingehend als auch ausgehend. Bei allen anderen Konten sind diese Zustellkosten bereits durch Ihren KI-Credit-Tarif abgedeckt, sodass keine separate Gebühr pro Nachricht anfällt. (Die eigenen Nachrichtenpreise von WhatsApp ändern sich am 1. Oktober 2026 – siehe WhatsApp-Kosten & die Änderung im Oktober 2026.) Dies ist nur relevant, wenn Sie ausdrücklich möchten, dass die WhatsApp Business API über Ihr eigenes Twilio-Konto läuft.

Bei SMS gilt immer „Bring Your Own Twilio“. SMS-Regulierungen (A2P 10DLC, Markenregistrierung, Absender-ID-Genehmigung) müssen im Namen Ihres eigenen Unternehmens eingereicht werden, daher bietet die Plattform keine verwalteten SMS-Nummern an. Richten Sie SMS separat über die Karte SMS via Twilio unter Einstellungen → Kanäle ein (es gibt auch eine Option für ein Android-Telefon-SMS-Gateway). Diese Seite – die Karte Twilio-Konto – steuert das WhatsApp Business API-Konto und ändert Ihre SMS-Nummer nicht.

Warum sollte ich die WhatsApp Business API auf mein eigenes Twilio umstellen?

Die meisten Benutzer sollten dies nicht tun. Das verwaltete Konto ist einfacher:

  • Die Anmietung von WhatsApp-Nummern, das Einreichen von Vorlagen, die Absenderregistrierung und der Status der Nummern werden komplett für Sie erledigt. Eine hier gemietete Nummer kostet mindestens 50 Credits pro Monat, und diese Miete beinhaltet die WhatsApp-Verbindung – siehe Telefonnummern.
  • Es gibt keine separate Twilio-Rechnung. Wenn Sie Ihren eigenen Anthropic-Schlüssel (BYOK) verbunden haben, kosten verwaltete WhatsApp-Nachrichten über Twilio jeweils 0,05 Credits, sowohl eingehend als auch ausgehend. Bei allen anderen Konten sind diese Zustellkosten bereits durch Ihren KI-Credit-Tarif abgedeckt, sodass keine separate Gebühr pro Nachricht anfällt. Siehe WhatsApp-Kosten & die Änderung im Oktober 2026 für die WhatsApp-Preisänderung, die am 1. Oktober 2026 in Kraft tritt.
  • Der Support kann Ihnen direkt bei der Fehlerbehebung von Zustellungsproblemen helfen.

Sie möchten möglicherweise Ihr eigenes Twilio verwenden, wenn:

  • Sie haben bereits ein bestehendes Twilio-Konto mit genehmigten WhatsApp-Vorlagen und aufgewärmten Nummern, die Sie weiterhin verwenden möchten.
  • Ihr Unternehmen hat aus Beschaffungs- oder Compliance-Gründen die Anforderung, Twilio direkt zu bezahlen.
  • Sie möchten volle Transparenz über die zugrunde liegende Nutzung und Preisgestaltung auf Netzbetreiberebene.

Das Beibehalten einer aufgewärmten Nummer ist eine Aufgabe in zwei Schritten. Das Umstellen des Kontos (siehe unten) ändert nur, über welches Twilio-Konto wir senden. Ihre bestehende WhatsApp-Nummer erscheint erst als Kanal, wenn Sie sie auch verknüpfen – siehe Verknüpfen einer WhatsApp-Nummer, die Sie bereits besitzen. Führen Sie diese Schritte in dieser Reihenfolge aus.

Wie man wechselt

So gelangen Sie dorthin: Einstellungen → Gruppe Kanäle → Kanäle, suchen Sie dann die Karte Twilio-Konto.

Was Sie sehen, hängt von Ihrer aktuellen Einrichtung ab:

Wenn Sie das verwaltete Konto nutzen (Standard)

Sie sehen eine kurze Erklärung und eine Verwalten-Schaltfläche auf der Twilio-Konto-Karte. Ein Klick darauf öffnet das Formular Zu Ihrem eigenen Twilio-Konto wechseln, in dem Sie nach Ihrer Twilio Account SID und Ihrem Auth Token gefragt werden – mit der Warnung vor der destruktiven Aktion direkt im Dialogfeld.

Bevor Sie bestätigen, lesen Sie die Warnhinweise sorgfältig durch – der Wechsel ist destruktiv:

  • Alle Nummern, die Sie über die Plattform gekauft haben, werden dauerhaft freigegeben. Wenn Sie eine Nummer behalten möchten, lassen Sie sie im verwalteten Konto (nicht wechseln) oder kaufen/portieren Sie sie zuerst in Ihr eigenes Twilio.
  • Genehmigte WhatsApp-Vorlagen werden nicht übertragen. Vorlagen gehören zu dem WhatsApp Business-Konto, dem der Absender gehört – Sie müssen sie in Ihrem eigenen Konto erneut einreichen und auf die erneute Genehmigung warten.
  • Bestehende Chats und Nachrichtenverläufe bleiben sichtbar, aber neue Antworten auf freigegebene Nummern schlagen fehl (die Nummer ist weg).
  • Sie können später zurückwechseln, erhalten dann aber ein neues verwaltetes Konto ohne Nummern und ohne Vorlagen – Ihre alten kommen nicht zurück.

Wo Sie Ihre Account SID und Ihr Auth Token finden: Melden Sie sich in der Twilio-Konsole unter console.twilio.com an. Beide befinden sich auf dem Haupt-Dashboard im Bereich „Account Info“. Die Account SID beginnt mit AC und ist 34 Zeichen lang.

Nachdem Sie beide Werte eingegeben und bestätigt haben, führt das System folgende Schritte aus:

  1. Überprüft, ob die Anmeldedaten funktionieren.
  2. Gibt jede verwaltete Telefonnummer von Twilio frei.
  3. Schließt das verwaltete Unterkonto.
  4. Speichert Ihre Anmeldedaten, sodass alle zukünftigen ausgehenden WhatsApp-Nachrichten Ihr Konto verwenden. Ihre separat verbundene SMS via Twilio-Nummer wird unabhängig gespeichert und durch diesen Wechsel weder freigegeben noch geändert.

Dies kann von wenigen Sekunden bis zu einigen Minuten dauern, wenn Sie mehrere Nummern hatten.

Wenn Sie bereits Ihr eigenes Twilio-Konto verwenden

Die Karte zeigt Ihr verbundenes Konto an und ermöglicht es Ihnen, zur verwalteten Einrichtung zurückzukehren.

Ein Wechsel zurück zur verwalteten Einrichtung erstellt ein neues verwaltetes Unterkonto. Wie oben erwähnt: Dies stellt die Nummern oder Vorlagen, die Sie zuvor hatten, nicht wieder her – Sie fangen bei Null an.

Verknüpfen einer WhatsApp-Nummer, die Sie bereits besitzen

Sobald das Konto über Ihr eigenes Twilio läuft, ändert sich die Funktion der Schaltfläche WhatsApp verbinden auf der Karte WhatsApp Business API: Die verwaltete Option wird zu Über Ihr Twilio-Konto, wodurch ein WhatsApp-Absender innerhalb des von Ihnen verbundenen Twilio-Kontos hinzugefügt wird, und der Kauf einer verwalteten Nummer wird nicht mehr angeboten. Das ist beabsichtigt – der Kauf einer Nummer oder die Durchführung der Meta-Anmeldung würde neben Ihrem eigenen ein zweites, von der Plattform verwaltetes Twilio-Konto erstellen, und Ihre Nachrichten würden dann von einem Konto gesendet werden, während die Nummer im anderen liegt.

Bevor Sie beginnen

Ihre Nummer muss bereits ein funktionierender WhatsApp-Absender innerhalb Ihres eigenen Twilio-Kontos sein:

  • Sie ist in Twilio als WhatsApp-Absender registriert und mit Ihrem eigenen WhatsApp Business-Konto verknüpft.
  • Twilio zeigt diesen Absender als Online an.

Dieser Bildschirm registriert nichts. Er erstellt keinen Absender, kommuniziert nicht mit Meta und reicht Ihre Nummer nicht zur Genehmigung ein – er verbindet einen Absender, der bereits funktioniert. Wenn Sie noch keinen haben, führen Sie zuerst die WhatsApp-Absender-Einrichtung in Twilio durch.

Schritte

  1. Gehen Sie zu Einstellungen → Gruppe Kanäle → Kanäle.
  2. Klicken Sie auf der Karte WhatsApp Business API auf Absender verknüpfen.
  3. Geben Sie die WhatsApp-Nummer im internationalen Format ein (zum Beispiel +31612345678), genau so, wie sie beim Absender in Twilio erscheint.
  4. Vergeben Sie optional eine Bezeichnung – einen Namen für die Nummer innerhalb der App. Wenn Sie das Feld leer lassen, wird der Name aus Ihrem Twilio-Absenderprofil verwendet.
  5. Klicken Sie auf Absender verknüpfen.

Sie müssen Ihre Account SID oder Ihr Auth-Token nicht erneut eingeben: Wir haben diese bereits durch den Kontowechsel.

Was im Hintergrund passiert

  1. Wir suchen den Absender für diese Nummer in Ihrem Twilio-Konto und prüfen, ob Twilio sie als online führt.
  2. Wir stellen sicher, dass ein Messaging-Dienst in Ihrem Konto existiert, und leiten dessen eingehenden Webhook auf uns um (falls Sie noch keinen haben, erstellen wir einen, der nach der App benannt ist). Dies ist auch die Voraussetzung dafür, dass der Vorlagenversand funktioniert.
  3. Wir verknüpfen Ihren Absender mit diesem Messaging-Dienst.
  4. Wir leiten den eigenen Webhook des Absenders auf uns um, damit eingehende Nachrichten hier ankommen.
  5. Die Nummer erscheint in Ihrer Nummernliste, markiert als Ihr Twilio (BYO), und ist bereit, einer Kampagne oder einem Agenten zugewiesen zu werden.

Ihre genehmigten Vorlagen bleiben genau dort, wo sie sind: in Ihrem eigenen Konto. Es wird nichts neu eingereicht und nichts freigegeben.

Kosten

Für eine auf diese Weise verknüpfte Nummer fallen keine monatlichen Wartungsgebühren an – Sie bezahlen Twilio direkt für die Nummer und die Gebühren pro Nachricht. KI-Antworten verbrauchen weiterhin wie gewohnt Credits.

Wenn es nicht funktioniert

  • „No WhatsApp sender for … exists in your Twilio account“ — die Nummer ist dort nicht als WhatsApp-Absender registriert oder wurde anders eingegeben. Überprüfen Sie die genaue Absender-ID in der Twilio-Konsole und geben Sie sie erneut im internationalen Format ein.
  • „The WhatsApp sender … is not online in Twilio“ — der Grund von Twilio ist in der Nachricht enthalten. Beheben Sie das Problem zuerst in Twilio; das Hinzufügen eines Absenders, der in Twilio offline ist, würde später nur zu einem stillen Fehler führen.
  • „… is already connected to another account“ — die Nummer ist hier mit einem anderen Konto verknüpft. Trennen Sie sie dort zuerst.
  • „This account is still on the managed Twilio account“ — führen Sie zuerst den oben genannten Wechsel durch.
  • „we could not update its webhook in Twilio“ — die Nummer ist verbunden und wird Nachrichten senden, aber der Absender verweist weiterhin auf den Webhook, den Sie dort konfiguriert hatten. Löschen Sie diesen Webhook für den Absender in der Twilio-Konsole, damit eingehende Nachrichten uns erreichen.

Grenzwerte

  • Sie können den Anbieter höchstens alle 24 Stunden wechseln. Dies verhindert, dass wiederholte Wechsel Twilio-API-Kosten und Ratenbegrenzungen in die Höhe treiben.
  • Der SMS-Versand ist von dieser Einstellung völlig unberührt – wenn Sie bereits Ihr eigenes Twilio über die Karte SMS via Twilio verbunden haben, handelt es sich um eine andere Verbindung, die unabhängig von Ihren Aktionen hier bestehen bleibt.

Was ist, wenn etwas schiefgeht?

  • “Could not authenticate with the provided Twilio credentials” — überprüfen Sie die SID (beginnt mit AC, 34 Zeichen) und das Auth-Token. Beide unterscheiden zwischen Groß- und Kleinschreibung.
  • “Account is not active” — das Twilio-Konto, das Sie verwenden möchten, ist gesperrt oder geschlossen. Verwenden Sie ein aktives Konto.
  • “Please wait Xh before switching again” — Sie befinden sich innerhalb der 24-stündigen Wartezeit. Bitte warten Sie diese ab.
  • Teilweise Migration (einige Nummern freigegeben, andere nicht) — führen Sie den Wechsel erneut aus. Das System ist idempotent; es setzt dort fort, wo es aufgehört hat, und schließt die Freigabe aller noch im verwalteten Unterkonto befindlichen Nummern ab.

Wenn Sie nach dem Wechsel Probleme haben – ausgehende Nachrichten werden nicht gesendet, Vorlagen erscheinen nicht –, kontaktieren Sie den Support mit Ihrer Account SID (niemals mit dem Auth Token).

Benötigen Sie Hilfe?

If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.