Neu
🔥 Seien Sie der Erste, der die WhatsApp Business Calling API (Open Beta) ausprobiert!
arrow-icon
All Collections >
Integrationen >
Dialogablauf >
Dialogfluss: Parameter

Dialogfluss: Parameter

Avatar
Susan Swier
· 04 Apr 2025
6 Min. Lesezeit

Respond.io verwendet benutzerdefinierte Dialogflow-Parameter, um die Funktionen der Anwendung zu erweitern und mehrere Anwendungsfälle abzudecken.

Im Dialogflow werden in der Regel Parameter verwendet, um Wörter und Phrasen in der Antwort eines Benutzers auf Entitäten zu verbinden. Wenn jemand sagt "Mein Geburtstag ist am 13. März", wird die Phrase "13. März" automatisch erkannt und als Datumseinheit behandelt. Weitere Informationen zu den Parametern finden Sie im Dialogflow auf der Dokumentationsseite.

Mit der respond.io Plattform können Sie Parameter verwenden, um mehr Anwendungsfälle abzudecken. Sie können sie verwenden, um Informationen von Ihren Kontakten zu speichern und zu sammeln, z.B. durch dynamische Tags und benutzerdefinierte Felder festlegen. Sie können sogar Supportmitarbeiter benachrichtigen, wenn ein Kontakt Hilfe benötigt. Sie können auch die respond.io-Plattform verwenden, um Ihre Absichtsantworten zu speichern und einfach zu verwalten.

Es gibt viel, was man erreichen kann, wenn Sie die respond.io Plattform in Verbindung mit Dialogflow Intent Parametern verwenden.

Parameterreferenz

Die Liste der Parameter, die Sie im Dialogflow verwenden können, um mit der respond.io Plattform zu kommunizieren.

Parametername

Wert

Beschreibung

RB_ADDTAGS

tag1, [tag2, ...]

Fügt die angegebenen Tag(s) dem Kontaktprofil auf der respond.io Plattform hinzu

​RB_REMOVETAGS​

tag1, [tag2, ...]

Entfernt die angegebenen Tag(s) aus dem Kontaktprofil auf der respond.io Plattform

​RB_BOTSTATUS​

falsch

Schaltet den Bot für den bestimmten Kontakt aus. Dies ist nützlich in Fällen, in denen Sie die Unterhaltung vom Bot an einen Menschen übergeben möchten.

​RB_MARKDONE​

wahr/falsch

Öffnet oder schließt eine Unterhaltung für einen Kontakt. Dies ist für die Unterstützung nützlich. Öffnet ein Gespräch für Kontakte, die noch etwas erwarten, während das Schließen eines Gesprächs bedeutet Kontakte, die besucht wurden.

RB_NOTIFY

notification_message

Sendet eine Benachrichtigung an die Benutzer auf der respond.io Plattform, begleitet von einer Benachrichtigung.

RB_SUBSCRIBE

wahr/falsch

Abonniert oder löscht einen Kontakt. Nicht abonnierte Kontakte erhalten keine Broadcast-Nachrichten.

RB_FIELD_FIRSTNAME

wert

Füllt das Vornamen-Feld des Kontaktprofils mit dem angegebenen Wert

RB_FIELD_LASTNAME

wert

Füllt das Feld Nachname des Kontaktprofils mit dem angegebenen Wert

RB_FIELD_VOLLNAME

wert

Füllt das vollständige Namensfeld des Kontaktprofils mit dem angegebenen Wert

RB_FIELD_EMAIL

wert

Füllt das E-Mail-Adressfeld des Kontaktprofils mit dem angegebenen Wert

RB_FIELD_PHONE

wert

Füllt das Feld Telefonnummer des Kontaktprofils mit dem angegebenen Wert

RB_FIELD_LANGUAGE

wert

Füllt das Sprachfeld des Kontaktprofils mit dem angegebenen Wert, z.B. en-us

RB_FILD_[NAME]

wert

