VoIP-Anbieter verbinden

Verbinden Sie einen Anbieter, den Sie bereits nutzen (Twilio oder Telnyx per API-Schlüssel; SignalWire, Vonage, Plivo oder jeden SIP-Trunk über SIP), oder eröffnen Sie mit geführter Einrichtung ein neues Telnyx-Konto.

Produktivverkehr sollte über Nummern laufen, die Ihnen gehören und von Ihrem eigenen VoIP-Anbieter bereitgestellt werden. Die Seite Connections → VoIP (/dashboard/voip-connections) im Dashboard verbindet Ihr Anbieter-Konto; nach dem Verbinden importieren Sie Nummern, die eingehende und ausgehende Anrufe unterstützen.

Klicken Sie auf Neue Verbindung und wählen Sie einen von zwei Wegen: Einen bereits verwendeten Anbieter verbinden oder Ein neues Telnyx-Konto einrichten.

Verbinden Sie einen Anbieter, den Sie bereits nutzen#

Wählen Sie den Anbieter aus, bei dem sich Ihre Nummern befinden:

Fügen Sie für Twilio und Telnyx die Zugangsdaten ein und klicken Sie auf Verbinden & testen. ThunderPhone überprüft sie und konfiguriert die Anbieter-Seite für Sie. Für Telnyx fügt ThunderPhone Ihrem Telnyx-Konto eine eigene SIP-Verbindung hinzu (mit dem Namen thunderphone-production-<org>-outbound-<id>) und führt ausgehende Anrufe darüber aus, sodass Telnyx Ihnen diese Anrufe in Rechnung stellt. Es verwendet das ausgehende Sprachprofil der Telnyx-Verbindung, auf der sich Ihre Nummern befinden, sodass die zulässigen Länder und Ausgabenlimits dieses Profils gelten. Wenn diese Verbindung kein ausgehendes Sprachprofil hat und Ihr Konto genau ein aktiviertes Profil hat, verwendet ThunderPhone dieses. Um ein anderes zu verwenden, weisen Sie es der Verbindung im Telnyx-Portal zu und speichern Sie die ThunderPhone- Verbindung erneut. Wenn das Konto kein aktiviertes Profil oder mehrere hat, weisen Sie der Verbindung im Telnyx-Portal eines zu und speichern Sie die ThunderPhone-Verbindung erneut. Bis dahin schlagen ausgehende Anrufe mit outbound_trunk_unavailable fehl; eingehende Anrufe funktionieren weiterhin.

Wenn Telnyx einen ausgehenden Anruf ablehnt (z. B. SIP 403 Forbidden), stammt die Ablehnung von Ihrem eigenen Telnyx-Konto. Die üblichen Ursachen sind kein verfügbares Guthaben, eine Anrufernummer, die nicht zu diesem Telnyx-Konto gehört, oder ein ausgehendes Sprachprofil, das das Zielland nicht zulässt.

SIP-Einrichtung für SignalWire, Vonage und Plivo#

Diese drei öffnen das manuelle SIP-Formular mit den Schritten für den jeweiligen Anbieter oben, einem Link zum eigenen Einrichtungsleitfaden des Anbieters und einer Beispiel-SIP-Domain:

• SignalWire: Erstellen Sie SIP-Zugangsdaten für ausgehende Anrufe, geben Sie die SIP-Domain, den Benutzernamen und das Passwort ein und weisen Sie jeder Nummer ein SWML-Skript zu, das eingehende Anrufe mit dem ThunderPhone-SIP-Endpunkt verbindet.
• Vonage: Erstellen Sie im SIP-Trunking-Dashboard einen Trunk mit Zugangsdaten für ausgehende Anrufe, geben Sie dessen Domain (z. B. your-trunk.sip-us.vonage.com) und die Zugangsdaten ein, fügen Sie den ThunderPhone-SIP-Endpunkt als eingehende SIP-URI des Trunks hinzu und verknüpfen Sie Ihre Nummern mit dem Trunk.
• Plivo: Erstellen Sie einen ausgehenden Trunk mit Zugangsdaten und geben Sie dessen Termination SIP Domain (<trunk-id>.zt.plivo.com), Benutzernamen und Passwort ein; erstellen Sie einen eingehenden Trunk, dessen Primary URI der ThunderPhone-SIP-Endpunkt gefolgt von ;transport=tcp ist; legen Sie dann den Anwendungstyp jeder Nummer auf diesen Trunk fest.

