Verbinden Sie eine Twilio-Nummer über SIP

Wenn Sie eine Twilio-Nummer als externe SIP-Nummer verbinden, kann Ihr Versafy Voice Agent Anrufe an diese Nummer beantworten und sie als Anrufernummer für ausgehende Anrufe verwenden. Dies ist nützlich, wenn Sie die Nummer und Anrufweiterleitung in Ihrem eigenen Twilio-Konto behalten möchten, während Sie Versafy als KI-Telefondienst verwenden.

Für die reguläre Twilio-Verbindung ohne externen SIP-Trunk verwenden Sie Verbinden Sie ein Twilio-Konto und eine Telefonnummer. Es unterstützt vollständige eingehende Abläufe mit Operatoren, Zeitplänen, Ankündigungen und Voicemail.

Dieses Setup unterstützt:

eingehende Anrufe von der Twilio-Nummer an einen Versafy Voice Agent;
einzelne ausgehende Anrufe von einem Voice Agent;
ausgehend Kampagnen, sofern für Ihren Arbeitsbereich verfügbar;
Anrufliste in Anrufprotokolle.

Einschränkung des externen SIP-Eingangsflusses: Eine externe SIP-Nummer kann nur einer aktiven zugewiesen werden Nur KI Eingehender Anrufablauf ohne Eskalation an einen Menschen. Wenn Anrufer Vermittlungsweiterleitung, Zweigstellen während der Geschäftszeiten, Ankündigungen oder Voicemail benötigen, verwenden Sie stattdessen die native Twilio-Verbindung von Versafy. Siehe Eingehende Anrufflüsse.

Bevor Sie beginnen

Bereiten Sie Folgendes vor:

ein Twilio-Konto mit der Berechtigung zum Kauf von Nummern und zur Verwaltung von Elastic SIP Trunks;
ein Twilio-Projekt oder Unterkonto, das sowohl die Nummer als auch den Trunk besitzt;
Berechtigung zum Verwalten von Telefonnummern und eingehenden Anrufflüssen in Versafy;
ein aktiver Sprachagent für eingehende und ausgehende Anrufe;
ein Passwort-Manager für den SIP-Trunk-Benutzernamen und das Passwort.

Twilio-Testkonten beschränken den Besitz von Telefonnummern und ausgehenden Zielen. Aktualisieren Sie das Twilio-Konto vor der produktiven Nutzung und überprüfen Sie es Einschränkungen für das Testkonto von Twilio .

Setup-Übersicht

Sie werden die Verbindung in dieser Reihenfolge herstellen:

Kaufen Sie eine sprachfähige Nummer in Twilio.
Erstellen Sie einen Twilio Elastic SIP Trunk.
Konfigurieren Sie die Trunks Kündigung Einstellungen für ausgehende Anrufe.
Beginnen Sie mit dem Import der Nummer in Versafy und kopieren Sie den eingehenden SIP-URI.
Fügen Sie diesen URI zum Trunk hinzu Entstehung Einstellungen für eingehende Anrufe.
Ordnen Sie die Twilio-Nummer dem Trunk zu.
Weisen Sie die externe SIP-Nummer einem AI Only Inbound Call Flow zu.
Testen Sie eingehende und ausgehende Anrufe.

1. Kaufen Sie eine sprachfähige Nummer in Twilio

Durch den Kauf einer dedizierten Nummer erhalten Kunden eine öffentliche Rufnummer und Ihr Sprachagent erhält eine zugelassene Anrufernummer für ausgehende Anrufe.

Melden Sie sich an Twilio-Konsole und wählen Sie das Projekt oder Unterkonto aus, das Sie verwenden möchten.
Offen Produkte & Dienstleistungen → Nummern & Absender → Telefonnummern.
Auswählen Richten Sie eine neue Telefonnummer ein.
Wählen Sie das Land und den Nummerntyp aus und fordern Sie dann die Nummer an Stimme Funktion in den Suchfiltern.
Wählen Sie eine Nummer aus, überprüfen Sie die wiederkehrenden Gebühren und Nutzungsgebühren von Twilio und schließen Sie den Kauf ab.
Vervollständigen Sie alle Identitäts-, Adress- oder behördlichen Registrierungsanfragen von Twilio für dieses Land und diesen Nummerntyp.
Kopieren Sie die gekaufte Nummer im internationalen E.164-Format, einschließlich + und der Ländercode – zum Beispiel +12025550123.

