Kanäle
Aktualisiert am
Der Chatbot, den Sie für Ihre Website erstellt haben, kann auch in WhatsApp, Telegram, Slack, Discord, Ihrer Crisp-Chatbox und Ihrem Support-Postfach antworten, mit demselben Wissen, denselben Tools und Workflows, und jede Unterhaltung landet im selben Protokoll.
Bevor Sie beginnen, erstellen Sie Ihren Chatbot und schalten Sie ihn unter Einbinden live. In diesen Apps antwortet er nur, solange er live ist. Jede App ist in wenigen Minuten eingerichtet, unter Kanäle in Ihrem Dashboard und in der App selbst. Wie Sie denselben Chatbot in Ihre eigene iPhone- oder iPad-App bringen, steht in der Anleitung iOS-SDK.
Wenn Ihr Chatbot den Nutzer kennen muss
Viele Chatbots beantworten nur Fragen, und dann sind Sie hier schon fertig. Wenn Ihrer auch im Namen eines angemeldeten Nutzers handelt, etwa um dessen Projekte anzuzeigen oder ein neues anzulegen, muss er wissen, wer schreibt. Auf Ihrer Website übergibt das Widget das Token Ihres angemeldeten Nutzers bereits an Ihren Tool-Server. In Telegram, Slack, Discord, WhatsApp und per E-Mail gibt es keine Seite, die es übermitteln könnte, deshalb verknüpft jeder Nutzer sein Konto einmalig. (Crisp ist die Ausnahme: Ihre Website übergibt das Token direkt an die Chatbox, wie die Crisp-Anleitung zeigt.)
So funktioniert es für Ihre Nutzer
- In einem privaten Chat mit dem Bot senden die Nutzer in Telegram
/connect, in Slack oder Discordconnectals Direktnachricht. In einer Gruppe, einem Channel oder auf einem Server verweist der Bot sie stattdessen an einen privaten Chat, damit niemand sonst den Link sieht. - Der Bot antwortet mit einem Button, der zu einer Seite auf Ihrer Website führt.
- Dort melden sie sich wie gewohnt bei Ihrem Produkt an und bestätigen, dass der Chat ihnen gehört.
- Von da an handelt der Chatbot in ihrem Namen, wenn sie allein mit ihm chatten, genau wie im Widget auf Ihrer Website. In einer Gruppe antwortet er ihnen wie allen anderen, damit nichts aus ihrem Konto bei den anderen ankommt.
Nutzer können jederzeit /disconnect oder disconnect senden, um die Verknüpfung aufzuheben. Wenn Sie die App unter Kanäle trennen, wird jede Verknüpfung aufgehoben, die über sie entstanden ist.
Was Sie Ihrem Produkt hinzufügen
Sie brauchen nur eine neue Seite. Ihr Tool-Server ändert sich nicht: Er erhält dasselbe Token im selben Header wie vom Widget.
- Eine Seite, die eine Anmeldung erfordert, zum Beispiel
https://yourapp.com/connect-chatfrom. Der Button im Chat öffnet sie und hängt?chatfrom_code=…an die Adresse an. - Zeigen Sie, wer fragt. Fragen Sie ChatFrom, wem der Code gehört, und zeigen Sie es mit einem Button zum Bestätigen an, etwa „Telegram @anna mit Ihrem Konto verbinden?“
- Wenn der Nutzer bestätigt, senden Sie den Code an ChatFrom, zusammen mit einem Token derselben Art, wie Ihre Website es dem Widget für diesen Nutzer gibt.
ChatFrom antwortet mit { "linked": true }, und der Nutzer erhält in seinem Chat eine Nachricht, dass sein Konto verknüpft ist. account ist optional: So heißt das Konto in Ihrem Produkt, und so wird es dem Nutzer angezeigt. Ein Code gilt nur einmal und nur fünfzehn Minuten lang; danach antworten beide Aufrufe mit 404, und der Nutzer sendet erneut connect. Ein 503 bedeutet, dass ChatFrom den Code in dem Moment nicht prüfen konnte; ein neuer Versuch kurz darauf kann klappen.
Lassen Sie Ihren Coding-Agenten die Seite bauen
Wenn Sie mit einem Coding-Agenten wie Claude Code, Cursor oder Copilot arbeiten, öffnen Sie ihn im Code Ihres Produkts und kopieren Sie diesen Prompt hinein. Er baut die Seite, verwendet das Token wieder, das Ihr Widget bereits bekommt, und nennt Ihnen die Adresse, die Sie in ChatFrom eintragen. Denselben Prompt finden Sie auch auf der Seite Kanäle in Ihrem Dashboard, mit dem Namen Ihres Chatbots bereits eingesetzt.
Add a "Connect your chat account" page to our app, so users can link their Telegram, Slack, Discord or WhatsApp chat with our ChatFrom chatbot to their account here. ChatFrom already sends our signed-in users' token to our tool server from the website widget; this page lets a Telegram, Slack, Discord or WhatsApp user hand over the same token once, so the chatbot can act for them in the chat too.
How the flow works:
1. In Telegram, Slack, Discord or WhatsApp, the user sends "connect" to the bot. The bot replies with a button to our page: https://<your app>/connect-chatfrom?chatfrom_code=<code>. The code is one-time and expires after 15 minutes.
2. Our page requires the user to be signed in, using our normal login. If they are not signed in, send them to log in and bring them back to this page with the chatfrom_code kept.
3. Our server asks ChatFrom who the code belongs to:
GET https://chatfrom.io/api/channels/link/<code>
200: { "chatbot": "...", "channel": "telegram", "display_name": "@anna", "expires_at": "..." }
"channel" names the chat app: "telegram", "slack", "discord", "whatsapp", "email" today, and more may come. Accept any value: show the known ones by name and anything else as "your chat app". Never treat an unfamiliar channel as an error. "display_name" is the user's name in that app and may be null when the app would not say; then show a wording without it, such as "Connect this Slack chat to your account?".
404: { "error": "..." } (unknown, used or expired code)
503: { "error": "..." } (ChatFrom could not check the code just now; offer to try again in a moment)
4. Show a confirmation, for example: "Connect Telegram @anna to your account <their email>?" with a "Yes, connect" button and a "Cancel" link. This step is required: without it, someone could send their own code to another person and link that person's account without them noticing.
5. When they confirm, our server links the account:
POST https://chatfrom.io/api/channels/link/<code>
Content-Type: application/json
{ "user_token": "<token for this user>", "account": "<how we name the account, e.g. their email>" }
200: { "linked": true, "channel": "...", "display_name": "..." }
404: the code has expired or was already used; tell the user to send "connect" again in the chat.
400: user_token is missing or not URL-safe.
6. Show a result page: "Linked. You can go back to the chat." The user also gets a message in the chat.
Requirements:
- user_token must be the same kind of token we already give the ChatFrom widget as data-user-token for this user (reuse the function that makes it). ChatFrom never decodes it; it sends it as the X-User-Id header to our tool server (MCP), which already knows how to check it. Do not change the tool server.
- The token can be at most 1024 characters of A-Z, a-z, 0-9 and . _ ~ -.
- Choose its lifetime on purpose. If our widget tokens expire quickly, issue a longer-lived one here, because a linked chat keeps using it until the user unlinks, and the user has to link again when it expires. Our tool server should still reject it when the account is deleted or signed out everywhere.
- Call both ChatFrom endpoints from our server, not from the browser. Never put the token in a URL or log it.
- Protect the confirm POST against cross-site request forgery, as with every other form in our app.
- Treat a 404 from either call as "link expired" with a friendly page, not an error.
- Match the look of our other account pages. No new dependencies unless we already use them.
When it is done:
- Tell me the page's full address, so I can enter it in ChatFrom under Channels, "Your link page".
- Add a short test for the confirm step and for the expired-code case, in the style of our existing tests.
- Explain how to try it: send /connect to the Telegram bot (or "connect" to the Slack app, the Discord bot or the WhatsApp number in a direct message), open the button, sign in, confirm, and check the chat says the account is linked.In ChatFrom
Tragen Sie unter Kanäle die Adresse Ihrer Seite in das Feld Ihre Verknüpfungsseite ein und speichern Sie. Bis dahin sagt der Bot den Nutzern, dass er keine Konten verknüpft, und beantwortet weiterhin allgemeine Fragen.
Zwei Entscheidungen
- Behalten Sie den Bestätigungsschritt bei und schützen Sie ihn. Damit kann der Nutzer prüfen, dass der Chat wirklich ihm gehört. Ohne diesen Schritt könnte jemand seinen eigenen Code an eine andere Person schicken und ihn von ihr unbemerkt mit ihrem Konto verknüpfen lassen. Schützen Sie die Bestätigungsanfrage wie jedes Formular Ihrer Website gegen Cross-Site-Anfragen, sonst kommt eine Seite, die den Code selbst absendet, an der Bestätigung vorbei.
- Legen Sie fest, wie lange das Token gilt. Wenn die Tokens, die Sie dem Widget geben, nach einer Stunde ablaufen, handelt ein verknüpfter Chat nach einer Stunde nicht mehr im Namen des Nutzers, und der Nutzer muss ihn neu verknüpfen. Stellen Sie für Chat-Verknüpfungen ein Token aus, das so lange gilt, wie ein verknüpfter Chat aus Ihrer Sicht im Namen des Nutzers handeln darf, und lehnen Sie es auf Ihrem Server ab, wenn sich der Nutzer überall abmeldet oder sein Konto löscht.
Was Ihre Nutzer tun können
| In WhatsApp | In Telegram | In Slack | In Discord | In Crisp | Per E-Mail | Was es bewirkt |
|---|---|---|---|---|---|---|
| Jede Textnachricht | Jede Textnachricht | Eine Direktnachricht oder eine Erwähnung in einem Channel | Eine Direktnachricht oder eine Erwähnung oder Antwort auf einem Server | Jede Nachricht in der Chatbox | Jede E-Mail an die Adresse | Stellt dem Chatbot eine Frage |
| Ein Foto oder ein Dokument | Ein Foto oder ein Dokument, in einem privaten Chat | Nicht verfügbar | Eine Datei, in einer Direktnachricht | Eine Datei in der Chatbox | Nicht verfügbar | Der Chatbot liest sie und antwortet dazu, wenn Besucher Dateien anhängen dürfen |
| new | /new | new | new | Nicht verfügbar | new | Beginnt eine neue Unterhaltung |
| connect | /connect | connect | connect | Nicht verfügbar | connect | Verknüpft das Konto auf Ihrer Website, in einem privaten Chat |
| disconnect | /disconnect | disconnect | disconnect | Nicht verfügbar | disconnect | Hebt die Verknüpfung auf |
In Crisp gibt es keine Befehle: Eine Unterhaltung läuft weiter, bis ein Tag ohne Nachricht vergeht (wie in WhatsApp, Telegram, Slack und Discord), den angemeldeten Nutzer liefert die Chatbox selbst, und Antworten per E-Mail sowie Unterhaltungen, an denen Ihr Team beteiligt ist, bleiben Ihrem Team im Crisp-Posteingang überlassen. Dateien richten sich nach dem Schalter Besucher können Dateien anhängen unter Einbinden: Ist er an, liest der Chatbot in einem Chat mit nur einer Person eine PDF-, Text-, Markdown- oder CSV-Datei oder ein Foto und nimmt den Begleittext als Frage; ist er aus, bittet der Chatbot um Text (in Crisp überlässt er die Datei Ihrem Team). In einer Gruppe oder einem Kanal auf einem Server werden Dateien nicht gelesen, damit eine Gruppe Ihre Credits nicht für Bilder verbrauchen kann. Alles andere funktioniert wie auf Ihrer Website. Der Chatbot antwortet aus Ihrem Wissen, nutzt Ihre Tools und übergibt an einen Menschen, und seine Antworten werden auf Ihr monatliches Kontingent angerechnet. Wenn ein Workflow den Nutzer etwas auswählen lässt, erscheinen die Optionen als Buttons. Eine Unterhaltung läuft weiter, bis ein Tag ohne Nachricht vergeht, per E-Mail zwei Wochen, und jede Unterhaltung erscheint unter Unterhaltungen, gekennzeichnet mit der App, aus der sie kam.
Die erste Antwort jeder Unterhaltung beginnt in jeder App mit „Sie chatten mit einem KI-Assistenten“. Die EU-KI-Verordnung (AI Act) verlangt, dass Menschen erfahren, wenn sie mit einer KI sprechen, sofern das nicht ohnehin offensichtlich ist. Deshalb ist dieser Hinweis an, außer Sie schalten Besuchern zeigen, dass es ein KI-Assistent ist unter Einbinden aus.
Datenschutz
Ihre Meta-App und WhatsApp-Nummer, der Telegram-Bot, die Slack-App, der Discord-Bot und Ihr Crisp-Workspace gehören Ihnen und liegen in Ihrem eigenen Konto beim jeweiligen Dienst. Nachrichten laufen in Ihrem Auftrag über diese Dienste; nennen Sie sie deshalb neben ChatFrom in Ihrer eigenen Datenschutzerklärung. ChatFrom speichert deren Tokens und Secrets sowie die Tokens verknüpfter Konten verschlüsselt. Was ChatFrom speichert, steht in unserer Datenschutzerklärung und unserem Auftragsverarbeitungsvertrag (AVV).