Fügt ein benutzerdefiniertes Feld dem Profil des Kontakts mit dem angegebenen Wert hinzu. Dies wird am besten für nicht-dynamische Informationen wie E-Mail, Geburtstag usw. verwendet.

RB_REMOVEFIELDS

field1, [field2, ...]

Entfernt das angegebene benutzerdefinierte Feld(e) von den Kontakten auf der Plattform

RB_USER_ZUWEISEN

wert

Ordnet den Kontakt einem Benutzer in Ihrem Team zu

RB_SNIPPET

snippet_id

Sende den angegebenen Snippet an den Kontakt

RB_FILE

datei_id

Sende die angegebene Datei auf der Plattform an den Kontakt

Markieren

Kontakte' Informationen können in Form von Tags gespeichert werden. Tags können manuell im Kontaktmodul oder Inbox Modul hinzugefügt oder entfernt werden, programmatisch hinzugefügt/entfernt mit Workflows und hinzugefügt/entfernt mit Parametern in Dialogflow-Intentionen.

Wichtig: Tags werden für die Zuschauersegmentierung in Sendungen verwendet. Beachten Sie das beim Hinzufügen/Entfernen von Tags mittels Dialogflow intents.

Tag-Parameter verwenden

Tags hinzufügen

Mit Hilfe des Parameters RB_ADDTAGS können Sie einem Kontakt ein Schlagwort zuweisen. Tags werden dem Kontakt basierend auf dem Wert des Parameters hinzugefügt. Sie haben die Möglichkeit, mehrere Tags hinzuzufügen, indem Sie diese durch Kommata trennen.

Beachten Sie, dass Tagnamen keine Leerzeichen enthalten dürfen. Sie können stattdessen Unterstriche verwenden.

Tags entfernen

Mit Hilfe des Parameters RB_REMOVETAGS können Sie ein Schlagwort von einem Kontakt entfernen. Tags werden dem Kontakt basierend auf dem Wert des Parameters hinzugefügt. Sie haben die Möglichkeit, mehrere Tags durch Kommata zu entfernen.

Best Practices

Beim Erstellen neuer Tags ist es eine gute Idee, kurze, aber sinnvolle Namen zu definieren, die leicht zu identifizieren sind. Idealerweise möchten Sie, dass andere Leute in der Lage sind, die mit einem Benutzer verbundenen Tags zu verstehen.

Bei der Slot Füllung mit Entitäten haben Sie die Möglichkeit, dynamisch neue Tags zu erstellen. Dies wird jedoch nicht empfohlen, da es schnell zu einer Verschmutzung führen wird.

Um die Verunreinigung zu verringern, versuchen Sie, nicht zu spezifisch oder zu großzügig mit den Tags umzugehen, um die Anzahl der Tags auf ein Minimum zu reduzieren.

Wenn Sie Tags verwenden, um die Thematik eines Benutzers im Auge zu behalten, können Sie das gleiche Tag in mehreren Absätzen verwenden, die das gleiche Thema haben. Dadurch kann festgestellt werden, dass der Benutzer ein besonderes Interesse oder Bedenken hat, während die Tag-Verschmutzung verringert wird.

Bot ausschalten

Der Dialogfluss-Bot kann manuell vom Inbox-Modul eingeschaltet oder ausgeschaltet werden und automatisch Workflows verwenden. Darüber hinaus kann ein Bot auch mittels Parameter in Dialogflow-Intentionen abgeschaltet werden.

Um den Bot-Status eines Kontakts auszuschalten, kann eine Dialogflow-Absicht genutzt werden, um eine Übergabe an einen Menschen in Ihrem Bot-Workflow zu erstellen.

Wenn Bot für einen Kontakt deaktiviert ist, werden keine Nachrichten an den Dialogflow übergeben. Kontakte mit deaktiviertem Bot werden auf der Plattform unter Nicht zugewiesener Abschnitt im Dashboard angezeigt.

Verwenden des Bot Status Parameters

Mit RB_BOTSTATUS können Sie den Bot für einen bestimmten Benutzer deaktivieren, indem Sie den Wert auf false setzen.

Best Practices

