Oracle Cloud Infrastructure - Dokumentation

Nur-Text-Kanäle

Wie bei dem Facebook-Kanal konfigurieren Sie Nur-Text-Kanäle mit Artefakten, die von der Messagingplattform und von Digital Assistant generiert werden. Bei Nur-Text-Kanälen wie Twilio/SMS müssen Sie jedoch auch die Dialogablaufdefinition aktualisieren, damit die Antworten Ihres Bots entsprechend gerendert werden, wenn Schaltflächen nicht unterstützt werden. Dies umfasst zwei Aspekte:
  • Inhalt für Nur-Text-Kanäle ein- oder ausblenden. Für gemeinsame Antwortkomponenten bedeutet dies, dass Sie die Eigenschaft metadata so aktualisieren müssen, dass sie Twilio für alle Antwortelemente, Karten oder globale Aktionen aufnimmt (oder ggf. ausschließt):
    responseItems:
- type: "text"
  text: "This text text displays on Twilio"
  visible:
    channels:
      include: "twilio"             
- type: "text"
  text: "This text is not shown in Twilio or Facebook!"
  visible:
    channels:
      exclude: "facebook, twilio"
  actions:
  - label: "This action is only shown on web channel."
    type: "postback"
    payload:
      action: "someAction"
    visible:
      channels:
        include: "web"

  • Automatische Nummerierung konfigurieren.

Twilio/SMS

Sie benötigen Folgendes, um Ihren digitalen Assistenten auf Twilio/SMS auszuführen:
  • Twilio-Zugangsdaten (diese geben Sie bei der Digital Assistant-Kanalkonfiguration an):

    • Eine Twilio-Telefonnummer.

    • Account-SID

    • Authentifizierungstoken

  • Von Digital Assistant (zur Angabe in Twilio):

    • Die Webhook-URL (wird generiert, wenn Sie den Twilio-Kanal erstellen)

Hinweis

Wenn Sie einen Kanal für einen digitalen Assistenten in Twilio erstellen, beachten Sie, dass der Befehl "exit", mit dem Benutzer Skills in Ihrem digitalen Assistenten beenden können, auch ein Standardschlüsselwort in Twilio ist. Wenn ein Benutzer also "exit" in einen Twilio-Kanal eingibt, wird die Twilio-Unterhaltung beendet, und der digitale Assistent erhält diese Eingabe nicht. Benutzer, die bei der Arbeit mit dem digitalen Assistenten den Befehl "exit" verwenden möchten, müssen sich an Twilio wenden und "exit" als Schlüsselwort aus ihrem Account entfernen lassen.

Schritt 1: SMS-aktivierte Twilio-Nummer erhalten

Um die Twilio-Nummer, die Account-SID und das Authentifizierungstoken für die Twilio-Kanalkonfiguration zu generieren, müssen Sie zuerst einen Twilio-Account erstellen (sofern noch kein Account vorhanden ist). Gehen Sie nach der Überprüfung Ihrer Identität folgendermaßen vor:

  1. Klicken Sie in der linken Navigationsleiste auf All Products and Services (Dieses Bild zeigt das Symbol "All Products and Services".).

  2. Pinnen Sie die beiden Einträge Programmable SMS (Dieses Bild zeigt das Symbol "Programmable SMS".) und Phone Numbers (Dieses Bild zeigt das Symbol "Phone Numbers".) an Ihr Dashboard.
    Beschreibung von twilio-products.png folgt
    Beschreibung der Abbildung twilio-products.png

  3. Klicken Sie auf Phone Numbers (jetzt in der linken Navigationsleiste gepinnt), und klicken Sie auf Get Started.

  4. Wählen Sie Get a Number oder Buy a Number aus. Wählen Sie in beiden Fällen die Funktion SMS aus. Halten Sie diese Nummer griffbereit, da Sie den Twilio-Kanal in Digital Assistant mit dieser Nummer konfigurieren.

  5. Klicken Sie in der linken Navigationsleiste auf Console Dashboard (Dies ist ein Bild des Dashboard-Symbols.), und notieren Sie sich die Account-SID und das Authentifizierungstoken (diese Informationen können durch Klicken auf "View" aufgerufen werden). Neben der Twilio-Nummer benötigen Sie diese Zugangsdaten zur Konfiguration des Twilio-Kanals.

