Jak AI obsługuje sklep na Etsy, gdy produkujesz na zamówienie i wysyłasz za granicę?

Tak, sklep na Etsy można połączyć z AI przez Etsy Open API v3 i wyciągnąć z niego zamówienia z personalizacjami, wiadomości od kupujących w kilku językach, statusy wysyłek i szczegółowe rozliczenie opłat Etsy. AI odpowiada kupującym po angielsku, niemiecku i francusku, zbiera personalizacje do listy produkcyjnej i wychwytuje zamówienia, które zaraz przekroczą deklarowany czas wysyłki. Dla pracowni wysyłającej kilkadziesiąt paczek dziennie to różnica między wieczornym piętrzyć wiadomości a spokojnym zamknięciem dnia o 17:00.

Jak technicznie wygląda podłączenie Etsy do AI

Etsy udostępnia Etsy Open API v3: interfejs REST z odpowiedziami w formacie JSON. Podłączenie wymaga trzech rzeczy:

• aktywnego konta Etsy z założonym sklepem,
• aplikacji developerskiej założonej w panelu developers.etsy.com, gdzie Etsy wydaje tzw. keystring (klucz aplikacji),
• tokenów OAuth 2.0 z zakresami uprawnień dopasowanymi do zadań: transactions_r daje dostęp do zamówień, listings_r do ofert i wariantów, billing_r do finansów i opłat, feedback_r do opinii kupujących.

Po autoryzacji OAuth to kilkanaście minut pracy programisty. API ma ograniczenie do 10 zapytań na sekundę: przy kilkudziesięciu zamówieniach dziennie i odpytywaniu co kilka minut mieścisz się spokojnie.

Co Etsy udostępnia przez API: zamówienia (obiekt ShopReceipt) z pełną treścią personalizacji i adresem dostawy, oferty (ShopListing) ze stanami i wariantami, konwersacje z kupującymi, szczegóły wysyłek z numerem trackingu, wpisy finansowe w PaymentAccountLedgerEntry z prowizjami i wypłatami. Czego API nie udostępnia: wewnętrznych statystyk programu Star Seller, szczegółowych danych analitycznych ruchu na ofertach widocznych tylko w panelu Etsy oraz danych z kont kupujących poza zakresem Waszych transakcji.

Etsy nie ma rozbudowanego systemu webhooków do powiadamiania o nowych zdarzeniach w czasie rzeczywistym. Integracja zazwyczaj odpytuje API regularnie co kilka minut: dla pracowni wystarczy to w zupełności.

Jakie dane wyciągamy i dlaczego personalization_message to serce zamówienia

Każde zamówienie na Etsy to obiekt ShopReceipt, a w nim lista pozycji ShopReceiptTransaction. Dla pracowni rękodzieła najważniejsze pole to personalization_message z każdej pozycji: to dokładnie to, co kupujący wpisał przy zamawianiu. Imię do haftowania na poduszce. Data ślubu do wyrytowania na ramce. Kolor nitki na torebce.

Z jednego zamówienia wyciągamy:

• receipt_id i status zamówienia (paid, completed, open, payment_processing),
• message_from_buyer: wiadomość dołączoną do całego zamówienia, często doprecyzowanie personalizacji już po złożeniu,
• personalization_message z każdej pozycji w zamówieniu,
• estimated_delivery_dates i dane adresowe do wysyłki,
• warianty z ShopListingVariation: rozmiar, kolor, materiał.

Do tego z konwersacji pobieramy historię wiadomości. Kupujący często doprecyzowuje personalizację już po złożeniu zamówienia, przez Wiadomości Etsy, a nie przez formularz przy zakupie. System łączy te wiadomości z konkretnym receipt_id, żeby AI miał pełny obraz przed każdą odpowiedzią.

Stany ofert (ShopListing z polem state: active, sold_out, inactive, expired) pozwalają wychwytywać oferty, które automatycznie przeszły w sold_out po ostatnim zamówieniu i jeszcze nie zostały uzupełnione: przydatne przy produktach sezonowych albo limitowanych nakładach.

