Zum Inhalt springen
Dokumentation

Chat-Formulare: Angaben in einem Schritt abfragen

Erstelle kurze Formulare mit bis zu 20 Feldern, etwa eine Angebotsanfrage oder eine Retoure, die der Agent passend unter seiner Antwort zeigt. Einsendungen landen im Tab Leads, per E-Mail, in Slack, per Webhook und bei einem eigenen Webhook des Formulars.

Ein Chat-Formular fragt mehrere Angaben auf einmal ab, etwa wofür ein Besucher ein Angebot braucht oder eine Bestellnummer und den Grund für eine Retoure, statt dass der Agent Frage für Frage nachhakt. Du erstellst das Formular im Tab Actions (Aktionen). Wann es erscheint, entscheidet der Agent. Die Felder sind immer die, die du festgelegt hast.

Formular anlegen

  1. Geh im Tab Actions zu Forms unter deinen Aktionen und klicke auf Add form.
  2. Fülle die Felder aus:
    • Name: wird Besuchern als Titel des Formulars angezeigt. Bis zu 60 Zeichen.
    • When to show it (wann es erscheint): liest der Agent, Besucher sehen es nicht. Beschreib in bis zu 1.000 Zeichen die Momente, in denen das Formular hilft. Zum Beispiel: „Wenn der Besucher nach einem Preis für eine Sonderanfertigung fragt oder ein Angebot für mehrere Artikel möchte.“
    • Fields: was das Formular abfragt, bis zu 20 Felder. Jedes hat ein Label (Beschriftung) mit bis zu 60 Zeichen, einen Type (Typ) und ein Kästchen Required (Pflichtfeld). Zwei Felder dürfen nicht dieselbe Beschriftung haben. Mit den Pfeilen änderst du die Reihenfolge.
    • Button text: optional, bis zu 30 Zeichen. Bleibt das Feld leer, sehen Besucher „Senden“ in ihrer eigenen Sprache.
    • Message after sending (Nachricht nach dem Senden): optional, bis zu 300 Zeichen. Bleibt das Feld leer, sehen Besucher ein kurzes Dankeschön in ihrer eigenen Sprache.
  3. Lass Agent can show this form eingeschaltet, prüf die Preview (Vorschau) und klicke auf Add form.
TypWas der Besucher eingibt
Short textBis zu 200 Zeichen
Long textBis zu 2.000 Zeichen
EmailEine E-Mail-Adresse, vor dem Senden geprüft
PhoneEine Telefonnummer mit bis zu 30 Zeichen, vor dem Senden geprüft
NumberEine Zahl wie 12 oder 12.5, auch mit Komma
DateEin Datum, ausgewählt in einem Datumsfeld
DropdownEine deiner Auswahlmöglichkeiten. Gib eine pro Zeile ein, bis zu 20 mit jeweils bis zu 60 Zeichen.

Name, Beschriftungen, Auswahlmöglichkeiten, Buttontext und Nachricht sehen Besucher genau so, wie du sie schreibst. Schreib sie also in der Sprache deiner Besucher. Der Rest des Formulars, etwa „(freiwillig)“, Fehlermeldungen, das voreingestellte „Senden“ und das voreingestellte Dankeschön, folgt Widget language im Tab Aussehen.

Formulare verwalten

Jedes Formular in der Liste trägt das Badge Form und zeigt die Zahl seiner Felder und Einsendungen.

  • Der Schalter Enabled hält den Agenten davon ab, das Formular anzubieten, ohne es zu löschen. Ein Formular, das schon in einem Chat zu sehen war, zeigt dann „Dieses Formular ist nicht mehr verfügbar.“
  • Edit öffnet das Formular. Benennst du ein Feld um oder entfernst es, bleiben die Antworten erhalten, die Besucher schon geschickt haben. Erscheint ein Formular erneut in einem Chat, etwa nach einem Neuladen, zeigt es deine aktuelle Fassung.
  • Der Papierkorb-Button löscht das Formular mit allen Einsendungen. Das lässt sich nicht rückgängig machen, exportiere die Einsendungen also vorher im Tab Leads, wenn du sie behalten willst.

Ein Agent kann bis zu 10 Formulare haben. Formulare zählen nicht zum Limit von 25 Aktionen.

Wann der Agent ein Formular zeigt

Der Agent liest When to show it für jedes eingeschaltete Formular. Passt das Gespräch, zeigt er das Formular unter seiner Antwort und erwähnt es in einem kurzen Satz. Dieselben Angaben fragt er nicht im Chat ab.

  • Das Formular entsteht aus dem Formular, das du gespeichert hast. Das KI-Modell entscheidet nur, wann es erscheint, nie, was es abfragt.
  • Der Agent zeigt höchstens ein Formular unter einer Antwort.
  • Unter einer Antwort, die schon das Lead-Formular zeigt, weil eine deiner Regeln es ausgelöst hat, erscheint kein Formular.
  • In temporären Chats erscheinen keine Formulare, denn dort wird nichts gespeichert. Der Agent bittet den Besucher stattdessen, in sein gespeichertes Gespräch zurückzukehren.

Formulare erscheinen in der Chat-Bubble, im iframe, über den Direktlink, auf der Hilfeseite und im Playground. Sie werden mit der Antwort gespeichert und sind daher auch in den Verläufen im Tab Conversations zu sehen. Why this answer führt sie unter Actions called als „Form“ auf.

Was Besucher tun