Die Benutzeroberfläche von Twilio kann je nach Konto variieren. Siehe Twilios aktueller Leitfaden zur Telefonnummerneinrichtung wenn die Beschriftungen in Ihrer Konsole unterschiedlich sind.

2. Erstellen Sie einen elastischen SIP-Trunk

Der Trunk ist die bidirektionale Verbindung zwischen Twilio und Versafy. Eine Seite leitet eingehende Anrufe an Ihren Voice Agent weiter; Mit der anderen Option kann der Voice Agent Anrufe über Ihr Twilio-Konto tätigen.

Öffnen Sie die Twilio-Konsole Produkte & Services → Elastic SIP Trunking → Verwalten → Trunks.
Auswählen Neuen Trunk erstellen.
Geben Sie einen erkennbaren ein Freundlicher Name, wie z Versafy Sales Line.
Bewahren Sie den Kofferraum auf.

Lassen Sie den Trunk in einem Browser-Tab geöffnet und Versafy in einem anderen. Twilios Leitfaden für elastisches SIP-Trunking erläutert die aktuellen Konsolenabschnitte und die Terminologie.

3. Konfigurieren Sie die Twilio-Terminierung für ausgehende Anrufe

Durch die Terminierung kann Versafy einen Anruf an Twilio senden, das ihn dann mit der Zielnummer des Kunden verbindet.

Öffnen Sie den neuen Kofferraum Kündigung Abschnitt.
Schaffen Sie ein Unikat Beendigungs-SIP-URI, wie z versafy-sales.pstn.twilio.com.
Kopieren Sie den vollständigen Hostnamen. Sie werden es später ohne in Versafy eingeben sip: oder ein Hafen.
In Authentifizierung, erstellen Sie eine Anmeldeliste.
Fügen Sie der Liste einen neuen SIP-Benutzernamen und ein sicheres, eindeutiges Passwort hinzu.
Verknüpfen Sie diese Anmeldeinformationsliste mit diesem Trunk und speichern Sie die Terminierungseinstellungen.

Verwenden Sie den Benutzernamen und das Passwort der SIP-Anmeldeinformationsliste in Versafy – nicht die SID Ihres Twilio-Kontos, das Authentifizierungstoken oder das Konsolenpasswort. Twilio erfordert einen Terminierungs-URI und mindestens eine Authentifizierungsmethode, bevor der Trunk ausgehende Anrufe tätigen kann.

Wenn Sie internationale Ziele anrufen, aktivieren Sie im Rahmen der geografischen Voice-Berechtigungen von Twilio nur die Länder, die Ihr Unternehmen benötigt. Siehe Twilios Leitfaden für geografische Berechtigungen .

4. Importieren Sie die Nummer in Versafy

Durch den Import wird die Twilio-eigene Nummer für Versafy verfügbar gemacht, ohne dass das gesamte Twilio-Konto verbunden werden muss.

Navigation: Offen Telefon → Telefonnummern, wählen Sie das aus Zahlen Klicken Sie auf die Registerkarte und wählen Sie dann aus Externe Nummer hinzufügen (über SIP).

Geben Sie ein klares ein Etikett, wie z Twilio Sales.
Geben Sie den gekauften Betrag ein Telefonnummer im E.164-Format, einschließlich + und die Landesvorwahl.
Erweitern Eingehende Konfiguration.
Unter Eingehendes Routing/Ursprungs-URI, kopiere das Ganze SIP-URI. Lassen Sie es unverändert; Sie werden es im nächsten Abschnitt in Twilio einfügen.
Behalten Medienverschlüsselung eingestellt auf Erlaubt für die Erstverbindung.
Lassen Sie die optionalen Eingangsnummernfilter, Quelladressfilter, Domänenliste, Header-Zuordnungen und Authentifizierungsfelder unverändert, es sei denn, Ihr Telefonadministrator hat eine spezielle Richtlinie dafür.
Erweitern Ausgehende Konfiguration und geben Sie ein:
- Adresse: der Twilio Termination-Hostname, z. B versafy-sales.pstn.twilio.com. Nicht einbeziehen sip: oder ein Hafen.
- Transport: TCP (empfohlen).
- Medienverschlüsselung: Deaktiviert.
- SIP-Trunk-Benutzername: Der Benutzername aus der Twilio-Anmeldeinformationsliste.
- SIP-Trunk-Passwort: das Passwort aus derselben Twilio-Anmeldeinformationsliste.
Lassen Sie optionale ausgehende Header und Codecs für die Ersteinrichtung leer.
Auswählen Importieren.

