Integracje

Karta Integracje pozwala agentowi pobierać dane na żywo z usług zewnętrznych podczas rozmowy. Po połączeniu agent automatycznie wywołuje właściwą usługę, gdy odwiedzający zadaje istotne pytanie — bez ręcznego wyzwalania.

Przejdź do Twój agent → Integracje, aby skonfigurować dowolną z poniższych usług.

Dostępność w planach: kalendarze (Cal.com, Calendly) i przewoźnicy są dostępni w planie Base i wyższych. E-commerce, CRM i płatności wymagają planu Business i wyższych. Zobacz Plany i płatności.

Umawianie

Cal.com

Pozwala agentowi pokazywać wolne terminy z Twojego kalendarza Cal.com.

1. W Cal.com otwórz wybrane wydarzenie i skopiuj jego publiczny URL (np. cal.com/yourname/30min).
2. Wklej URL w pole Cal.com Event URL i kliknij Zapisz.

Calendly

Pozwala agentowi pokazywać wolne terminy z Twojego kalendarza Calendly.

1. Skopiuj URL wydarzenia z Calendly (np. calendly.com/yourname/30min).
2. Przejdź do Calendly → Integrations → API & Webhooks → Personal Access Tokens i wygeneruj token.
3. Wklej zarówno URL wydarzenia, jak i token, a następnie kliknij Zapisz.

Token jest wymagany, ponieważ API dostępności Calendly jest uwierzytelnione. Jest przechowywany zaszyfrowany i nigdy nie ujawniany odwiedzającym.

E-commerce

Gdy integracja e-commerce znajdzie pasujące produkty, wyniki pojawiają się jako przewijalna karuzela produktów w czacie — obraz, nazwa, cena i link — a nie zwykły tekst.

Shopify

Pozwala agentowi wyszukiwać produkty w katalogu oraz sprawdzać status zamówienia klienta — płatność, realizację i numer śledzenia. Zanim ujawni szczegóły zamówienia, agent prosi o potwierdzenie telefonu lub e-maila podanego w zamówieniu, więc nikt nie sprawdzi cudzego zamówienia.

1. Wpisz domenę sklepu (np. mystore.myshopify.com) i kliknij Połącz Shopify.
2. Autoryzuj dostęp w Shopify i zatwierdź żądane uprawnienia.
3. Po zatwierdzeniu zostaniesz przekierowany z powrotem, a integracja pokaże status Połączono.

WooCommerce

Pozwala agentowi sprawdzać status i szczegóły zamówienia po numerze.

1. W WordPress przejdź do WooCommerce → Settings → Advanced → REST API i kliknij Add key.
2. Ustaw uprawnienia na Read, wygeneruj klucz i skopiuj Consumer Key oraz Consumer Secret.
3. Wprowadź URL sklepu i oba klucze w BotChata, a następnie kliknij Połącz WooCommerce.

PrestaShop

Pozwala agentowi przeszukiwać Twój katalog produktów.

1. W panelu PrestaShop przejdź do Advanced Parameters → Webservice i włącz webservice.
2. Dodaj nowy klucz z dostępem do odczytu produktów i skopiuj wygenerowany API key.
3. Wprowadź URL sklepu i klucz API w BotChata i kliknij Zapisz.

Shoper

Pozwala agentowi przeszukiwać katalog Twojego sklepu Shoper.

1. W panelu Shoper utwórz dostęp do API (użytkownika aplikacji) w ustawieniach API.
2. Wprowadź URL sklepu i dane API w BotChata i kliknij Zapisz.

Magento

Pozwala agentowi przeszukiwać Twój katalog Magento.

1. W panelu Magento przejdź do System → Integrations i utwórz integrację z dostępem do odczytu katalogu.
2. Skopiuj Access Token.
3. Wprowadź URL sklepu i token w BotChata i kliknij Zapisz.

Dostawa i śledzenie