Die Fallback-Absicht enthält keinen Ort zum Hinzufügen von Parametern. Wenn Sie den Bot in Dialogflow deaktivieren, sollten Sie in Ihrer Fallback-Absicht eine schnelle Antwort erstellen, die den Kontakt fragt, ob sie mit einem Menschen sprechen möchten. Wenn der Kontakt mit der ja Schnellantwort antwortet, sollte dies mit dem RB_BOTSTATUS Parameter zur Absicht führen.

Wenn Sie diesen Parameter verwenden, um den Bot zu deaktivieren, möchten Sie möglicherweise auch den Benutzerstatus auf der Plattform mit RB_MARKDONE und eine Benachrichtigung auf der Plattform mit dem Parameter RB_NOTIFY innerhalb einer einzelnen Absicht aktualisieren.

Unterhaltung beenden

Die Zuordnung und Schließung eines Konversationssystems eröffnet eine neue Konversation für alle neuen Kontakte und Kontakte mit neuen Nachrichten. Dies stellt sicher, dass alle Kontakte, die Hilfe benötigen, in der nicht zugewiesenen Liste erscheinen.

Standardmäßig öffnet die Plattform eine neue Unterhaltung für alle neuen Kontakte und Kontakte, die eine neue Nachricht senden.

Eine Unterhaltung kann manuell für einen Kontakt im Kontaktmodul oder Inbox Modul geöffnet oder geschlossen werden, programmgesteuert mit Workflows geöffnet oder geschlossen und mit Parametern in Dialogflow-Intentionen geschlossen.

Um eine Konversation eines Kontakts aus dem Dialogflow zu schließen, verwenden Sie den Parameter RB_MARKDONE in Ihren Dialogfloweinträgen(n).

Verwendung des Markierungsparameter

Um eine Konversation eines Kontakts zu schließen, verwenden Sie den RB_MARKDONE Parameter in Ihrer Dialogflow Absicht und setzen Sie den Wert auf true.

Jeder Kontakt, der eine Absicht mit dem RB_MARKDONE-Parameter und dem Wert true auslöst, wird seine Unterhaltung auf der respond.io-Plattform geschlossen.

Best Practices

Standardmäßig öffnen alle neuen Kontakte und Kontakte mit neuen Nachrichten eine neue Unterhaltung. Sie sollten RB_MARKDONE als true für Absichten festlegen, die keinen menschlichen Agenten erfordern, wenn sie ausgelöst werden.

Sie sollten in Betracht ziehen, diese Absicht zusammen mit RB_NOTIFY zu verwenden, um eine Benachrichtigung auszulösen, wenn eine Unterhaltung für einen Kontakt geöffnet wird. Die Benachrichtigungsnachricht kann verwendet werden, um Informationen darüber weiterzugeben, was für den spezifischen Kontakt getan werden muss.

Zuweisen

Um einem Benutzer einen Kontakt aus dem Dialogflow zuzuweisen, verwenden Sie den Parameter RB_USER_ASSIGN in Ihren Dialogfloweinträgen(n).

Verwende den Parameter Zuweisung

Um einem Benutzer einen Kontakt zuzuweisen, verwenden Sie den RB_USER_ASSIGN Parameter in Ihrer Dialogflow-Absicht und legen Sie den Wert als E-Mail des Plattformbenutzers fest, dem Sie zuweisen möchten.

Jeder Kontakt, der mit dem Parameter RB_USER_ASSIGN eine Absicht auslöst und dabei eine gültige Benutzer-E-Mail im Wert angibt, wird diesem Benutzer auf der respond.io Plattform zugewiesen.

Eigene Benachrichtigungen senden

Standardmäßig sendet das Benachrichtigungssystem Benachrichtigungen an Plattformnutzer, wenn ein Kontakt eine neue Nachricht sendet. Zusätzliche Benachrichtigungen können über Parameter in Dialogflow Intents erstellt und an Plattformnutzer gesendet werden.

Um eine Benachrichtigung an Plattformnutzer zu senden, verwenden Sie den RB_NOTIFY Parameter in Ihren Dialogflow Intent(s).

