Custom store / API connector
Jeśli Twój sklep nie jest na Shopify ani PrestaShop — działa na innej platformie albo na własnym backendzie — podłączasz go przez API connector. Dane przekazujesz nam bezpośrednio przez publiczne API, a panel traktuje je tak samo jak dane z gotowych integracji.
Kiedy wybrać tę drogę
- Sklep na platformie spoza katalogu (np. własny system e-commerce).
- Masz własny backend i chcesz mieć pełną kontrolę nad tym, co i kiedy wysyłasz.
- Potrzebujesz integracji szytej pod Twój proces, a gotowy connector nie wystarcza.
Co przekazujesz przez API
Przez to samo API obsługujesz cały cykl:
- Katalog produktów — pozycje potrzebne do rekomendacji upsellingu.
- Klientów — dane do kontaktu i personalizacji rozmowy.
- Zamówienia — wchodzą do kolejki i kwalifikują się do rozmów.
- Intencje ponownego zakupu (repurchase intent) — sygnały, że klient jest gotów kupić ponownie, które bot może wykorzystać w rozmowie.
To jedno i to samo API obsługuje zarówno bieżące zamówienia, jak i intencje ponownego zakupu — nie potrzebujesz osobnej integracji dla każdego przypadku.
Jak zacząć — w skrócie
Odbierz klucz API
Klucz otrzymasz w panelu. Traktuj go jak hasło — nie umieszczaj w kodzie
publicznym ani w linkach. W panelu klucz jest zawsze zamaskowany, np.
cba_test_••••••••, więc widzisz tylko jego fragment.
Wyślij pierwsze dane
Prześlij produkty, klientów i zamówienia zgodnie z dokumentacją API. Zacznij od kilku pozycji testowych, żeby potwierdzić, że wszystko trafia we właściwe pola.
Zweryfikuj w panelu
Sprawdź, czy produkty pojawiły się w katalogu, a zamówienia w Zamówieniach. Jeśli dane spływają — connector działa i możesz przejść do ustawień rozmów.
Weryfikacja i diagnostyka
- Produkty lub zamówienia się nie pojawiają? Sprawdź, czy wysyłasz je na właściwy endpoint i czy klucz API jest aktywny.
- Zamówienie nie kwalifikuje się do rozmowy? To zwykle kwestia reguł (godziny, zgody, klasyfikacja płatności), nie samego połączenia — patrz Blokery gotowości connectora.
- Powtarzające się wysyłki — projektuj integrację tak, by ponowienie tego samego żądania nie tworzyło duplikatów (idempotency w dokumentacji API).
Pełna dokumentacja techniczna
Szczegóły dla zespołu wdrożeniowego — uwierzytelnianie, idempotency, webhooki i kody błędów — znajdziesz w sekcji API i integracje: