Integracje / Sendcloud
Sklepy i sprzedaż online
Integracja AI: Sendcloud
Podłączamy REST API Sendcloud v2: listę przesyłek z polami status, carrier_messages i pickup_deadline oraz portal zwrotów z return_reason. Asystent monitoruje wyjątki (status 12), odpowiada klientom zagranicznym w ich języku i grupuje wzorce zwrotów według kraju.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.
W skrócie
Jak asystent AI łączy się z systemem Sendcloud?
Łączymy się z Sendcloud przez REST API w wersji 2. Autentykacja: HTTP Basic Auth, public_key jako login, secret_key jako hasło.
- Na start potrzebujemy
- Konto Sendcloud w planie Growth lub wyższym: niższe plany nie mają dostępu do API
- Czego asystent nie robi
- Nie zmienia danych przesyłki ani adresu dostawy w Sendcloud bez zatwierdzenia przez pracownika: przygotowuje propozycję akcji, zapis po potwierdzeniu
- Gdzie są dane
- Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.
Dane z Sendcloud w czacie i we własnym module
Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Przesyłki i zwroty Sendcloud. W portalu budujemy moduł, który łączy dane z Sendcloud API v2 z listą przesyłek, ich statusami i zgłoszeniami zwrotów. Specjalista ds. logistyki widzi w jednym ekranie aktywne wyjątki (status 12) z klasyfikacją carrier_messages, przesyłki w punktach odbioru zbliżające się do terminu oraz zwroty z komentarzami klientów przetłumaczonymi na polski. Zamiast ręcznego przeglądu panelu Sendcloud każdego rana, tabela od razu pokazuje, które przesyłki wymagają działania i jakiego.
- Filtruje przesyłki ze statusem 12 i klasyfikuje carrier_messages na 5 kategorii wyjątków
- Pokazuje przesyłki w punktach odbioru z countdown do pickup_deadline
- Wyświetla zwroty z return_reason i tłumaczeniem komentarza klienta na polski
- Sygnalizuje powtarzające się wzorce zwrotów według kraju i kategorii produktowej
- Otwiera kartę przesyłki z historią zdarzeń i sugestią asystenta do zatwierdzenia
Pytanie w czacie
Czat przetłumaczył komentarze klientów z niderlandzkiego i niemieckiego na polski i pogrupował wzorce: zamiast godzin przy arkuszu kalkulacyjnym, raport gotowy w kilka sekund.
Sprawdź w Sendcloud zwroty z Niemiec i Holandii z tego tygodnia. Jakie powody dominują i co klienci napisali po niderlandzku lub po niemiecku?
Karta w narzędziu
Karta przesyłki łączy status z Sendcloud, komunikat przewoźnika w oryginale i klasyfikację asystenta z gotową propozycją wiadomości do Waszego klienta po niemiecku.
Zamiast ręcznego przeglądu panelu Sendcloud każdego rana: Wasze wyjątki, terminy odbioru i wzorce zwrotów widoczne od razu, z kontekstem i gotową propozycją działania.
Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie Sendcloud włączamy dopiero wtedy, gdy sami tego chcecie.
Czytamyto_email, order_number, tracking_number, status, expected_delivery_date, carrier, country
AsystentWyszukuje przesyłkę klienta po adresie e-mail lub numerze zamówienia i odpowiada mu w jego języku z datą dostawy w lokalnym formacie, bez angażowania pracownika
Czytamycarrier_messages i parcel_items[x].message przy status=12, w technicznym angielskim przewoźnika
AsystentKlasyfikuje carrier_messages na pięć kategorii: błędny adres, brak odbiorcy, problem celny, uszkodzenie, nieznana przyczyna, i dobiera osobną ścieżkę działania do każdej
Czytamycomment (tekst od klienta w języku obcym), incoming_parcel.expected_delivery_date, return_reason
AsystentTłumaczy komentarz na polski i dołącza go do wewnętrznego ticketu, podając przewidywaną datę przybycia paczki z powrotem do magazynu
Czytamyreturn_reason, country, comment ze wszystkich rekordów zwrotów z wybranego okresu
AsystentGrupuje zwroty według kraju i kodu przyczyny, sygnalizuje, gdy konkretny wzorzec powtarza się przy tej samej kategorii produktowej, bez ręcznego zliczania
Czytamyzdarzenie zmiany statusu wysyłane przez Sendcloud na adres serwera po każdej aktualizacji przesyłki
AsystentReaguje na zmianę statusu natychmiast po zdarzeniu, bez oczekiwania na kolejny cykl odpytywania API, co skraca czas wykrycia wyjątku
Czytamyexpected_delivery_date w formacie ISO (np. 2026-11-20) i kod kraju odbiorcy
AsystentPrzekształca datę ISO na lokalny format językowy: po niderlandzku 20 november 2026, po niemiecku 20. November 2026, przed wysłaniem odpowiedzi do klienta
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Gdzie jest paczka mojego klienta z Niemiec i dlaczego utknęła?”
- „Które przesyłki dostały wyjątek status 12 w ciągu ostatniej doby?”
- „Jaki jest powód zwrotu i co napisał klient po niderlandzku?”
- „Które paczki w punktach odbioru zbliżają się do daty granicznej?”
Co się zmienia
Zapytania klientów zagranicznych, monitoring wyjątków i analiza przyczyn zwrotów obsługują się bez angażowania pracownika przy każdej paczce.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
Sendcloud to platforma do zarządzania wysyłkami, która zbiera dane ze wszystkich przewoźników w jednym miejscu: numery śledzenia, statusy, adresy odbiorców, nazwy punktów odbioru i historię zdarzeń każdej paczki. Skierowana do sklepów wysyłających do wielu krajów i firm obsługujących kilku przewoźników jednocześnie. Pozwala generować etykiety, ustawiać reguły wyboru przewoźnika i obsługiwać zwroty przez własny portal zwrotów.
W codziennej pracy logistyk lub obsługa klienta korzysta z panelu Sendcloud do śledzenia przesyłek, sprawdzania wyjątków i obsługi zwrotów. Dane przesyłek, zwrotów i zdarzeń trzymane są w chmurze Sendcloud i dostępne przez panel webowy oraz REST API. Sendcloud obsługuje też webhooki, przez które sam informuje zewnętrzne systemy o każdej zmianie statusu paczki.
Gdzie to działa najlepiej
Pracownik obsługi klienta
Klient z Holandii pisze przez czat sklepu: Where is my order? Pracownik musi wejść do Sendcloud, znaleźć paczkę po adresie e-mail i odpisać po angielsku. Kolejka czeka, bo nikt nie zna angielskiego wystarczająco swobodnie.
Z asystentem: Asystent sprawdza status po adresie e-mail i odpowiada klientowi po niderlandzku z datą w lokalnym formacie. Pracownik dostaje tylko eskalacje: przesyłka nieznaleziona lub wyjątek wymagający kontaktu z przewoźnikiem.
Specjalista ds. logistyki
Każdego rana ktoś przegląda panel Sendcloud, żeby wyłapać nowe wyjątki. Komunikaty przewoźnika są po technicznym angielsku: Clearance delay, documents required. Trudno szybko zdecydować, co zrobić i kogo powiadomić.
Z asystentem: Asystent filtruje status 12, klasyfikuje carrier_messages i wysyła alert z kategorią i ścieżką: problem celny do osoby od dokumentów eksportowych, brak odbiorcy z propozycją przekierowania do punktu.
Kierownik e-commerce
Co miesiąc ktoś spędza godziny na ręcznym zliczaniu zwrotów z Niemiec i Holandii. Komentarze w polu comment są po niderlandzku lub po niemiecku i nikt ich nie czyta, więc połowa informacji przepada.
Z asystentem: Asystent tłumaczy komentarze na polski i zestawia tygodniowe wzorce: return_reason według kraju. Gdy wrong_product powtarza się przy jednej kategorii z Niemiec, to sygnał do korekty opisu w wersji DE sklepu.
Jak się łączymy
Łączymy się z Sendcloud przez REST API w wersji 2. Autentykacja: HTTP Basic Auth, public_key jako login, secret_key jako hasło. Klucze generujecie w Ustawieniach konta, w sekcji Integrations. Główne endpointy to GET /api/v2/parcels, GET /api/v2/parcels/{id}, GET /api/v2/returns i GET /api/v2/statuses. API zwraca JSON, paginacja przez limit i offset.
Asystent działa na serwerze klienta i odpytuje API w trybie pollingu co kilka minut albo reaguje na webhooki, gdy serwer jest dostępny pod stałym adresem z zewnątrz. Odczytuje dane przesyłek i zwrotów. Zapis i zmiany w Sendcloud przygotowuje jako propozycję, którą zatwierdza pracownik, zanim trafi do API.
Czego potrzebujemy od Was
- Konto Sendcloud w planie Growth lub wyższym: niższe plany nie mają dostępu do API
- Klucze API: public_key i secret_key z sekcji Integrations w Ustawieniach konta Sendcloud
- Serwer klienta z dostępem do internetu: do pollingu lub do odbioru webhooków od Sendcloud
- Lista aktywnych przewoźników w koncie Sendcloud i krajów, do których sklep wysyła
- Jedna osoba po stronie klienta do weryfikacji eskalacji i zatwierdzania akcji, których asystent nie wykonuje samodzielnie
Czego asystent nie robi
- Nie zmienia danych przesyłki ani adresu dostawy w Sendcloud bez zatwierdzenia przez pracownika: przygotowuje propozycję akcji, zapis po potwierdzeniu
- Nie uruchamia zwrotu automatycznie: tworzy propozycję, którą zatwierdza obsługa, zanim pójdzie do API
- Nie zastępuje kontaktu z przewoźnikiem w sprawach wymagających negocjacji, reklamacji lub zgłoszenia uszkodzenia
- Nie estymuje pickup_deadline bez ręcznie wpisanego parametru czasu przechowywania dla danego przewoźnika w konfiguracji automatu
Częste pytania
Co się stanie po odpowiedzi asystenta: czy ticket zamyka się sam?
Asystent odpowiada klientowi przez kanał, z którego przyszło zapytanie, albo zwraca gotowy tekst do systemu obsługi. Zamknięcie ticketu zależy od konfiguracji waszego helpdesku: asystent może to oznaczyć, ale decyzję o zamknięciu zostawia pracownikowi albo regule w waszym systemie.
Czy integracja działa jednakowo dla wszystkich przewoźników w Sendcloud?
Zależy od jakości carrier_messages danego przewoźnika. Niektórzy dają precyzyjne komunikaty, inni bardzo techniczne albo skrótowe. Gdy komunikat jest zbyt ogólny, wyjątek trafia do kategorii nieznana przyczyna i do ręcznej weryfikacji, a klient dostaje wiadomość, że sprawdzamy.
Czy możemy ograniczyć, do jakich krajów asystent odpowiada samodzielnie?
Tak. W konfiguracji automatu ustawiacie listę kodów krajów, dla których asystent działa bez nadzoru. Przesyłki do pozostałych krajów trafiają do kolejki ręcznej. Możecie zacząć od jednego rynku i rozszerzać zakres po weryfikacji jakości odpowiedzi.
Jak asystent radzi sobie, gdy klient podaje błędny numer zamówienia?
Gdy przesyłka nie zostaje znaleziona po order_number ani po to_email, asystent informuje klienta, że nie może jej zlokalizować, i prosi o prawidłowe dane albo przekazuje sprawę do pracownika. Nie zgaduje i nie podaje danych innej przesyłki.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Inne programy: sklepy i sprzedaż online
Sendcloud jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.