> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sensbot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Apilo

> Podłącz Apilo, a chatbot i Email Assistant odpowiedzą na pytania o zamówienia i paczki prosto z niego: status, płatność, przewoźnik i numer przesyłki

Jeśli zamówienia przechodzą przez [Apilo](https://apilo.com), to właśnie tam jest zwykle najświeższa odpowiedź na „gdzie jest moje zamówienie”: status zamówienia, informacja o płatności, przewoźnik, numer przesyłki i to, co dzieje się z paczką.

Po podłączeniu Apilo chatbot i Email Assistant przy pytaniu o zamówienie zaglądają najpierw do Apilo. Gdy Apilo nie ma takiego zamówienia albo nie odpowiada, sięgają po zamówienia z platformy sklepu. Działa to niezależnie od tego, na czym stoi sklep.

> [!NOTE]
>
> Sensbot tylko **odczytuje** dane z Apilo. Nigdy nie zmienia zamówienia, statusu ani przesyłki. Apilo nie oferuje kluczy API tylko do odczytu, więc dodana aplikacja ma pełny dostęp do konta Apilo. To, że Sensbot tylko czyta, wynika z tego, jak go zbudowaliśmy: do Apilo wysyłamy wyłącznie zapytania odczytu.

***

## Co Sensbot odczytuje z Apilo

| Skąd | Co |
| - | - |
| Zamówienie | Status zamówienia pod nazwą, jaką ma w Twoim Apilo, oraz informacja, czy jest opłacone |
| Przesyłka | Przewoźnik, numer przesyłki i link do śledzenia dla InPostu, DPD, DHL, UPS, Orlen Paczki i Poczty Polskiej |
| Paczka | Jej stan, jeśli Apilo go zna: przekazana kurierowi, wydana do doręczenia, czeka w punkcie odbioru, doręczona albo wraca do nadawcy |

Na pytania o produkty Apilo nie odpowiada: te nadal idą z feedu produktowego albo z platformy sklepu.

***

## Zanim zaczniesz

| Wymaganie | Dlaczego |
| - | - |
| Konto Sensbot z chatbotem albo Email Assistantem | Apilo dodaje do nich odpowiedzi o zamówieniach |
| Konto Apilo z zamówieniami | Stamtąd Sensbot odczytuje zamówienia |
| Uprawnienia administratora w Apilo | Tylko administrator może dodać aplikację w Kluczach API |
| Około pięciu minut | |

> [!NOTE]
>
> Twój sklep stoi na platformie, dla której Sensbot nie ma aplikacji (na przykład PrestaShop albo sklep zbudowany na zamówienie)? Po podłączeniu napisz na [support@sensbot.ai](mailto:support@sensbot.ai), a włączymy odpowiedzi o zamówieniach dla Twojego sklepu.

***

## Krok 1 · Dodaj aplikację w Apilo

1. Zaloguj się do Apilo i otwórz **Administracja → Klucze API Apilo**.
2. Kliknij **Nowa aplikacja REST API**, wpisz nazwę, na przykład `Sensbot`, w polu **Nazwa aplikacji** i kliknij **Zapisz**.
3. Apilo pokaże **Adres API (endpoint)**, **Client ID**, **Client Secret** i **Kod autoryzacji**. Zostaw tę stronę otwartą albo skopiuj wszystkie cztery wartości.

> [!WARNING]
>
> Kod autoryzacji działa **tylko raz** i tylko do godziny podanej w polu **Ważność do** (około 3 godzin). Jeśli połączenie w Sensbocie się nie uda albo kod wygasł, dodaj w Apilo nową aplikację i użyj jej kodu.

***

## Krok 2 · Połącz w Sensbocie

1. W [panelu Sensbot](https://platform.sensbot.ai) otwórz **Integracje**.
2. Przewiń do sekcji **Systemy zamówień i wysyłki**, znajdź kartę **Apilo** i kliknij **Połącz**.
3. Uzupełnij cztery pola:
   * **Twój adres Apilo:** **Adres API (endpoint)** z kroku 1, na przykład `twojsklep.apilo.com`. To ten sam adres, pod którym logujesz się do Apilo.
   * **Client ID**
   * **Client Secret**
   * **Kod autoryzacji**
4. Kliknij **Połącz**.

Karta pokaże **Połączono**. Od teraz chatbot i Email Assistant korzystają z Apilo przy pytaniach o zamówienia.

Połączenie odnawia się samo: Sensbot automatycznie odświeża dostęp do Apilo, więc nie trzeba do tego wracać.

***

## Co widzi klient

Aby dostać szczegóły zamówienia, klient podaje numer zamówienia oraz adres e-mail albo numer telefonu z zamówienia. Numer może pochodzić ze sklepu lub marketplace’u albo z Apilo (na przykład `AL0012345`). Zanim cokolwiek pokaże, Sensbot sprawdza, czy numer zgadza się z e-mailem albo telefonem.

> **Klientka:** Dzień dobry, gdzie jest moje zamówienie 48213? Zamawiałam z adresu [kasia@example.com](mailto:kasia@example.com).
>
> **Chatbot:** Zamówienie 48213 jest opłacone, a paczka InPost czeka już na Panią w Paczkomacie. Numer przesyłki to 6200 1234 5678 9012, a paczkę można śledzić pod linkiem poniżej.

W poczcie adres nadawcy liczy się jako e-mail, a Email Assistant odnajduje też zamówienia nadawcy z ostatnich 30 dni. Odpowiedź trafia do Wersji roboczych skrzynki, z której już odpisujesz, a wysyła ją człowiek.

***

## Rozwiązywanie problemów

| Co widzisz | Co zrobić |
| - | - |
| **Apilo nie przyjęło kodu autoryzacji** | Kod został już użyty (na przykład przy wcześniejszej próbie) albo minęły ponad 3 godziny. Dodaj w Apilo nową aplikację i wklej jej kod. |
| **Pod tym adresem nie ma panelu Apilo** | Podaj adres, pod którym logujesz się do Apilo, na przykład `twojsklep.apilo.com`. |
| **Nie udało się połączyć. Sprawdź adres, Client ID i Client Secret.** | Skopiuj ponownie Client ID i Client Secret z aplikacji w Apilo i użyj nowego kodu autoryzacji. |
| Karta pokazuje **Wymagane ponowne połączenie** | Apilo odrzuciło zapisane połączenie, na przykład po usunięciu aplikacji. Kliknij **Wymagane ponowne połączenie** i powtórz kroki z nowym kodem autoryzacji. |

Zapisane połączenie w każdej chwili sprawdzisz małą ikoną **Sprawdź połączenie** na karcie Apilo.

***

## Odłączanie

Na karcie Apilo w **Integracjach** kliknij **Odłącz**. Chatbot i Email Assistant wrócą wtedy wyłącznie do danych o zamówieniach z platformy sklepu. Aby odciąć dostęp także po stronie Apilo, usuń aplikację Sensbot w **Administracja → Klucze API Apilo**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.