Różnica między wiedzą a sprawdzeniem na żywo
Istnieją dwa rodzaje pytań od klientów. Pierwszy rodzaj jest ogólny: Jaka jest wasza polityka zwrotów? Ile trwa wysyłka? Czy wysyłacie do Niemiec? Dobrze przygotowana baza wiedzy radzi sobie z tymi pytaniami.
Drugi rodzaj jest konkretny: Gdzie jest moje zamówienie #4521? Czy niebieska wersja jest jeszcze na stanie? Ile zostało mi w planie w tym miesiącu? Te pytania nie są w bazie wiedzy. Są w Twoich systemach — w zarządzaniu zamówieniami, magazynie, rozliczeniach — i zmieniają się co sekundę.
Chatbot, który radzi sobie tylko z pierwszym rodzajem, to wypasione FAQ. Chatbot, który radzi sobie też z drugim rodzajem, to asystent. Różnicę robi dostęp do API.
Dlaczego ta luka kosztuje Cię klientów
Większość dzisiejszych „AI chatów” opiera się wyłącznie na bazie wiedzy. Potrafią sparafrazować Twoją politykę wysyłki w siedemnastu językach, ale nie powiedzą klientowi, gdzie naprawdę jest jego paczka właśnie teraz. Klient pyta, bot się wykręca, a klient albo rezygnuje, albo czeka na operatora, który sprawdzi te same dane, jakie bot mógł pobrać w milisekundach.
To sufit chatbota. Każde „pozwól, że to sprawdzę” to stracona okazja, żeby odpowiedzieć w sekundę, na pierwszej wiadomości, gdy intencja klienta jest jeszcze świeża.
Co właściwie robią połączenia API
W enuchat połączenie API to skonfigurowany most między czatem a jednym z Twoich systemów backendowych. Definiujesz je raz: bazowy URL, metodę uwierzytelniania oraz kilka endpointów z parametrami i mapowaniem odpowiedzi.
Od tego momentu AI może wywoływać te endpointy podczas rozmowy. Gdy odwiedzający pyta o zamówienie, AI wyciąga numer zamówienia, wywołuje Twój endpoint zamówień, odczytuje aktualny status i wplata go w odpowiedź. Odwiedzający widzi jedno zdanie: „Twoje zamówienie #4521 zostało wysłane wczoraj i powinno dotrzeć w czwartek.” Za tym zdaniem stoi prawdziwe wywołanie API.
Klient nie widzi instalacji. Widzi tylko, że czat naprawdę wie.
Pięć metod uwierzytelniania, bez własnego kodu
Większość API, które chciałbyś podłączyć, używa już standardowych metod uwierzytelniania. enuchat obsługuje pięć z nich od ręki:
- Brak — dla publicznych API, które nie wymagają uwierzytelniania
- API Key — wysyłany jako nagłówek lub parametr zapytania
- Bearer Token — proste uwierzytelnianie tokenem
- Basic Auth — dla starszych systemów
- OAuth 2.0 client credentials — dla nowoczesnych dostawców jak Salesforce, HubSpot lub Twój własny serwer OAuth
W przypadku OAuth 2.0 enuchat sam zarządza cyklem życia tokena — pobiera przy pierwszym wywołaniu, cache’uje do wygaśnięcia, odświeża, gdy trzeba. Konfigurujesz dane uwierzytelniające raz i o nich zapominasz. Wszystkie dane uwierzytelniające są szyfrowane w spoczynku z użyciem libsodium i nigdy nie pojawiają się w odpowiedziach API.
Zmienne, szablony i mapowanie odpowiedzi
Endpointy są zdefiniowane jako szablony. Ścieżka taka jak /orders/{orderId} albo treść JSON odwołująca się do {customerId} interpoluje wartości ze zmiennych sesji — zmiennych, które AI lub statyczna reguła mogą ustawić podczas rozmowy.
Gdy API odpowiada, mapujesz pola z odpowiedzi JSON z powrotem do zmiennych sesji za pomocą notacji kropkowej. data.status staje się order_status. data.shipping.eta staje się delivery_eta. AI następnie wplata te wartości w naturalną odpowiedź — w języku odwiedzającego.
Trzy schematy, które obejmują większość zastosowań
W praktyce większość integracji API przyjmuje jedną z trzech form.
Pobierz i odpowiedz
Odwiedzający zadaje pytanie, na które można odpowiedzieć jednym wywołaniem API. Reguła uruchamia CALL_API, a następnie REPLY_AI. AI wykorzystuje pobrane dane do skomponowania osadzonej w kontekście, ugruntowanej odpowiedzi. Status zamówienia, saldo konta, dostępność pokoju, aktualne ceny, śledzenie przesyłki — wszystkie te przypadki tu pasują.
Pobierz i przekieruj
Wywołanie API zwraca wystarczająco dużo informacji, żeby zdecydować, co dalej. Konto premium trafia do starszego agenta. Wygasły abonament jest kierowany do działu rozliczeń. AI używa CALL_API, a potem ASSIGN_TO_OPERATOR, by podejmować decyzje o trasowaniu na podstawie prawdziwych danych klienta, a nie domysłów.
Procesy wieloetapowe
Pierwsza wiadomość taguje rozmowę przez SET_VARIABLE, druga uruchamia wywołanie API, gdy jest już dość kontekstu, a trzecia komponuje odpowiedź. Przydaje się, gdy chcesz potwierdzić intencję, zanim odpytasz backend, albo gdy szukane dane zależą od czegoś, co odwiedzający powiedział dwie wiadomości wcześniej.
Wbudowane bezpieczeństwo
Podłączanie backendu do widgetu czatu denerwuje niektóre zespoły — i słusznie. enuchat domyślnie dostarcza kilka warstw ochrony:
- Ochrona przed SSRF blokuje wywołania do localhost, prywatnych adresów IP i wewnętrznych nazw hostów
- Limit czasu 5 sekund nie pozwala wolnemu API zawiesić rozmowy
- Izolacja tenanta oznacza brak wycieku danych między tenantami — Twoje endpointy są widoczne tylko dla Twoich widgetów
- Przyciski testowe weryfikują zarówno połączenie, jak i każdy endpoint niezależnie, zanim wpiętamy je w reguły
- Zaszyfrowane dane uwierzytelniające nigdy nie wracają do panelu w postaci jawnej
Co zmienia się z perspektywy Twoich klientów
Czat przechodzi od „zaraz znajdę kogoś, kto to sprawdzi” do „sprawdzone, oto odpowiedź” — w jednym z 60+ języków, w niedzielę o 3 nad ranem, gdy Twój zespół wsparcia śpi. Klienci, którzy porzuciliby koszyk, zamówienie albo plan, zostają, bo odpowiedź dociera, gdy wciąż pytają.
To różnica między chatbotem a asystentem. I to różnica, którą Twoi klienci faktycznie czują.
Jak zacząć
Jeśli już masz skonfigurowany enuchat, połączenia API znajdziesz w Ustawienia → Połączenia API. Wybierz jeden endpoint, który odpowiada na pytanie zadawane przez Twój zespół setki razy w tygodniu — status zamówienia to zwykle najlepszy punkt startu. Skonfiguruj połączenie, dodaj endpoint, podepnij go pod regułę i przetestuj raz, zanim ruszysz na produkcję. Pełny przewodnik znajdziesz w dokumentacji Połączeń API.
Jeśli jesteś nowy w enuchat, zarejestruj się na enuchat.com. Plan darmowy obejmuje połączenia API od pierwszego dnia — bez karty, bez opłat za rozmowę, bez wygasającej wersji próbnej.
Pięć minut, żeby podpiąć pierwszy endpoint. Pierwsza użyteczna odpowiedź zwykle pojawia się tego samego dnia.