Verbindungen
Aktualisiert am
Verbinden Sie die Dienste, mit denen Ihr Unternehmen arbeitet, und Ihr Chatbot und seine Workflows nutzen sie: So fragen sie eine Bestellung ab, rufen Ihre eigene API auf oder handeln über Ihren Tool-Server, immer für den Kunden, mit dem sie gerade sprechen.
All das richten Sie in Ihrem Dashboard unter Tools ein. Sobald ein Dienst verbunden ist, nutzt der Chatbot ihn, wenn eine Unterhaltung es erfordert, und in einem Workflow kann ein Schritt vom Typ Tool nutzen jedes Tool des Dienstes aufrufen. Jeder Aufruf erscheint im Protokoll der Unterhaltung.
Ihre API
Eine benutzerdefinierte Aktion ist einer Ihrer eigenen HTTP-Endpunkte, einmal beschrieben, damit das Modell weiß, wann es ihn aufrufen soll: eine Bestellung abfragen, ein Ticket anlegen, einen Termin buchen. Die App führt den Aufruf für den Chatbot aus, sodass Ihr API-Schlüssel nie das Modell oder den Besucher erreicht.
- Klicken Sie unter Tools bei der Kachel Ihre API auf +. Die Karte Eigene Aktionen öffnet sich mit einer neuen Aktion zum Ausfüllen; für weitere klicken Sie später auf Aktion hinzufügen.
- Geben Sie ihr einen Namen, etwa
get_order_status, und eine Beschreibung für das Modell, die sagt, was sie tut und wann sie zu verwenden ist. - Wählen Sie die Methode und geben Sie die URL ein. Ein
{param}im Pfad wird aus den Parametern gefüllt; die übrigen kommen bei GET in den Query-String, sonst in den JSON-Body. - Führen Sie die Parameter auf, einen pro Zeile: Name, Typ, „required“ oder „optional“ und eine Beschreibung, etwa
order_id, string, required, Die Bestellnummer. - Fügen Sie die Header hinzu, die Ihre API braucht, etwa
Authorization: Bearer …. Ein gespeicherter Wert erscheint danach nur noch als Punkte und wird nie an Ihren Browser zurückgeschickt. - Speichern Sie und klicken Sie dann auf Testen, um die Aktion mit Beispielwerten aufzurufen und genau zu sehen, was das Modell erhalten würde.
Jeder Aufruf teilt Ihrem Endpunkt mit, für wen er ist: die Person in X-User-Id und die Unterhaltung in X-Session-Id, sofern Sie diese Header nicht selbst setzen. Auf Ihrer Website steht für die Person die ID, die ChatFrom dem Besucher gibt (visitor: und eine Browser-ID), nicht die ID Ihres eigenen Nutzers; ein Test sendet Ihre ChatFrom-Nutzer-ID. Die Parameter füllt der Chatbot aus, und ein Kunde kann ihn dazu bringen, jeden beliebigen Wert einzusetzen. Wenn Ihr Endpunkt also die Daten eines bestimmten Kunden liest oder ändert, prüfen Sie dort, ob diese Person das darf. Um im Namen Ihrer angemeldeten Nutzer zu handeln, nutzen Sie Ihren Tool-Server.
Ihr Tool-Server
Wenn Ihr Produkt einen MCP-Server betreibt, kann der Chatbot dessen Tools direkt nutzen. Klicken Sie unter Tools bei der Kachel MCP-Server auf +. Tragen Sie in der Karte MCP-Server, die sich öffnet, den Namen und die Adresse des Servers ein, dazu alle Header, die er braucht, etwa ein Token. Klicken Sie auf Tools finden und haken Sie die Tools an, die der Chatbot nutzen darf, bis zu 50; das Modell sieht nichts anderes auf dem Server. Ein Token wird verschlüsselt gespeichert und erscheint nach dem Speichern als Punkte. Die Adresse muss im öffentlichen Internet liegen: ChatFrom prüft beim Speichern, wohin sie zeigt, und im Laufe der Unterhaltungen erneut, und lässt den Server außen vor, solange sie in ein privates Netzwerk zeigt.
Haken Sie Das Token des auf der Website angemeldeten Nutzers an diesen Server senden bei einem Server an, den Ihre eigene Website betreibt. Wenn die Seite, die das Widget einbettet, ein Token übergibt, das sie für ihren Nutzer signiert hat, erhält Ihr Server es als X-User-Id und kann für dieses Konto handeln, für kein anderes. In den Chat-Apps verknüpfen Nutzer ihr Konto einmalig und erhalten dasselbe, wie die Anleitung Kanäle erklärt.
Zapier
Zapier erreicht über einen eigenen MCP-Server Tausende Apps wie Gmail, Slack oder Airtable. So kann der Chatbot mit den Aktionen, die Sie auswählen, eine E-Mail entwerfen oder eine Nachricht posten.
- Fügen Sie auf mcp.zapier.com einen MCP-Server hinzu, wählen Sie Other als Client und stellen Sie ihn auf den Modus Managed. Fügen Sie die Aktionen hinzu, die der Chatbot ausführen darf, etwa „Send a Slack message“.
- Generieren Sie in den Einstellungen des Servers ein API-Token und kopieren Sie es. Zapier zeigt es nur einmal an.
- Fügen Sie unter Tools einen MCP-Server mit dem Namen
zapierund der Adressehttps://mcp.zapier.com/api/v1/connecthinzu, dazu den HeaderAuthorization: Bearer, gefolgt von Ihrem Token. - Klicken Sie auf Tools finden, haken Sie die Aktionen an, die der Chatbot nutzen darf, und speichern Sie.
Nutzen Sie den Modus Managed. Im Modus Agentic könnte die KI während einer Unterhaltung eigene Aktionen hinzufügen, was ein öffentlich zugänglicher Chatbot nicht tun sollte. Dem Chatbot werden immer nur die Aktionen angeboten, die Sie angehakt haben, und jede, die er ausführt, verbraucht zwei Tasks Ihres Zapier-Tarifs.
Angemeldete Nutzer auf Ihrer Website
Damit der Chatbot im Namen der Person handeln kann, die auf Ihrer Website angemeldet ist, gibt die Seite dem Widget ein Token, das Ihr Server für diesen Nutzer signiert hat, im selben Script-Tag, das Sie unter Einbinden kopiert haben.
- Wie das Token aussehen darf: bis zu 1.024 Buchstaben, Ziffern und
._~-, etwa ein JWT oder ein base64url-String. Ein Token mit einem anderen Zeichen, etwa dem+,/oder=von einfachem base64, wird verworfen, als hätte die Seite keines übergeben. - Wohin es geht: Das Widget übergibt es per
postMessagean den Chat, nie in einer Adresse, damit es nicht in Request-Logs landet. Es erreicht nur die Tool-Server, die Sie dafür angehakt haben, alsX-User-Id: nicht das Modell, nicht Ihre anderen Tools und nicht das Protokoll der Unterhaltung. ChatFrom liest es nie; Ihr Server prüft es und handelt nur für dieses Konto. - Eine Seite, die stundenlang offen ist: Rufen Sie
window.ChatFrom.setUserToken(token)mit einem neuen Token auf, bevor das alte abläuft, und mitnull, wenn sich der Nutzer abmeldet. Jeder Chatbot auf der Seite übernimmt es. - Eine Single-Page-App: Auf einer Seite, die den Chatbot nicht haben soll, entfernt
window.ChatFrom.remove()das Widget, oderwindow.ChatFrom.remove(id)einen von mehreren Chatbots. Wird das Script-Tag erneut eingefügt, ist das Widget wieder da.
Ein anderer Dienst
Alles mit einer API erreichen Sie über Ihre API, Ihren Tool-Server oder Zapier. Soll ein Dienst fest eingebaut werden? Sagen Sie es uns.