Das Ergebnis ist eine manuelle SIP-Verbindung (provider: "manual" in der API), die genau wie eine manuell eingegebene getestet und verifiziert wird. Die Verbindungskarte zeigt den Namen des Anbieters an, zum Beispiel SignalWire · SIP.

Neues Telnyx-Konto einrichten#

Noch kein Anbieter? Der geführte Ablauf führt Sie durch die Erstellung eines Telnyx-Kontos und dessen Verbindung:

1. Konto erstellen

   Klicken Sie auf Telnyx-Anmeldung öffnen, erstellen Sie Ihr Konto und markieren Sie „Ich habe mein Konto erstellt.“

2. API-Schlüssel abrufen

   Klicken Sie auf Seite für API-Schlüssel öffnen, erstellen Sie einen Schlüssel und fügen Sie ihn in API Key (v2) ein. Sie können die Verbindung optional benennen.

3. Verbinden und testen

   Klicken Sie auf Verbinden und testen — ThunderPhone überprüft die Zugangsdaten und richtet vor dem Speichern auf der Telnyx-Seite alles Notwendige ein.

Was ThunderPhone in Telnyx einrichtet#

Sofern Sie keine eigene Connection ID eingeben, hinterlassen beide Telnyx-Wege (geführte Einrichtung und Einfügen eines API-Schlüssels) dasselbe in Ihrem Telnyx-Konto: eine SIP-Verbindung namens thunderphone-<your organization id>. Es handelt sich um eine FQDN-Verbindung, deren FQDN-Eintrag auf den SIP-Endpunkt von ThunderPhone verweist und der jede von Ihnen importierte Nummer zugewiesen wird. Telnyx sendet Anrufe für diese Nummern direkt über SIP an ThunderPhone.

• Die Webhook-Felder sind absichtlich leer. Es sind kein Webhook, keine Call-Control-Anwendung, keine TeXML-Anwendung und kein registriertes SIP-Telefon beteiligt.
• Verschieben Sie importierte Nummern nicht in eine andere Verbindung oder Anwendung und registrieren Sie kein Gerät dafür.
• Wenn Sie beim Verbinden eine eigene Connection ID eingegeben haben, verwendet ThunderPhone stattdessen diese Verbindung und ändert sie niemals; sie muss eine FQDN-Verbindung sein, die auf den SIP-Endpunkt von ThunderPhone verweist.

Vor dem 30. August 2026 war die von ThunderPhone erstellte Verbindung thunderphone-… eine Credential-Verbindung, die keine Anrufe empfangen kann. Wenn Ihre Verbindung weiterhin als Credential-Verbindung angezeigt wird, wenden Sie sich an den Support, damit wir sie umstellen können.

Manuelle SIP-Konfiguration#

