Przejdź do treści

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 APITwoje własne endpointy jako akcje; ich klucze zostają na naszym serwerze.Twój serwer narzędziNarzędzia, które oferuje Twój serwer MCP, działające w imieniu zalogowanego użytkownika.ZapierTysiące aplikacji, takich jak Gmail, Slack czy Airtable, przez akcje, które wybierzesz.ShopifyStatus zamówienia z linkiem do śledzenia przesyłki i prośby o zwrot, które zatwierdza Twój sklep.StripePodgląd, anulowanie i wznawianie subskrypcji, gdy klient potwierdzi swój adres e-mail.RevenueCatKlienci w Twojej aplikacji na iOS pytają o własną subskrypcję.Google SheetsNowy wiersz w Twoim własnym arkuszu za każdym razem, gdy pojawi się potencjalny klient, rezerwacja lub prośba.HubSpotKażdy potencjalny klient zapisany jako kontakt w Twoim CRM-ie, z notatką o tym, o co pytał.Cal.comTwoje wolne terminy proponowane na czacie i rezerwacja wizyty.CalendlyTwoje wolne terminy proponowane na czacie i rezerwacja spotkania.

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.

  1. 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.
  2. Nadaj jej nazwę, np. get_order_status, i napisz dla modelu opis: co robi i kiedy jej używać.
  3. 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.
  4. Wypisz parametry, po jednym w wierszu: nazwa, typ, „required” albo „optional” i opis, np. order_id, string, required, Numer zamówienia.
  5. 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.
  6. 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.

  1. 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”.
  2. W ustawieniach serwera wygeneruj token API i skopiuj go. Zapier pokazuje go tylko raz.
  3. W sekcji Tools dodaj serwer MCP o nazwie zapier, z adresem https://mcp.zapier.com/api/v1/connect i nagłówkiem Authorization: Bearer, po którym wpisz swój token.
  4. 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.

Widżet dla zalogowanego użytkownikaHTML
<script src="https://chatfrom.io/w.js"
  data-bot="<identyfikator Twojego chatbota>"
  data-user-token="<token podpisany przez Twój serwer dla tego użytkownika>"
  defer></script>
  • 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, jako X-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 z null, 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, a window.ChatFrom.remove(id) jeden z kilku chatbotów. Ponowne dodanie tagu script przywraca widżet.
Odświeżanie tokenu i usuwanie widżetuJavaScript
// Nowy token, zanim stary wygaśnie, albo null, gdy użytkownik się wyloguje.
window.ChatFrom.setUserToken(token);

// Strona aplikacji jednostronicowej, na której nie powinno być chatbota.
window.ChatFrom.remove();

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.