Der Besucher füllt das Formular unter der Antwort aus und klickt auf den Button. Pflichtfelder sowie Antworten zu E-Mail, Telefon, Zahl und Datum werden vor dem Senden geprüft. Danach zeigt das Formular deine Message after sending.

Jedes Formular lässt sich pro Gespräch einmal abschicken. Danach erscheint es als gesendet, auch wenn der Besucher die Seite neu lädt.

Einsendungen im Tab Leads

Im Tab Leads listet die Karte Form submissions, was Besucher geschickt haben. Wähle unter Form ein Formular, um seine Einsendungen zu sehen, die neuesten zuerst, 20 pro Seite, mit den Antworten und einem Link zum Gespräch.

  • Refresh lädt neue Einsendungen.
  • Export CSV lädt bis zu 10.000 der neuesten Einsendungen des gewählten Formulars herunter. Die Datei hat die Spalten Submitted at (UTC), eine Spalte pro Feld mit seiner aktuellen Beschriftung, in der Reihenfolge des Formulars, und Conversation ID. Ein entferntes Feld bekommt eine Spalte dahinter, wenn eine Einsendung es beantwortet hat. Antworten, die mit =, +, - oder @ beginnen, bekommen ein Apostroph vorangestellt, damit Tabellenprogramme sie nicht als Formel lesen.
  • Der Papierkorb-Button löscht eine Einsendung. Bereits verschickte Webhooks und E-Mails betrifft das nicht.

Benachrichtigungen

  • E-Mail: Jede Einsendung geht per E-Mail an die Empfänger deiner Lead-Benachrichtigungen, aber nur, solange Email when a new lead arrives an ist. Der Betreff lautet New ", gefolgt vom Namen des Formulars, " form from und dem Namen des Agenten. Die E-Mail listet die Antworten und den Zeitpunkt, mit einem Button See the conversation. Hat das Formular ein E-Mail-Feld, geht eine Antwort an die Adresse, die der Besucher eingegeben hat. Jeder Agent verschickt höchstens 30 Formular-E-Mails pro Stunde, getrennt von den Lead-Benachrichtigungen; Einsendungen darüber hinaus werden trotzdem gespeichert.
  • Slack: Hake in der Karte Slack alerts unter Post a message for die Option Form submission an. Siehe Slack-Benachrichtigungen.
  • Webhooks: Lass einen Webhook Form submitted empfangen, um das Event form.submitted mit den Antworten aller Formulare zu bekommen. Siehe Webhooks.
  • Der eigene Webhook des Formulars: schickt nur die Einsendungen dieses Formulars an eine Adresse; siehe unten.

Ein Webhook für ein einzelnes Formular

Jedes Formular kann einen eigenen Webhook haben, etwa um Angebotsanfragen an dein CRM und Rücksendeanfragen an dein Shopsystem zu schicken. Er bekommt nur die Einsendungen dieses Formulars.

  1. Klicke im Tab Actions bei einem gespeicherten Formular auf Edit. Webhook for this form steht unten im Editor. Ein neues Formular bekommt ihn, sobald du es hinzugefügt hast.
  2. Füge unter Endpoint URL die Adresse ein, die dein Server oder dein Tool für eingehende Webhooks nennt, und klicke auf Add webhook. Die Adresse muss mit https:// beginnen und auf einen öffentlichen Server zeigen, wie bei den Webhooks des Agenten.
  3. Kopiere das angezeigte Signing Secret, leg es dort ab, wo dein Empfänger es lesen kann, und klicke auf I've saved it. Vollständig siehst du es nur dieses eine Mal.
  4. Klicke auf Send test event, um die Verbindung zu prüfen.

Der Bereich speichert von selbst, unabhängig vom Formular. Sein Schalter Active pausiert die Zustellungen, Save address ändert die Adresse, New secret ersetzt das Secret, Remove löscht den Webhook samt Zustellverlauf, und Recent deliveries zeigt die letzten 20 Zustellungen mit einem Button Resend für fehlgeschlagene. Die Formularliste zeigt „own webhook“ neben einem Formular, das einen hat.

  • Er sendet das Event form.submitted, mit demselben Inhalt, derselben Signatur, denselben Wiederholungen und demselben Zustellprotokoll wie die Webhooks des Agenten. Seine Events lassen sich nicht ändern.
  • Er zählt nicht zu den 5 Webhooks des Agenten und steht nicht in der Karte Webhooks im Tab Leads.
  • Die eigenen Webhooks des Agenten, die Form submitted empfangen, bekommen weiterhin die Einsendungen aller Formulare, auch dieses. Sollen die Einsendungen eines Formulars nur an seinen eigenen Webhook gehen, entferne bei den Webhooks des Agenten das Häkchen bei Form submitted.
  • Wird das Formular gelöscht, wird auch sein Webhook gelöscht. Ein duplizierter Agent bekommt Kopien der Formulare ohne ihre Webhooks.
  • Den Webhook hinzufügen oder entfernen, seine Adresse ändern und ein neues Secret erstellen dürfen nur die Rolle Admin und der Owner des Kontos; Editoren können ihn ein- und ausschalten und ein Test-Event senden. Siehe Teammitglieder und Rollen.

Agenten duplizieren

Ein duplizierter Agent bekommt Kopien der Formulare, ohne die eigenen Webhooks der Formulare. Die Einsendungen bleiben beim Original.

Als Markdown anzeigen