Połączenia
Zaktualizowano
Połącz usługi, na których opiera się Twoja firma, a Twój chatbot i jego workflowy będą z nich korzystać: sprawdzą zamówienie, wywołają Twoje własne API albo zadziałają przez Twój serwer narzędzi, zawsze w imieniu klienta, z którym akurat rozmawiają.
Wszystko, co tu opisano, ustawiasz w swoim panelu, w sekcji Tools. Gdy usługa jest połączona, chatbot korzysta z niej, kiedy wymaga tego rozmowa, a krok Use a tool w workflowie może wywołać dowolne z jej narzędzi. Każde wywołanie widać w zapisie rozmowy.
Twoje API
Akcja niestandardowa to jeden z Twoich własnych endpointów HTTP, opisany raz, by model wiedział, kiedy go wywołać: sprawdzenie zamówienia, utworzenie zgłoszenia, rezerwacja terminu. Wywołanie wykonuje ChatFrom w imieniu chatbota, więc Twój klucz API nigdy nie trafia do modelu ani do odwiedzającego.
- W sekcji Tools kliknij + na kafelku Your API. Otworzy się karta Custom actions z nową akcją do wypełnienia; kolejne dodasz później przyciskiem Add action.
- Nadaj jej nazwę, np.
get_order_status, i napisz dla modelu opis: co robi i kiedy jej używać. - Wybierz metodę i wpisz adres URL. Fragment
{param}w ścieżce jest wypełniany z parametrów; pozostałe parametry trafiają przy GET do query stringu, a przy innych metodach do treści JSON. - Wypisz parametry, po jednym w wierszu: nazwa, typ, „required” albo „optional” i opis, np.
order_id, string, required, Numer zamówienia. - Dodaj nagłówki, których potrzebuje Twoje API, np.
Authorization: Bearer …. Zapisana wartość jest odtąd widoczna jako kropki i nigdy nie wraca do Twojej przeglądarki. - Zapisz, a potem kliknij Test, żeby wywołać akcję z przykładowymi wartościami i zobaczyć dokładnie to, co otrzymałby model.
Każde wywołanie mówi Twojemu endpointowi, kogo dotyczy: osobę wskazuje w X-User-Id, a rozmowę w X-Session-Id, chyba że ustawisz te nagłówki samodzielnie. Na Twojej stronie tą osobą jest identyfikator, który ChatFrom nadaje odwiedzającemu (visitor: i identyfikator przeglądarki), a nie użytkownik Twojego własnego systemu; test wysyła Twój identyfikator użytkownika w ChatFrom. Parametry wypełnia chatbot, a klient może go namówić na dowolną wartość, więc jeśli Twój endpoint odczytuje lub zmienia dane konkretnego klienta, sprawdź w nim, czy ta osoba ma do tego prawo. Aby działać w imieniu zalogowanych użytkowników, użyj swojego serwera narzędzi.
Twój serwer narzędzi
Jeśli Twój produkt udostępnia serwer MCP, chatbot może bezpośrednio korzystać z jego narzędzi. W sekcji Tools kliknij + na kafelku MCP server. Na karcie MCP servers, która się otworzy, podaj nazwę i adres serwera oraz potrzebne mu nagłówki, np. token. Kliknij Find tools i zaznacz narzędzia, których chatbot może używać, maksymalnie 50; niczego innego z serwera model nie zobaczy. Token jest przechowywany w postaci zaszyfrowanej i po zapisaniu widać go jako kropki. Adres musi być dostępny w publicznym internecie: ChatFrom sprawdza, dokąd prowadzi, przy zapisie i ponownie w trakcie rozmów, i pomija serwer, dopóki adres wskazuje na sieć prywatną.
Zaznacz pole Send the site's signed-in user token to this server przy serwerze należącym do Twojej własnej witryny. Gdy strona osadzająca widżet przekaże token podpisany dla swojego użytkownika, Twój serwer otrzyma go jako X-User-Id i będzie mógł działać na tym koncie i na żadnym innym. W komunikatorach użytkownicy jednorazowo łączą swoje konto i uzyskują to samo, co wyjaśnia przewodnik Kanały.
Zapier
Zapier łączy się z tysiącami aplikacji, takich jak Gmail, Slack czy Airtable, przez własny serwer MCP, więc chatbot może przygotować szkic e-maila albo wysłać wiadomość za pomocą akcji, które wybierzesz.
- Na stronie mcp.zapier.com dodaj serwer MCP, jako klienta wybierz Other i ustaw tryb Managed. Dodaj akcje, które chatbot może wykonywać, np. „Send a Slack message”.
- W ustawieniach serwera wygeneruj token API i skopiuj go. Zapier pokazuje go tylko raz.
- W sekcji Tools dodaj serwer MCP o nazwie
zapier, z adresemhttps://mcp.zapier.com/api/v1/connecti nagłówkiemAuthorization: Bearer, po którym wpisz swój token. - Kliknij Find tools, zaznacz akcje, których chatbot może używać, i zapisz.
Używaj trybu Managed. Tryb Agentic pozwala AI dodawać w trakcie rozmowy własne akcje, a tego publicznie dostępny chatbot robić nie powinien. Chatbot dostaje zawsze tylko akcje, które zaznaczysz, a każda, którą wykona, zużywa dwa zadania (tasks) z Twojego planu Zapier.
Zalogowani użytkownicy Twojej witryny
Aby chatbot mógł działać w imieniu osoby zalogowanej w Twojej witrynie, strona przekazuje widżetowi token podpisany przez Twój serwer dla tego użytkownika, w tym samym tagu script skopiowanym z sekcji Deploy.
- Jaki może być token: do 1024 znaków: litery, cyfry oraz
._~-, np. JWT albo ciąg base64url. Token z jakimkolwiek innym znakiem, np.+,/lub=ze zwykłego base64, jest odrzucany, tak jakby strona nie podała żadnego. - Dokąd trafia: widżet przekazuje go do czatu przez
postMessage, nigdy w adresie, więc nie trafia do logów żądań. Dociera tylko do serwerów narzędzi zaznaczonych do jego przekazywania, jakoX-User-Id: nie do modelu, Twoich innych narzędzi ani zapisu rozmowy. ChatFrom nigdy go nie odczytuje; Twój serwer go sprawdza i działa wyłącznie na tym jednym koncie. - Strona otwarta godzinami: wywołaj
window.ChatFrom.setUserToken(token)z nowym tokenem, zanim stary wygaśnie, a znull, gdy użytkownik się wyloguje. Token przyjmie każdy chatbot na stronie. - Aplikacja jednostronicowa: na stronie, na której nie powinno być chatbota,
window.ChatFrom.remove()usuwa widżet, awindow.ChatFrom.remove(id)jeden z kilku chatbotów. Ponowne dodanie tagu script przywraca widżet.
Inna usługa
Do wszystkiego, co ma API, dotrzesz przez Twoje API, Twój serwer narzędzi lub Zapier. Potrzebujesz wbudowanej integracji z inną usługą? Napisz do nas.