Kanały
Zaktualizowano
Chatbot zbudowany dla Twojej strony może odpowiadać także w WhatsAppie, Telegramie, Slacku, na Discordzie, w oknie czatu Crisp i w Twojej skrzynce obsługi klienta, z tą samą wiedzą, narzędziami i workflowami, a wszystkie rozmowy trafiają do jednego dziennika.
Zanim zaczniesz, zbuduj swojego chatbota i uruchom go w sekcji Deploy. W tych aplikacjach odpowiada tylko wtedy, gdy jest uruchomiony. Konfiguracja każdej aplikacji zajmuje kilka minut, w sekcji Channels w Twoim panelu i w samej aplikacji. Jeśli chcesz umieścić tego samego chatbota we własnej aplikacji na iPhone'a lub iPada, zajrzyj do przewodnika SDK na iOS.
Gdy Twój chatbot musi wiedzieć, kim jest użytkownik
Wiele chatbotów tylko odpowiada na pytania i w ich przypadku nie musisz nic więcej robić. Jeśli Twój chatbot działa też w imieniu zalogowanego użytkownika, na przykład pokazuje jego projekty albo tworzy nowy, musi wiedzieć, kto pisze. Na Twojej stronie widżet już przekazuje token zalogowanego użytkownika do Twojego serwera narzędzi. W Telegramie, Slacku, na Discordzie, w WhatsAppie i w poczcie e-mail nie ma strony, która mogłaby go przekazać, więc każdy użytkownik raz łączy swoje konto. (Wyjątkiem jest Crisp: Twoja strona przekazuje token bezpośrednio do okna czatu, jak pokazuje przewodnik po Crispie.)
Jak to działa dla Twoich użytkowników
- Na czacie prywatnym z botem wysyłają
/connectw Telegramie alboconnectw wiadomości bezpośredniej w Slacku lub na Discordzie. W grupie, na kanale lub na serwerze bot odsyła ich do prywatnego czatu, żeby nikt inny nie zobaczył linku. - Bot odpowiada przyciskiem, który prowadzi do strony w Twojej witrynie.
- Logują się do Twojego produktu jak zwykle i potwierdzają, że czat należy do nich.
- Od tej pory na czacie sam na sam z użytkownikiem chatbot działa w imieniu tego zalogowanego użytkownika, dokładnie tak jak w widżecie na Twojej stronie. W grupie odpowiada mu tak jak każdemu innemu, więc nic z jego konta nie trafia do pozostałych.
W każdej chwili mogą wysłać /disconnect lub disconnect, żeby odłączyć konto. Odłączenie aplikacji w sekcji Channels odłącza wszystkie konta, które zostały przez nią połączone.
Co dodać do swojego produktu
Potrzebujesz jednej nowej strony. Twój serwer narzędzi się nie zmienia: dostaje ten sam token, w tym samym nagłówku, co z widżetu.
- Strona wymagająca zalogowania, na przykład
https://yourapp.com/connect-chatfrom. Przycisk na czacie otwiera ją z?chatfrom_code=…dopisanym do adresu. - Pokaż, kto pyta. Zapytaj ChatFrom, do kogo należy kod, i pokaż to razem z przyciskiem potwierdzenia, na przykład „Połączyć Telegram @anna z Twoim kontem?”.
- Gdy użytkownik potwierdzi, wyślij kod do ChatFrom razem z tokenem tego samego rodzaju, jaki Twoja strona przekazuje widżetowi dla tego użytkownika.
ChatFrom zwraca { "linked": true }, a użytkownik dostaje na czacie wiadomość, że jego konto jest połączone. Pole account jest opcjonalne: to nazwa, pod jaką Twój produkt zna to konto, a użytkownik zobaczy ją w tej wiadomości. Kodu można użyć tylko raz i tylko przez piętnaście minut; potem oba wywołania zwracają 404, a użytkownik wysyła connect jeszcze raz. Odpowiedź 503 oznacza, że ChatFrom nie mógł akurat sprawdzić kodu, a ponowna próba za chwilę może się udać.
Niech zbuduje ją Twój agent kodujący
Jeśli pracujesz z agentem kodującym, takim jak Claude Code, Cursor czy Copilot, otwórz go w kodzie swojego produktu i wklej mu ten prompt. Agent zbuduje stronę, użyje tokenu, który Twój widżet już dostaje, i poda Ci adres do wpisania w ChatFrom. Ten sam prompt, z już wpisaną nazwą Twojego chatbota, jest na stronie Channels w Twoim panelu.
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.W ChatFrom
W sekcji Channels wpisz adres swojej strony w polu Your link page i zapisz. Dopóki tego nie zrobisz, bot mówi użytkownikom, że nie łączy kont, i nadal odpowiada na ogólne pytania.
Dwie decyzje do podjęcia
- Zostaw krok potwierdzenia i go zabezpiecz. Dzięki niemu użytkownik może sprawdzić, że czat naprawdę należy do niego. Bez niego ktoś mógłby wysłać swój kod innej osobie, a ta nieświadomie połączyłaby go ze swoim kontem. Chroń żądanie potwierdzenia przed żądaniami z innych witryn, jak każdy formularz na swojej stronie, bo inaczej strona, która sama wysyła kod, ominie potwierdzenie.
- Zdecyduj, jak długo ważny jest token. Jeśli tokeny, które przekazujesz widżetowi, wygasają po godzinie, połączony czat po godzinie przestaje działać w imieniu użytkownika i trzeba go połączyć ponownie. Do połączeń z czatami wystawiaj token ważny tak długo, jak długo połączony czat może Twoim zdaniem działać w imieniu użytkownika, i odrzucaj go na swoim serwerze, gdy użytkownik wyloguje się ze wszystkich urządzeń albo usunie konto.
Co mogą robić Twoi użytkownicy
| W WhatsAppie | W Telegramie | W Slacku | Na Discordzie | W Crispie | E-mailem | Co to robi |
|---|---|---|---|---|---|---|
| Dowolna wiadomość tekstowa | Dowolna wiadomość tekstowa | Wiadomość bezpośrednia albo wzmianka na kanale | Wiadomość bezpośrednia albo wzmianka lub odpowiedź na serwerze | Dowolna wiadomość w oknie czatu | Dowolny e-mail na ten adres | Zadaje pytanie chatbotowi |
| Zdjęcie albo dokument | Zdjęcie albo dokument, na czacie prywatnym | Niedostępne | Plik, w wiadomości bezpośredniej | Plik w oknie czatu | Niedostępne | Chatbot odczytuje plik i odpowiada na jego temat, gdy odwiedzający mogą załączać pliki |
| new | /new | new | new | Niedostępne | new | Rozpoczyna nową rozmowę |
| connect | /connect | connect | connect | Niedostępne | connect | Łączy konto użytkownika w Twoim serwisie, na czacie prywatnym |
| disconnect | /disconnect | disconnect | disconnect | Niedostępne | disconnect | Odłącza konto |
W Crispie nie ma poleceń: rozmowa trwa, dopóki nie minie doba bez wiadomości (tak jak w WhatsAppie, Telegramie, Slacku i na Discordzie), zalogowanego użytkownika wskazuje samo okno czatu, a odpowiedzi przychodzące e-mailem i rozmowy, w których uczestniczy Twój zespół, zostają dla zespołu w skrzynce Crispa. Obsługa plików zależy od przełącznika Visitors can attach files w sekcji Deploy: gdy jest włączony, chatbot czyta plik PDF, tekstowy, Markdown lub CSV albo zdjęcie wysłane na czacie z jedną osobą, a podpis traktuje jako pytanie; gdy jest wyłączony, prosi o tekst (w Crispie zostawia plik Twojemu zespołowi). W grupie lub na kanale serwera pliki nie są czytane, więc grupa nie zużyje Twoich kredytów na obrazy. Cała reszta działa tak jak na Twojej stronie. Chatbot odpowiada na podstawie Twojej bazy wiedzy, korzysta z Twoich narzędzi, przekazuje rozmowę człowiekowi, a jego odpowiedzi wliczają się do Twojego miesięcznego limitu. Gdy workflow prosi użytkownika o wybór, opcje pojawiają się jako przyciski. Rozmowa trwa, dopóki nie minie doba bez wiadomości (w e-mailu dwa tygodnie), a każda rozmowa pojawia się w sekcji Conversations, oznaczona aplikacją, z której przyszła.
W każdej aplikacji pierwsza odpowiedź każdej rozmowy zaczyna się od „Rozmawiasz z asystentem AI”. Unijny AI Act wymaga informowania ludzi, że rozmawiają z AI, chyba że jest to oczywiste, dlatego ta informacja jest włączona, dopóki nie wyłączysz przełącznika Tell visitors it's an AI assistant w sekcji Deploy.
Prywatność
Twoja aplikacja Meta i numer WhatsApp, bot w Telegramie, aplikacja w Slacku, bot na Discordzie i Twoja przestrzeń robocza w Crispie należą do Ciebie, na Twoim własnym koncie w każdej z tych usług. Wiadomości przechodzą przez daną usługę w Twoim imieniu, więc wymień te usługi we własnej polityce prywatności, obok ChatFrom. ChatFrom przechowuje ich tokeny i sekrety, a także tokeny połączonych kont, w postaci zaszyfrowanej. To, co przechowuje ChatFrom, opisują nasza polityka prywatności i nasza umowa powierzenia przetwarzania danych (DPA).