AI odpowiada kupującym w ich języku: angielski, niemiecki, francuski

To jeden z najbardziej odczuwalnych zysków z integracji. Kupujący na Etsy piszą po angielsku, niemiecku, francusku, holendersku. Właściciel pracowni po polsku. Bez AI każda wiadomość to albo Google Translate w pośpiechu, albo odpowiedź po angielsku z błędami, albo czekanie do jutra.

Jak to działa: AI dostaje treść wiadomości z konwersacji (endpoint GET /application/shops/{shop_id}/conversations), dołącza dane z powiązanego zamówienia i generuje odpowiedź w języku kupującego. Nie zgaduje języka, bo rozpoznaje go z treści wiadomości.

Typowa sytuacja u jednego z klientów: kupujący z Niemiec napisał dzień po złożeniu zamówienia, że chce zmienić imię na personalizacji z „Emma" na „Lea". AI wczytał receipt_id, zobaczył status paid i brak ShopReceiptShipment: zamówienie nie poszło jeszcze do wysyłki, zmiana możliwa. Odpowiedział po niemiecku, potwierdził zmianę, poprosił o chwilę cierpliwości. Właścicielka dostała powiadomienie: „zmiana personalizacji Emma → Lea, zamówienie #1234, wiadomość wysłana." I zaktualizowała listę produkcyjną.

Zakres, w jakim AI odpowiada autonomicznie, ustalacie na starcie. Na pytania o status wysyłki: AI odpowiada sam, wczytuje numer trackingu z ShopReceiptShipment i podaje go wprost. Na prośby o zmianę personalizacji po nadaniu paczki: AI flaguje do ręcznej decyzji z pełnym kontekstem zamówienia. Na skargi i reklamacje: przygotowuje wersję roboczą w języku kupującego, człowiek decyduje o treści i zatwierdza.

Lista produkcyjna zamiast karteczek

W pracowni robiącej na zamówienie lista produkcyjna to codzienność. Przy dziesięciu zamówieniach da się ją zrobić ręcznie. Przy czterdziestu zaczyna się chaos: zdjęcia ekranu, arkusze przepisywane z wiadomości, karteczki przyklejone do monitora. Jakaś personalizacja gubi się co jakiś czas.

AI zbiera co rano wszystkie zamówienia złożone w ciągu ostatniej doby, wyciąga z nich personalization_message i message_from_buyer, grupuje według produktu i generuje plik gotowy do pracy: kolumny „numer zamówienia", „produkt", „wariant", „tekst personalizacji", „termin wysyłki". Posortowane według terminu, nie według kolejności zakupu.

Przy personalizacjach, gdzie kupujący wpisał coś niejasnego (literówka w imieniu, sprzeczne dane w polu personalizacji i w wiadomości, brakująca data), AI flaguje to zamówienie i przygotowuje wersję roboczą pytania do kupującego w jego języku. Pracownik zatwierdza jednym kliknięciem. Zamiast szukać problemu samodzielnie, dostaje gotowe pytanie i listę zamówień wymagających uwagi na ten dzień.

Opóźnienia, opinie i finanse: co pilnuje system

Opóźnione wysyłki. Każde zamówienie ma w polu estimated_delivery_dates zakres dat oczekiwanej dostawy. AI sprawdza regularnie, które zamówienia mają status paid lub open, nie mają jeszcze ShopReceiptShipment z numerem trackingu i zbliżają się do końca deklarowanego czasu realizacji. Zestawia to rano w liście priorytetowej. Typowo wygląda to tak, że pracownia orientuje się o problemie dwa dni przed przekroczeniem terminu, a nie gdy kupujący już pisze ze złością.

Opinie. API udostępnia opinie przez GET /application/shops/{shop_id}/reviews. AI przegląda nowe opinie codziennie: te z niską oceną flaguje z pełną treścią do ręcznej odpowiedzi. Publiczne odpowiedzi na Etsy warto pisać z uwagą i AI nie wysyła ich autonomicznie.