Schritt 2: Bot mit der Twilio-Nummer verknüpfen

Halten Sie die Twilio-Zugangsdaten griffbereit, und gehen Sie wie folgt vor:

  1. Klicken Sie in Digital Assistant im linken Menü auf Kanäle, und wählen Sie Benutzer aus.

  2. Klicken Sie auf Kanal hinzufügen.

  3. Gehen Sie im Dialogfeld "Kanal erstellen" folgendermaßen vor:

    1. Geben Sie einen Namen ein, und wählen Sie im Menü "Kanaltyp" die Option Twilio-SMS aus.

    2. Geben Sie die Account-SID, das Authentifizierungstoken und die Twilio-Nummer ein.

    3. Aktivieren Sie die Option Kanal aktiviert.

    4. Klicken Sie auf Symbol für die Dropdown-Liste "Weiterleiten an...", und wählen Sie den digitalen Assistenten oder Skill aus, den Sie mit dem Kanal verknüpfen möchten.

  4. Klicken Sie auf Erstellen. Notieren Sie sich die Webhook-URL. Sie benötigen diese als letzte Eingabe in der Twilio-Konsole.

  5. Klicken Sie in der Twilio-Konsole auf Phone Numbers (Dieses Bild zeigt das Symbol "Phone Numbers".), und klicken Sie dann auf Active Numbers.

  6. Klicken Sie auf der Seite "Aktive Nummern" auf die Twilio-Nummer.

  7. Fügen Sie im Abschnitt "Messaging" der Seite "Configure" die Webhook-URL in das Feld A Message Comes In ein.

  8. Klicken Sie auf Speichern.

Tipps zum Testen

Sie können den Twilio-Kanal mit Ihrem eigenen Telefon testen, indem Sie Nachrichten an die Twilio-Accountnummer von Digital Assistant senden.

Unterstützte Funktionen

Twilio-Kanäle in Digital Assistant unterstützen die folgenden Funktionen:

  • Text
  • Bilder (als URL)
  • Dateien (als URL)
  • Emojis (als URL)
  • Links
  • Postbacks (als URL)
  • Benutzerdefinierte Eigenschaften (werden teilweise unterstützt)
  • Karussellkomponenten (werden teilweise unterstützt)
  • Listenkomponenten (werden teilweise unterstützt)
Hinweis

Wenn Sie Ihren Skill auf mehrere Kanäle mit unterschiedlichen Formatierungsfunktionen ausrichten, können Sie HTML-Markup in Ihren Nachrichten verwenden. Bei textbasierten Kanälen wird dieses Markup von der Nachricht entfernt, wenn die Nachricht an den Kanal übertragen wird. Siehe Rich-Text-Formatierung in Kanälen.

Nachrichten-Constraints

Für Twilio-Kanäle in Digital Assistant gelten die folgenden Nachrichten-Constraints:

  • Textnachrichten
    • Maximale Länge der Textnachricht: 1.600 Zeichen. Wenn die Länge 1600 überschreitet, wird der Text auf mehrere Nachrichten aufgeteilt.
    • Zulässige Textaktionen: Postback, Aufruf, URL Diese Aktionstypen werden in Text konvertiert. Bei Postback-Aktionen dient das Label als Schlüsselwort, mit dem der Postback ausgelöst werden kann.
  • Horizontale Karten
    • Unterstützt? Nein, aber nahezu äquivalente Funktionalität wird erreicht, indem einige Aktionstypen in Text konvertiert werden.
    • Zulässige Kartenaktionen: Postback, Aufruf, URL Diese Aktionstypen werden in Text konvertiert. Bei Postback-Aktionen dient das Label als Schlüsselwort, mit dem der Postback ausgelöst werden kann.
    • Zulässige Kartenlistenaktionen: Postback, Aufruf, URL Diese Aktionstypen werden in Text konvertiert. Bei Postback-Aktionen dient das Label als Schlüsselwort, mit dem der Postback ausgelöst werden kann.
  • Vertikale Karten
    • Unterstützt: Nein, aber nahezu äquivalente Funktionalität wird erreicht, indem einige Aktionstypen in Text konvertiert werden.
    • Zulässige Kartenaktionen: Postback, Aufruf, URL Diese Aktionstypen werden in Text konvertiert. Bei Postback-Aktionen dient das Label als Schlüsselwort, mit dem der Postback ausgelöst werden kann.
    • Zulässige Kartenlistenaktionen: Postback, Aufruf, URL. Diese Aktionstypen werden in Text konvertiert. Bei Postback-Aktionen dient das Label als Schlüsselwort, mit dem der Postback ausgelöst werden kann.
  • Anhangsnachrichten
    • Unterstützt? Ja, wenn MMS aktiviert ist.
    • Zulässige Anhangsaktionen: Postback, Aufruf, URL. Diese Aktionstypen werden in Text konvertiert. Bei Postback-Aktionen dient das Label als Schlüsselwort, mit dem der Postback ausgelöst werden kann.
  • Aktionsschaltflächen
    • Unterstützt? Nein, aber nahezu äquivalente Funktionalität wird durch Konvertierung einiger Aktionstypen in Text erreicht.
    • Zulässige globale Aktionen: Postback, Aufruf, URL. Diese Aktionstypen werden in Text konvertiert. Bei Postback-Aktionen dient das Label als Schlüsselwort, mit dem der Postback ausgelöst werden kann.