Wszystkie integracje dostawy działają tak samo: agent pyta odwiedzającego o numer przesyłki i zwraca aktualny status bezpośrednio w czacie.

InPost

1. Zaloguj się do InPost Manager i przejdź do API.
2. Wygeneruj lub skopiuj swój klucz API.
3. Wklej go w BotChata i kliknij Zapisz.

DHL

1. Zarejestruj się na developer.dhl.com (dostępny darmowy plan).
2. Utwórz aplikację i skopiuj API key.
3. Wklej go w BotChata i kliknij Zapisz.

DPD

1. Skontaktuj się z opiekunem konta DPD lub zarejestruj się na developer.dpd.de, aby uzyskać klucz API.
2. Wklej klucz w BotChata i kliknij Zapisz.

GLS

1. Zaloguj się do swojego konta myGLS Business.
2. Użyj loginu i hasła z danych myGLS Business.
3. Wprowadź oba pola w BotChata i kliknij Zapisz.

Nova Poshta

1. Otwórz panel osobisty Nova Poshta i przejdź do Ustawienia → API.
2. Skopiuj swój klucz API.
3. Wklej go w BotChata i kliknij Zapisz.

UPS

UPS używa OAuth2 client credentials.

1. Zarejestruj się na developer.ups.com i przejdź do My Apps → Create App.
2. Skopiuj Client ID oraz Client Secret.
3. Wprowadź oba w BotChata i kliknij Zapisz.

BotChata automatycznie wymienia dane uwierzytelniające na token bearer i odświeża go przed wygaśnięciem — nie musisz zarządzać tokenami ręcznie.

FedEx

FedEx również używa OAuth2 client credentials.

1. Zarejestruj się na developer.fedex.com i przejdź do My Projects → Create Project.
2. Skopiuj Client ID oraz Client Secret.
3. Wprowadź oba w BotChata i kliknij Zapisz.

CRM

HubSpot

Pozwala agentowi wyszukać kontakt w Twoim CRM po adresie e-mail.

1. W HubSpot przejdź do Settings → Integrations → Private Apps i utwórz nową aplikację.
2. Nadaj przynajmniej zakres crm.objects.contacts.read.
3. Skopiuj Private App Token (zaczyna się od pat-).
4. Wklej go w BotChata i kliknij Zapisz.

Agent zwraca imię, telefon i firmę kontaktu — wrażliwe pola wewnętrzne są automatycznie odfiltrowywane.

Pipedrive

Pozwala agentowi wyszukać osobę lub szansę sprzedaży w Twoim CRM Pipedrive.

1. W Pipedrive przejdź do Settings → Personal preferences → API i skopiuj swój API token.
2. Wprowadź domenę firmy i token w BotChata i kliknij Zapisz.

Płatności

Stripe

Pozwala agentowi sprawdzić ostatni status płatności klienta po adresie e-mail.

1. Otwórz Stripe Dashboard → Developers → API keys.
2. Skopiuj Secret Key (sk_live_ na produkcji lub sk_test_ w trybie testowym).
3. Wklej go w BotChata i kliknij Zapisz.

Dla lepszego bezpieczeństwa użyj Restricted key tylko z uprawnieniem charges: read.

Wskazówki

• Wiele integracji może być aktywnych jednocześnie. Agent wybiera właściwą na podstawie tego, o co pyta odwiedzający.
• Odłącz w dowolnej chwili, klikając czerwony link Odłącz pod połączoną integracją — przechowywane dane uwierzytelniające są usuwane natychmiast.
• Dane uwierzytelniające są szyfrowane Fernet (AES-128) przed zapisaniem i nigdy nie są zwracane do przeglądarki.
• Każda karta integracji ma przycisk Testuj połączenie — użyj go, aby potwierdzić, że dane działają, przed uruchomieniem.
• Jeśli wywołanie integracji nie powiedzie się podczas rozmowy (np. API jest niedostępne), agent wraca do swojej wiedzy i informuje odwiedzającego, że nie udało się pobrać danych na żywo.