Die Kacheln für SignalWire, Vonage und Plivo öffnen dieses Formular, ebenso wie Ich gebe alle Einstellungen selbst ein unter Anderer Anbieter. Jeder SIP-Trunk funktioniert, einschließlich DIDWW oder einer selbst betriebenen PBX. Geben Sie den Verbindungsnamen, die SIP-Domain / URI, optionalen Benutzernamen und das Passwort, den Port und das Transportprotokoll ein; Erweiterte Einstellungen fügt Medienverschlüsselung (SRTP) hinzu. Das Formular zeigt auch die SIP- Adresse, an die Ihr Trunk eingehende Anrufe senden muss: sip.thunderphone.com, über Port 5060 für UDP oder TCP beziehungsweise 5061 für TLS. Über TLS bleibt die SIP- Signalisierung bis zu LiveKit Cloud verschlüsselt, wo ThunderPhone den Anruf verarbeitet; Audio läuft niemals über sip.thunderphone.com, daher funktioniert SRTP wie bisher. Adressieren Sie jeden Anruf an die gewählte Nummer im E.164-Format, wobei dieselbe Nummer einschließlich des + sowohl in der Anfragezeile als auch im To-Header stehen muss, zum Beispiel sip:+14155550142@sip.thunderphone.com. Das + ermöglicht es ThunderPhone, den Anruf in der richtigen Region zu verarbeiten (siehe den Hinweis unter IP-Zulassungslisten). Zuvor mit einer Adresse <your-project>.sip.livekit.cloud eingerichtete Trunks funktionieren weiterhin, solange Zulässige Quell-IP-Adressen leer ist; Sie müssen sie nicht ändern. ThunderPhone wandelt diese Einstellungen in ein dediziertes Paar von SIP-Trunks in LiveKit Cloud um: Ausgehende Anrufe von den Nummern der Verbindung werden mit Ihren Zugangsdaten an Ihre SIP-Domain geleitet, und eingehende Anrufe an diese Nummern werden von jeder Adresse akzeptiert, sofern Sie das optionale Feld Zulässige Quell-IP-Adressen nicht ausfüllen. Füllen Sie es nur aus, wenn Ihr Anbieter feste Signalisierungs-IP-Adressen veröffentlicht: Eine falsche oder unvollständige Liste führt dazu, dass ThunderPhone eingehende Anrufe Ihres Anbieters ablehnt. Zwei Schaltflächen übernehmen die Hauptarbeit:

• KI-Einrichtungsanleitung generieren — erstellt anbieterspezifische Anweisungen für die erforderliche Trunk-seitige Konfiguration.
• Verbindung testen und speichern — prüft, ob der SIP-Endpunkt zu einer öffentlichen Adresse aufgelöst wird und bei TCP/TLS eine Verbindung am gewählten Port akzeptiert (UDP-Hosts erhalten nur die DNS-Prüfung), und speichert anschließend. Ein Anruf kann noch nicht getätigt werden, da die Verbindung keine Nummern hat; der tatsächliche Nachweis erfolgt beim Import (unten).

Wenn Sie eine Verbindung später bearbeiten, führt ThunderPhone dieselbe Prüfung mit Ihren geänderten Einstellungen erneut aus, bevor etwas gespeichert wird, erstellt dann den Trunk neu und verifiziert jede Nummer der Verbindung im Hintergrund erneut mit einem kurzen Testanruf — die Nummern werden als Bereitstellung angezeigt, bis ihr Testanruf erfolgreich ist. Das Ändern nur der Zulässigen Quell-IP-Adressen bei einer Verbundenen Verbindung ist anders: Es wirkt sich nie auf ausgehende Anrufe aus, daher aktualisiert ThunderPhone die Liste auf dem eingehenden Trunk sofort und die Nummern bleiben Aktiv. Ihr Test für eingehende Anrufe wird auf nicht getestet zurückgesetzt; führen Sie ihn erneut aus oder tätigen Sie einen echten Anruf über Ihren Anbieter, um zu bestätigen, dass die neue Liste Anrufe durchlässt. Der Test schlägt fehl, wenn sein Anruf aufgrund der Liste abgelehnt würde. Gespeicherte Passwörter werden niemals erneut angezeigt; lassen Sie das Passwort leer, um es beizubehalten, oder aktivieren Sie „Gespeichertes Passwort entfernen“ für einen IP-authentifizierten Trunk.

IP-Positivlisten und Trunk-Authentifizierung#

Einige Anbieter (DIDWW, Telnyx-Verbindungen mit IP-Authentifizierung, die meisten PBXs hinter einer Firewall) akzeptieren SIP-Datenverkehr nur von IP-Adressen, die Sie auf eine Zulassungsliste setzen, oder authentifizieren ausgehende Anrufe anhand der Quell-IP. ThunderPhone verwendet zwei Gruppen von Adressen.