Twilio-Kanalerweiterungen

Bei Twilio-Kanälen können Sie die Funktionalität von Common Response-Komponenten um spezifische Twilio-Funktionen erweitern.

Sie können auf die Erweiterungen zugreifen, indem Sie das Element channelCustomProperties in der Komponente verwenden und die entsprechenden Eigenschaften festlegen. Der Code hat das folgende Format: 

...
            channelCustomProperties:
            - channel: "twilio"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Sie können channelCustomProperties je nach angegebener Eigenschaft auf die Metadaten der Komponente auf der Ebene von globalActions, responseItems und auf Elemente von responseItems anwenden.

Nachfolgend finden Sie die verfügbaren benutzerdefinierten Eigenschaften für Twilio-Kanäle:

Name Zulässige Werte Gültig für... Beschreibung
mmsEnabled
  • true
  • false
 Antwortelemente vom Typ cards oder attachment. Damit können Sie die Standardeinstellung der Kanalkonfiguration, der zufolge MMS aktiviert ist, außer Kraft setzen. Wenn diese Option aktiviert ist, werden Bilder in ihrer eigenen Nachrichtenblase mit der Schaltfläche Zum Prüfen tippen angezeigt.
optimizeCardRendering
  • true
  • false
 Antwortelemente vom Typ cards. Setzen Sie diese Eigenschaft auf true, um die Kartenaktion zu einem aus zwei Schritten bestehenden Prozess zu machen, wobei der Benutzer zuerst eine Karte und dann die Kartenaktion auswählt.
cardListHeader
  • freier Text
 Antwortelemente vom Typ cards. Der Header, der angezeigt wird, wenn die Kartenliste angezeigt wird. Diese Eigenschaft setzt die Eigenschaft headerText der Kartennachricht außer Kraft. Nur anwendbar, wenn optimizeCardRendering auf true gesetzt ist.
cardListFooter
  • freier Text
 Antwortelemente vom Typ cards. Der Footer, der angezeigt wird, wenn die Kartenliste angezeigt wird. Diese Eigenschaft setzt die Eigenschaft footerText der Kartennachricht außer Kraft. Nur anwendbar, wenn optimizeCardRendering auf true gesetzt ist.
cardDetailHeader
  • freier Text
 Eine der folgenden Optionen:
  • Eine Karte, auf der die Eigenschaft "url" angegeben ist
  • Eine action mit "type": "url"
 Der Header, der angezeigt wird, wenn Kartendetails angezeigt werden. Diese Eigenschaft setzt die Eigenschaft headerText der Kartennachricht außer Kraft. Nur anwendbar, wenn optimizeCardRendering auf true gesetzt ist.
cardDetailFooter
  • freier Text
 Eine der folgenden Optionen:
  • Eine Karte, auf der die Eigenschaft "url" angegeben ist
  • Eine action mit "type": "url"
 Der Footer, der angezeigt wird, wenn Kartendetails angezeigt werden. Diese Eigenschaft setzt die Eigenschaft footerText der Kartennachricht außer Kraft. Nur anwendbar, wenn optimizeCardRendering auf true gesetzt ist.

Weitere Informationen zur Verwendung von channelCustomProperties finden Sie unter Kanalspezifische Erweiterungen.