Aktivieren Sie Twilio nicht Sicheres Trunking für dieses TCP-Setup. Secure Trunking erfordert übereinstimmende TLS- und verschlüsselte Medieneinstellungen auf beiden Seiten und lehnt eine Verbindung ab, die die oben genannten Einstellungen verwendet.

5. Konfigurieren Sie Twilio Origination für eingehende Anrufe

Origination teilt Twilio mit, wohin ein Anruf weitergeleitet werden soll, wenn ein Kunde Ihre gekaufte Nummer wählt.

Kehren Sie in der Twilio-Konsole zum Kofferraum zurück und öffnen Sie ihn Entstehung.
Auswählen Fügen Sie einen neuen Ursprungs-URI hinzu.
Geben Sie a ein Freundlicher Name, wie z Versafy inbound.
Fügen Sie den vollständigen SIP-URI ein, der von Versafy kopiert wurde. Es umfasst die Telefonnummer, den Host, den Port und transport=tcp Einstellung.
Behalten Sie die URI Aktiviert.
Behalten Sie für einen einzelnen URI die Standardprioritäts- und -gewichtungswerte von Twilio bei.
Speichern Sie die Origination-Einstellungen.

Ersetzen Sie die Nummer im URI nicht, sondern entfernen Sie sie transport=tcp, ändern Sie das Schema in sips:, oder fügen Sie hier den Twilio Termination-Hostnamen ein. Twilio dokumentiert das Verhalten des Ursprungs-URI in seinem Konfigurationsanleitung für elastisches SIP-Trunking .

6. Ordnen Sie die Twilio-Nummer dem Trunk zu

Durch die Zuordnung der Nummer wird die Amtsleitung als eingehende Sprachroute der Nummer aktiviert.

Routenänderung: Durch die Zuordnung der Nummer zu diesem Trunk wird die vorherige Konfiguration für eingehende Sprachanrufe in Twilio ersetzt. Stellen Sie sicher, dass die Nummer keine andere Produktionsanwendung bedient, bevor Sie fortfahren.

Öffne den Kofferraum Zahlen Abschnitt.
Auswählen Ordnen Sie dieser Amtsleitung eine Nummer zu.
Wählen Sie die von Ihnen gekaufte Nummer aus und bestätigen Sie die Zuordnung.
Stellen Sie sicher, dass die Nummer in der Nummernliste der Amtsleitung angezeigt wird.

Wenn Twilio stattdessen die Konfigurationsseite der Nummer öffnet, wählen Sie SIP-Trunking Für eingehende Sprachanrufe wählen Sie diesen Trunk aus und speichern ihn.

7. Weisen Sie einen eingehenden Anrufverlauf nur für KI zu

Der eingehende Fluss wählt aus, welcher Voice Agent diese Nummer beantwortet.

In Versafy öffnen Telefon → Telefonnummern → Eingehende Anrufverläufe.
Erstellen Sie einen Flow mit Nur KI Vorlage.
Wählen Sie die importierte externe SIP-Nummer und den Voice Agent aus, der antworten soll.
Überprüfen, erstellen und aktivieren Sie den Flow.
Zurück zum Zahlen Klicken Sie auf die Registerkarte und bestätigen Sie, dass die Nummer angezeigt wird Ablauf eingehender Anrufe beigefügt und der beabsichtigte Flow-Name.

Wenn Sie den Flow vor dem Importieren der Nummer erstellt haben, finden Sie die Nummer unten Zahlen, wählen Stellen Sie eine Verbindung zu einem eingehenden Anrufverlauf her, und wählen Sie einen aktiven AI Only-Flow aus.

8. Testen Sie beide Rufrichtungen

Das Testen beider Richtungen bestätigt, dass Nummer, Leitung, Authentifizierung und Versafy-Zuweisungen zusammenarbeiten.

Testen Sie eingehende Anrufe

Rufen Sie die Twilio-Nummer von einem Telefon außerhalb des Twilio-Kontos an.
Bestätigen Sie, dass der erwartete Voice Agent mit der richtigen Eröffnungsnachricht antwortet.
Stellen Sie eine normale Testfrage und beenden Sie dann den Anruf.
Offen Telefon → Anrufprotokolle und Aufzeichnungen und bestätigen Sie, dass der Anruf angezeigt wird.