SIP-Edge. Eingehende Anrufe, die Sie an sip.thunderphone.com senden, laufen über die SIP-Edge von ThunderPhone, die nur die SIP-Signalisierung verarbeitet. Das erste INVITE geht an sip.thunderphone.com; die restliche Signalisierung des Anrufs (ACK, Auflegen, Weiterleitungen) erfolgt zwischen Ihrem Anbieter und dem Edge-Server, der den Anruf entgegengenommen hat, sip-1 oder sip-2. Wenn Ihre Firewall die SIP-Signalisierung filtert, geben Sie alle drei für UDP- und TCP-Port 5060 sowie TLS-Port 5061 frei:

LiveKit Cloud. Das Audio (RTP) jedes Anrufs und die SIP-Signalisierung ausgehender Anrufe laufen zwischen Ihrem Anbieter und LiveKit Cloud, niemals über die SIP-Edge. Geben Sie jeden unten aufgeführten Bereich sowohl für die SIP-Signalisierung als auch für Medien frei:

LiveKit verwendet diese Bereiche für Realtime, SIP-Signalisierung und Medien sowie Webhooks. Sie decken Anrufe ab, die in den Regionen Kanada, EU, Indien, Japan und USA verarbeitet werden. Regionsnamen für einen festgelegten Endpunkt: canada, eu, india, japan, us.

Einige grundlegende Regeln für den Trunk selbst:

• ThunderPhone registriert sich nicht. Es sendet niemals SIP REGISTER an Ihren Anbieter. Konfigurieren Sie den Trunk daher für IP-basierte und/oder Zugangsdaten-Authentifizierung (Benutzername + Passwort), nicht für Registrierung.
• Ausgehende Anrufe sollten Zugangsdaten verwenden. Aktivieren Sie die Benutzername-/Passwort-Authentifizierung auf Anbieterseite und geben Sie dieselben Werte im manuellen SIP-Formular ein. Betrachten Sie die IP-Zulassungsliste als zweite Ebene, nicht als einzige — ausgehende Anrufe an Ziele außerhalb der abgedeckten Regionen können von anderen Adressen ausgehen.
• Eingehend ist die umgekehrte Richtung. Im optionalen Feld Zulässige Quell- IP-Adressen des Formulars geben Sie die Signalisierungsadressen Ihres Anbieters ein, sodass ThunderPhone nur Anrufe von diesen akzeptiert. Geben Sie IP- Adressen oder CIDR-Bereiche ein; Hostnamen werden nie abgeglichen. Lassen Sie das Feld leer, sofern Ihr Anbieter keine feste Liste veröffentlicht. ThunderPhone prüft die Liste bei jedem eingehenden Anruf anhand der Adresse, die seine SIP-Edge sieht. Senden Sie Ihre Anrufe daher nach dem Festlegen der Liste an sip.thunderphone.com. Ein Anruf von einer Adresse, die nicht auf der Liste steht, oder ein Anruf, der direkt an eine <your-project>.sip.livekit.cloud-Adresse gesendet wird, wird abgewiesen: Er schlägt fehl oder wird verbunden und sofort beendet.

Die Bereiche werden von LiveKit unter Regionen, regionale Endpunkte und statische IPs veröffentlicht; ThunderPhone prüft diese Seite wöchentlich und aktualisiert diese Anleitung, wenn sie sich ändert.

Nach dem Verbinden#

Importieren Sie Nummern über Telefonnummern → Nummer hinzufügen → VoIP-Anbieter verbinden (oder direkt über die Verbindung). Jede importierte Nummer wird verifiziert, bevor sie aktiv wird. Bei einer manuellen SIP-Verbindung führt diese Verifizierung einen kurzen Testanruf (einige Sekunden) von Ihrer Nummer über Ihren SIP-Trunk zu einer ThunderPhone-Nummer durch — dadurch werden Benutzername, Passwort, Transport und das ausgehende Routing Ihres Anbieters tatsächlich getestet. Ihr Anbieter rechnet diesen Anruf wie jeden anderen ab. Wenn der Anbieter ihn ablehnt, bleibt die Nummer in Bereitstellung, und die Seite für Telefonnummern zeigt die Antwort des Anbieters an (zum Beispiel „ThunderPhone-Anmeldedaten abgelehnt (SIP 401)“); korrigieren Sie die Verbindung und verifizieren Sie sie erneut. Wenn Ihr Anbieter den Trunk akzeptiert, sein Routingplan jedoch ThunderPhones Testnummer nicht abdeckt (DIDWW antwortet „Zielnummer durch Routingplan gesperrt“), wird die Nummer als Verifiziert · Anbieter akzeptiert angezeigt: Sie ist nutzbar, aber Anrufe zu anderen Zielen wurden nicht getestet. Dieser Anruf belegt, dass Ihr Trunk Anrufe als diese Nummer tätigen kann; er belegt nicht, dass Ihnen die Nummer gehört, und testet keine Anrufe an die Nummer; das übernimmt der optionale eingehende Test unten. Verifizierte Nummern unterstützen eingehende und ausgehende Anrufe — damit werden ausgehende Kampagnen und programmatische ausgehende Anrufe freigeschaltet.