Finanse i VAT OSS. PaymentAccountLedgerEntry to każdy wpis w rachunku Etsy: sprzedaż, prowizja transakcyjna (transaction fee), opłata za listing, prowizja za przetwarzanie płatności (payment processing fee), wypłata na konto (deposit). AI zbiera te wpisy, liczy przychód po opłatach za każdy dzień i miesiąc oraz przypisuje każdą sprzedaż do kraju kupującego na podstawie adresu z ShopReceipt. To zestawienie trafia prosto do arkusza dla biura rachunkowego pod deklarację VAT OSS. Etsy w części krajów UE pobiera VAT jako marketplace facilitator, ale nie w każdym i nie zawsze: AI pokazuje to rozbicie, żeby księgowy wiedział, co Etsy już odprowadził, a co wymaga Waszej deklaracji.

Dzień pracowni, która wysyła 40 paczek

Żeby pokazać, jak to się składa w całość, weźmy konkretny poranek w pracowni biżuteryjnej produkującej na zamówienie.

7:30. System pobrał przez noc zamówienia złożone od wczoraj: 12 nowych, dziewięć z personalizacją. AI wygenerował listę produkcyjną. Jedno zamówienie oznaczone czerwono: kupujący wpisał dwa różne imiona w polu personalizacji i w wiadomości do zamówienia. AI przygotował pytanie po angielsku: które imię jest prawidłowe? Właścicielka klika „wyślij" bez wpisywania ani słowa.

8:00. Siedem nowych wiadomości z nocy europejskiej. Trzy to pytania o status wysyłki: AI odpowiedział automatycznie z numerami śledzenia. Dwie to zapytania o zamówienie niestandardowe: AI przygotował projekty odpowiedzi po angielsku i po niemiecku do zatwierdzenia. Dwie wymagają decyzji: prośba o zmianę adresu i pytanie o cenę przy większym zamówieniu. Obie trafiają na listę do ręcznego rozpatrzenia z pełnym kontekstem zamówienia.

9:00–16:00. Pracownia produkuje. Przez dzień spływa kolejnych kilkanaście zamówień i wiadomości. Jedno nieprzyjemne zdanie od niezadowolonego kupującego z Francji: AI przetłumaczył treść na polski i przygotował stonowaną odpowiedź po francusku do zatwierdzenia, z zaznaczeniem, czego kupujący oczekuje.

16:30. Lista do nadania: wszystkie zamówienia ze statusem paid bez trackingu, posortowane według terminu. Trzy zbliżają się do końca okna wysyłki. Właścicielka wiedziała o nich od rana, więc te trzy były gotowe od południa.

17:00. Raport dzienny: ile zamówień obsłużonych, ile wiadomości wysłanych przez AI, ile przez człowieka, ile personalizacji na liście produkcyjnej na jutro, przychód po opłatach Etsy. Koniec dnia.

Od czego zaczynamy, gdy sklep już działa

Zazwyczaj pierwszym krokiem jest pobieranie zamówień i budowanie listy produkcyjnej: zysk jest natychmiastowy, a ten etap wymaga tylko odczytu z API, bez wysyłania czegokolwiek z powrotem. Potem odpowiedzi na wiadomości: zaczynamy od statusów wysyłki, bo to powtarzalne pytania i bezpieczne zadanie dla AI. Dopiero potem personalizacje z zatwierdzaniem i zestawienia finansowe pod VAT OSS.

Do startu potrzebujesz aktywnego sklepu Etsy, klucza z developers.etsy.com i kogoś, kto skonfiguruje połączenie i nauczy AI tonu Waszego sklepu. Od zera do działającego systemu na podstawowych funkcjach: zazwyczaj kilka tygodni, z czego tydzień na połączenie i mapowanie pól, tydzień na testy z prawdziwymi zamówieniami, reszta na dopasowanie odpowiedzi do stylu komunikacji Waszej marki.

Jeśli chcecie zobaczyć, jak to wygląda na danych Waszego sklepu: 15 minut rozmowy wystarczy, żeby ocenić, gdzie jest największy zysk. Zobaczcie też, jak podobne wdrożenia wyglądały u innych firm: realne wdrożenia.