Verwenden Sie den Benachrichtigungsparameter.

Eine Benachrichtigung kann über die RB_NOTIFY als Parametername an die Plattform gesendet werden. Der Wert des Parameters wird als Benachrichtigung gesendet.

Tipp: Sie können eine dynamische Variable im Wert des Parameters verwenden, indem Sie $dynamic.variable eingeben.

Best Practices

Verwenden Sie die dynamische Variable $contact.name um dem Benutzer der Plattform mitzuteilen, welcher Kontakt Aufmerksamkeit benötigt.

RB_NOTIFY zusammen mit RB_BOTSTATUS und RB_MARKDONE um sicherzustellen, dass der Kontakt die Aufmerksamkeit erhält, die er braucht.

Tipp: Erfahren Sie mehr über wie Benachrichtigungen auf der Plattform funktionieren hier.

Abmeldung

Ab und zu erhalten Sie von einem Kontakt die Nachricht "STOP". Dies ist wahrscheinlich, weil sie keine Broadcasts mehr erhalten möchten. Durch das Setzen von RB_SUBSCRIBE als false im Dialogflow werden Kontakte von allen zukünftigen Übertragungen abgemeldet.

Bot-Antworten und Direktnachrichten bleiben davon unberührt.

Den Abonnement-Parameter verwenden

Mit RB_SUBSCRIBE, Sie können einen Kontakt zum Bot abonnieren oder abbestellen, indem Sie den Wert auf true bzw. false setzen. Nicht abonnierte Kontakte sind von zukünftigen Plattformübertragungen ausgeschlossen.

Best Practices

Wenn Sie den Parameter RB_SUBSCRIBE verwenden, um die Berechtigungen für Broadcasts zu verwalten, sollten Sie ein benutzerdefiniertes Feld in respond.io erstellen, um den Abonnementstatus eines Kontakts anzuzeigen. Dies kann über den RB_FIELD_[NAME] Parameter zusammen mit RB_SUBSCRIBE erfolgen.

Kontaktfelder und Werte

Die Informationen der Kontakte können in Form von Werten in den Kontaktfeldern gespeichert werden.

Zusätzlich zu den Standardfeldern können benutzerdefinierte Felder im Einstellungsmodul & entfernt werden. Neue benutzerdefinierte Felder können auch aus dem Dialogflow erstellt werden.

Wenn Sie einen Feldparameter in Dialogflow verwenden und das entsprechende benutzerdefinierte Feld nicht auf der Plattform existiert, wird ein neues benutzerdefiniertes Feld erstellt.

Die Werte der Kontaktfelder können manuell im Kontaktmodul oder Inbox Modul geändert, programmgesteuert über Workflows oder mit Hilfe von Parametern in Dialogflow-Intentionen angepasst werden.

Feldparameter verwenden

Feldwerte einstellen

Sie können den Wert eines benutzerdefinierten Kontaktfeldes mit RB_FIELD_[FIELD_ID] bearbeiten, wobei „[FIELD_ID]“ durch die ID des benutzerdefinierten Feldes ersetzt wird. Die benutzerdefinierte Feld-ID wird als Name des benutzerdefinierten Feldes in SNAKE_CASING generiert. Der Wert des benutzerdefinierten Feldes wird als Wert im Parameter gesetzt. Zum Beispiel, wenn Sie die Blutgruppen von Kontakten sammeln und ein Kontakt den Bluttyp AB positiv hat, würden Sie den Parameter RB_FIELD_BLOODTYPE mit dem Wert AB+ senden.

Tipp: Sie können benutzerdefinierte Feldwerte als dynamische Variablen verwenden.

Standardfelder

Dasselbe kann für jedes der Standard-Kontaktfelder getan werden. Zum Beispiel kann der Parameter RB_FIELD_PHONE verwendet werden, um den Wert der Telefonnummer eines Kontakts zu aktualisieren.

Standardmäßig haben Kontakte auf respond.io die folgenden Kontaktfelder:

Feldname

ID