Testen Sie ausgehende Anrufe

Offen Telefon → Sprachagenten.
Suchen Sie den Wirkstoff und wählen Sie ihn aus Rufen Sie an.
Wählen Sie die importierte Twilio-Nummer als Anrufernummer aus.
Geben Sie ein Testziel im E.164-Format ein und bestätigen Sie den Anruf.
Nehmen Sie den Anruf entgegen und überprüfen Sie die Zwei-Wege-Audiofunktion.
Überprüfen Anrufprotokolle bevor Sie einen fehlgeschlagenen oder unklaren Versuch wiederholen.

Sie können auch eine Bewertung abgeben Elastisches SIP-Trunking → Protokolle in Twilio. Twilio bietet zusätzliche Trunk-Check-Ins Testen Sie Ihren Elastic SIP Trunk .

Fehlerbehebung

Die externe SIP-Nummer wird bei ausgehenden Anrufen nicht angezeigt

Bestätigen Sie, dass der Import abgeschlossen ist. Die Nummer wird angezeigt Ausgehend aktiviert unter Telefon → Telefonnummern → Nummern, und der Voice Agent ist aktiv. Offen Bearbeiten Geben Sie die externe Nummer ein und überprüfen Sie die ausgehende Adresse und Anmeldeinformationen.

Ausgehende Anrufe schlagen mit einem Authentifizierungsfehler fehl

Bestätigen Sie, dass die Anmeldeinformationsliste mit demselben Twilio-Trunk verbunden ist und dass Versafy SIP-Trunk-Benutzername und SIP-Trunk-Passwort passen genau dazu. Verwenden Sie keine Twilio-Kontoanmeldeinformationen.

Ausgehende Anrufe schlagen fehl, bevor es klingelt

Überprüfen Sie Folgendes:

Adresse enthält nur den Twilio Termination-Hostnamen;
Das Ziel umfasst + und sein Ländercode;
Twilio erlaubt Anrufe in dieses Zielland;
ein Testkonto ruft ein von Twilio verifiziertes Ziel an;
Die Twilio-Nummer bleibt Eigentum desselben Projekts oder Unterkontos wie der Trunk.

Eingehende Anrufe erreichen Versafy nicht

Stellen Sie sicher, dass die Twilio-Nummer dem richtigen Trunk zugeordnet ist, der Ursprungs-URI aktiviert ist und genau mit dem von Versafy kopierten Wert übereinstimmt und die externe Nummer einem aktiven AI Only-Flow zugewiesen ist.

Für die externe SIP-Nummer ist kein Flow verfügbar

Nur aktiv Nur KI Datenflüsse ohne Eskalation an einen Menschen sind förderfähig. Erstellen oder aktivieren Sie diesen Flow-Typ oder verwenden Sie die native Twilio-Verbindung, wenn Sie eine komplexere Caller Journey benötigen.

Der Anruf wird verbunden, aber der Ton fehlt oder ist unidirektional

Stellen Sie sicher, dass Twilio Secure Trunking für dieses Setup deaktiviert ist und dass die Medienverschlüsselungseinstellungen des Versafy mit diesem Handbuch übereinstimmen. Wenn Sie eingeschränkt sind Zulässige Quell-IP-Adressen, umfassen alle aktuellen Twilio-Signalisierungsbereiche und nicht nur eine Region; Rezension Twilios aktuelle SIP-Trunking-IP-Adressliste .

Wenn Twilio einen Fehler aufgrund nicht unterstützter Medien meldet, bearbeiten Sie die externe SIP-Nummer und fügen Sie sie hinzu PCMU/8000 oder PCMA/8000 unter Aktivierte Codecs. Twilios Anleitung zur Fehlerbehebung im Kofferraum listet die Codecs auf, die es akzeptiert.

Sie müssen die importierte Telefonnummer ändern

Sie können die Bezeichnung und die SIP-Einstellungen bearbeiten, nicht jedoch die E.164-Nummer selbst. Trennen Sie es von allen Datenflüssen, löschen Sie die externe SIP-Nummer aus Versafy und importieren Sie die richtige Nummer erneut. Durch das Löschen aus Versafy wird die Nummer nicht aus Ihrem Twilio-Konto freigegeben.