Test eingehender Anrufe#

Nummer überprüfen öffnet einen Dialog, der auch eingehende Anrufe testen kann. Der Test ruft Ihre Nummer an, prüft, ob der Anruf ThunderPhone erreicht, und legt dann auf, ohne Ihren Agenten zu starten:

• Nummern mit eigenem ausgehendem SIP-Trunk (manuelle SIP-Nummern und Twilio-Nummern, sobald ThunderPhone ausgehende Anrufe in Ihrem Twilio-Konto eingerichtet hat) rufen zunächst sich selbst an: ThunderPhone wählt die Nummer von der Nummer aus über diesen Trunk. Der Dialog informiert Sie, bevor der Anruf getätigt wird. Der Anruf wird über Ihren Anbieter geführt und gelangt bei korrektem eingehenden Routing direkt zurück zu ThunderPhone. Wenn er unter der eigenen Anrufer-ID der Nummer zurückkommt, belegt dieser eine Anruf sowohl, dass Ihr Anbieter Anrufe von ThunderPhone als diese Nummer akzeptiert, als auch, dass Anrufe an die Nummer ThunderPhone erreichen – in jedem Land. Einige Anbieter lehnen einen Anruf von einer Nummer an sich selbst ab oder verbinden ihn nicht; das sagt nichts über Ihr Routing aus. In diesem Fall ruft ThunderPhone stattdessen von einer eigenen Nummer an. Wenn Ihre Nummer an ein anderes Ziel weiterleitet, kann dieses Telefon zweimal klingeln: zuerst mit der eigenen Anrufer-ID der Nummer, dann mit der Testnummer von ThunderPhone.
• Andere Nummern (und der oben beschriebene Fallback) werden von einer eigenen Nummer von ThunderPhone angerufen. ThunderPhone kann diese Anrufe derzeit nur an US-amerikanische und kanadische Nummern tätigen; bei anderen Nummern meldet der Test, dass er nicht ausgeführt werden konnte, einschließlich der Antwort Ihres Anbieters, falls der Selbstanruf abgelehnt wurde.

Wenn Ihr Anbieter die Anrufer-ID unterwegs ändert, kann ThunderPhone den Anruf nicht erkennen, sodass Ihr Agent ihn möglicherweise kurz entgegennimmt. Der Test eingehender Anrufe ist optional. Überspringen Sie ihn, funktioniert die Nummer trotzdem; auf der Telefonnummern-Seite wird dann Eingehend nicht getestet angezeigt, und Sie können ihn später mit Testen oder dem Menüpunkt Eingehende Anrufe testen der Nummer ausführen. Direkt nach einem Import fordert die Telefonnummern-Seite Sie auch auf, eingehende Anrufe für die neuen Nummern zu testen. Es wird nichts gewählt, bis Sie im Dialog bestätigen.