Beschreibung

Vorname

VORNAME

Der Vorname des Kontakts

Nachname

NACHNAME

Der Nachname des Kontakts

Voller Name

FULLNAME

Der vollständige Name des Kontakts, d.h. Vorname + Nachname

E-Mail-Adresse

E-MAIL

Die E-Mail-Adresse des Kontakts

Telefonnummer.

TELEFON

Die Telefonnummer des Kontakts

Sprache

SPRACHE

Die Sprache des Kontakts

Diese Standardfelder werden automatisch mit verfügbaren Informationen ausgefüllt, die der Kanal zur Verfügung stellt, wenn der Kontakt zum ersten Mal erstellt wird.

Felder löschen

Um einen Feldwert für einen Kontakt zu löschen, können Sie den Parameter RB_REMOVEFIELDS verwenden. Der Wert wäre der Name der Felder, die Sie entfernen möchten. Sie haben die Möglichkeit, mehrere Felder gleichzeitig zu löschen, indem Sie sie durch Kommata trennen.

Schnipsel

Das Snippets System wird verwendet, um den Inhalt der häufig verwendeten Antworten auf der respond.io Plattform zu speichern.

Snippets können manuell im Posteingang-Modul verschickt werden, um die Eingabe zu reduzieren oder mit Hilfe von Parametern in Dialogflow-Intents zu versenden.

Durch das Senden von Snippets in Ihrem Dialogfluss-Agent können Sie den Inhalt Ihrer Intents auf der respond.io-Plattform speichern, wo sie leicht verwaltet und bearbeitet werden können.

Mehrere Absichtserklärungen können auch dasselbe Snippet verwenden. In diesem Fall wird das Bearbeiten des Snippets den Inhalt der Antwort in allen Intents aktualisieren.

Verwenden Sie den RB_SNIPPET um ein Snippet mittels Dialogflow-Intents zu senden. Das auslösende Intent wird mit dem Snippet-Inhalt reagieren.

Verwenden des Snippet Parameters

Mit RB_SNIPPET können Sie ein Snippet als Antwort senden. Setzen Sie den Wert des Parameters auf die Snippet-ID, die Sie senden möchten.

Beim Aktualisieren oder Ändern des Namens oder Inhalts eines Snippets wird die vorhandene Snippet-ID beibehalten.

Dateien senden

Dateien können manuell im Inbox Modul gesendet oder mit Hilfe von Parametern in Dialogflow Intents gesendet werden.

Mit Hilfe des Parameters RB_FILE können Sie im Dateimanager gespeicherte Dateien an Kontakte senden, die eine Dialogflusseingabe auslösen.

Datei-Parameter verwenden

Bevor Sie eine Datei senden können, müssen Sie die Datei(en) in die respond.io Dateimanager hochladen. Verwenden Sie dann den RB_FILE Parameter mit der Datei ID als Wert, um eine Datei an einen Kontakt zu senden.

Es werden nur Dateien gesendet, die mit dem Dialogflow verbunden sind. In andere Bereiche hochgeladene Dateien werden nicht an den Kontakt gesendet.

Diesen Artikel teilen
Telegram
Facebook
Linkedin
Twitter

Verwandte Artikel 👩‍💻

Dialogflow: Fulfillment-Webhook-Anforderung
Erfahren Sie, wie Sie Fulfillment Webhook Requests verwenden, um Daten von respond.io an Dialogflow zu übergeben.
Dialogflow: Eigene Payloads
Erfahren Sie mehr über die unterstützten Custom Payloads auf respond.io.
Dialogfluss: Antwortvorlagen
Erfahren Sie, wie Sie Antwortvorlagen verwenden, um Antworten an Kontakte zu senden.
Dialogfluss: Ereignisse
Erfahren Sie, wie Sie Ereignisse verwenden, um Dialogflow Intentionen auszulösen.
Dialogfluss: Intent verwalten
Personalisieren Sie die Antworten des Chatbots, indem Sie die Absichten konfigurieren.

Sie können nicht finden, was Sie suchen? 🔎