Verbinden eines Bots mit Twilio (SMS)

  • Artikel

GILT FÜR: SDK v4

Sie können Ihren Bot so konfigurieren, dass er mit Personen kommuniziert, die als Plattform für die Cloudkommunikation Twilio (SMS) verwenden. In diesem Artikel wird beschrieben, wie Sie einen Bot für die Kommunikation mithilfe von Twilio konfigurieren, indem sie eine TwiML-Anwendung erstellen und den Bot im Azure-Portal verbinden.

Voraussetzungen

  • Ein Azure-Konto. Wenn Sie noch nicht über ein Abonnement verfügen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
  • Ein vorhandener Bot, der in Azure veröffentlicht wurde.

Erstellen einer TwiML-Anwendung

  1. Wenn Sie kein Twilio-Konto besitzen, können Sie ein neues Konto erstellen. Falls Sie bereits über ein Twilio-Konto verfügen, melden Sie sich an, und fahren Sie mit dem nächsten Schritt fort.
  2. Befolgen Sie die folgende Anleitung, um eine TwiML-Anwendung zu erstellen.

    • Geben Sie einen Anzeigenamen für Ihre TwiML-App ein.

    • Lassen Sie unter VoIP-Konfiguration die Anforderungs-URL leer.

    • Legen Sie unter "Messagingkonfiguration" die Anforderungs-URL fest:

      • Geben Sie für einen globalen Bot https://sms.botframework.com/api/sms ein.
      • Geben Sie für einen regionalen Bot folgende URL gemäß der ausgewählten Region ein:
      Region Anforderungs-URL
      Europa https://europe.sms.botframework.com/api/sms
      Indien https://india.sms.botframework.com/api/sms

Auswählen oder Hinzufügen einer Telefonnummer

Befolgen Siediese Anleitung, um über die Konsole eine verifizierte Anrufer-ID hinzuzufügen. Sie können dies überspringen, wenn Sie bereits über eine überprüfte Anrufer-ID verfügen.

Wenn Sie fertig sind, wird Ihre überprüfte Nummer in bestätigte Anrufer-IDs angezeigt.

TwiML-App für Voice und Messaging angeben

Nachdem Sie eine überprüfte Anrufer-ID hinzugefügt haben, konfigurieren Sie die Einstellung Ihrer Nummer so, dass sie die von Ihnen erstellte TwiML-App verwendet.

  1. Wählen Sie Aktive Nummern unter Telefonnummern > verwalten aus. Klicken Sie auf die Nummer und gehen Sie zu Konfigurieren.
  2. Legen Sie unter "Voice& Fax" und "Messaging" "Configure With" auf "*TwiML App" fest. Legen Sie dann TwiML APP auf die zuvor erstellte TwiML-App fest. Wählen Sie Speichern aus, nachdem Sie den Vorgang abgeschlossen haben.
  3. Wählen Sie erneut Aktive Zahlen aus. Sie sehen, dass die aktive Konfiguration von Voice und Messaging auf Ihre TwiML-App eingestellt ist.

Sammeln von Anmeldeinformationen von Twilio

  1. Gehen Sie zurück zur Twilio Console-Homepage

  2. Unter "Kontoinformationen" wird Ihre Konto-SID und Ihr Authentifizierungstoken im Projektdashboard angezeigt, siehe unten. Kopieren und speichern Sie diese Werte für später.

    Gather app credentials from Twilio Console

Geben Sie Twilio-Anmeldeinformationen im Azure-Portal ein

Nachdem Sie nun über die erforderlichen Werte von Twilio verfügen, verbinden Sie Ihren Bot mit Twilio im Azure-Portal.

  1. Gehen Sie in einem separaten Fenster zum Azure-Portal.

  2. Wählen Sie den Bot aus, für den eine Verbindung mit Twilio hergestellt werden soll.

  3. Wählen Sie unter EinstellungenKanäle und dann in der Liste der verfügbaren Kanäle dasSymbol Twilio (SMS) aus.

  4. Geben Sie die Telefonnummer, Konto-SID und das Authentifizierungstoken ein, die Sie zuvor gespeichert haben. Wählen Sie Anwenden aus, nachdem Sie den Vorgang abgeschlossen haben.

    Enter Twilio credentials in Azure

Ihr Bot ist nun für die Kommunikation mit Benutzern in Twilio konfiguriert.

Testen Ihres Bots in Twilio

Sie können jetzt überprüfen, ob Ihr Bot ordnungsgemäß mit Twilio verbunden ist, indem Sie eine SMS-Nachricht an Ihre Twilio-Nummer senden. Nachdem die Nachricht von Ihrem Bot empfangen wurde, sendet er eine Nachricht an Sie zurück, die den Text Ihrer Nachricht wiedergibt.

Weitere Informationen

Weitere Informationen zur Entwicklung für Twilio finden Sie in der Twilio SMS-Dokumentation.

Verbinden eines Bots mit Twilio mithilfe des Twilio-Adapters

Zusätzlich zur Verwendung des verfügbaren Azure KI Bot Service-Kanals zum Verbinden Ihres Bots mit Twilio definieren die Bot Builder Community-Repos einen benutzerdefinierten Kanaladapter für Twilio.