Wenn Ihr Anbieter die Nummer an ein anderes Ziel sendet, kann es dort pro Anruf bis zu 8 Sekunden klingeln, bevor ThunderPhone auflegt. Wenn etwas vorher antwortet (eine Twilio-App, die antwortet und dann weiterleitet, ein Telefonmenü), wartet der Test darauf, dass der weitergeleitete Anruf ThunderPhone erreicht: bis zu 8 Sekunden beim Selbstanruf und 15 Sekunden bei einem Anruf von einer ThunderPhone-Nummer. Das Ergebnis bleibt bei der Nummer (Eingehend bestanden oder fehlgeschlagen), bis Sie die Verbindung ändern oder die Nummer erneut importieren; dadurch wird es auf nicht getestet zurückgesetzt. Beim Ändern einer Verbindung werden ausgehende Anrufe im Hintergrund erneut überprüft, Ihre Nummer wird jedoch niemals ohne Ihre Aufforderung angerufen.

Fehlerbehebung bei eingehenden Anrufen#

Die Schaltfläche Test der Verbindung prüft die Zugangsdaten, und die Verifizierung prüft ausgehende Anrufe. Um eingehende Anrufe zu prüfen, führen Sie den obigen Test für eingehende Anrufe aus oder rufen Sie die Nummer von einem Telefon aus an und suchen Sie den Anruf in der Anrufhistorie. Talk-Tests im Browser und Bot-zu-Bot-Simulationen laufen nicht über Ihren Anbieter und zeigen daher nicht, ob eingehende Anrufe funktionieren. Eine Simulation, die auf die Telefonnummer ausgerichtet ist (SIP-Loopback), wählt sie hingegen über Ihren Anbieter an. Wird sie angenommen, prüft dies die Weiterleitung eingehender Anrufe.

• Sie hören die Ansage Ihres Mobilfunkanbieters (zum Beispiel „Willkommen bei Verizon“ oder „Die von Ihnen gewählte Nummer ist nicht vergeben“): Der Anruf ist fehlgeschlagen, bevor er ThunderPhone erreicht hat. Prüfen Sie, ob die Nummer in Ihrem Anbieter-Konto aktiv und der ThunderPhone-Verbindung oder dem Trunk zugewiesen ist.
• Besetztzeichen oder der Anruf klingelt aus: Der Anbieter hat den Anruf angenommen, konnte ihn jedoch nicht zustellen. Prüfen Sie bei Telnyx die Verbindung der Nummer im Telnyx-Portal: Es sollte die oben beschriebene FQDN-Verbindung thunderphone-… sein oder Ihre eigene FQDN-Verbindung, die auf den ThunderPhone-SIP-Endpunkt verweist. Bei Twilio sollte die Nummer dem ThunderPhone-SIP-Trunk und nicht einem Voice-Webhook oder einer TwiML-App zugeordnet sein.
• Die Protokolle Ihres Anbieters zeigen 404 No trunk found (manuelles SIP): Der Anruf hat ThunderPhone erreicht, aber keinem Trunk entsprochen. Prüfen Sie, ob die Nummer in diese Verbindung importiert wurde und der Trunk auf sip.thunderphone.com verweist. Wenn er auf eine <your-project>.sip.livekit.cloud-Adresse verweist, müssen Zulässige Quell-IP-Adressen leer sein: Bei gesetzter Liste werden nur Anrufe akzeptiert, die an sip.thunderphone.com gesendet werden.
• 404 Not Found von sip.thunderphone.com (manuelles SIP): Der Anruf war nicht an eine Telefonnummer adressiert, oder die Anfragezeile und der To-Header enthalten unterschiedliche Nummern. Senden Sie die gewählte Nummer wie oben in beiden.
• 403 Forbidden von sip.thunderphone.com: Die Anfragezeile enthält einen anderen Host. Adressieren Sie den Anruf an sip.thunderphone.com, zum Beispiel sip:+14155550142@sip.thunderphone.com.
• Der Anruf erreicht ThunderPhone, aber der falsche Agent antwortet oder niemand: Prüfen Sie den Agenten für eingehende Anrufe der Nummer unter Telefonnummern.

Der Copilot in der App kann eine Nummer für Sie prüfen: Fragen Sie ihn, warum Anrufe an die Nummer fehlschlagen. Bei Telnyx-Verbindungen ermittelt er außerdem schreibgeschützt und für Organisationsadministratoren, welcher Verbindung Telnyx die Nummer zuweist.

Nächste Schritte#