Integracje / Etsy
Portale i marketplace
Integracja AI: Etsy
Podłączamy Etsy Open API v3 i czytamy zamówienia z polami personalization_message, wiadomości kupujących i wpisy PaymentAccountLedgerEntry. Asystent generuje listę produkcyjną z personalizacjami, odpowiada kupującym po angielsku i niemiecku oraz przygotowuje zestawienie VAT OSS.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie Etsy włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamyPola receipt_id, status (paid, completed, open, payment_processing) i estimated_delivery_dates z ShopReceipt
AsystentZestawia codziennie zamówienia bez trackingu zbliżające się do końca okna wysyłki i układa listę priorytetową do nadania
CzytamyPole message_from_buyer z ShopReceipt: wiadomość kupującego do całego zamówienia, często doprecyzowuje personalizację po złożeniu
AsystentŁączy z personalization_message z pozycji zamówienia i flaguje rozbieżności przed wygenerowaniem listy produkcyjnej
CzytamyShopListingVariation: rozmiar, kolor, materiał i inne atrybuty przypisane do każdej pozycji w zamówieniu
AsystentDołącza wariant do wiersza listy produkcyjnej, żeby pracownik od razu widział np. kolor nitki bez otwierania zamówienia
CzytamyOcena gwiazdkowa i treść opinii z endpointu reviews; codzienne pobieranie z filtrem na nowe i niskie oceny
AsystentTłumaczy negatywną opinię na polski i przygotowuje wersję roboczą odpowiedzi w języku kupującego do ręcznego zatwierdzenia
CzytamyWpisy z typem transaction fee, listing fee, payment processing fee i deposit z PaymentAccountLedgerEntry
AsystentRozpisuje opłaty według typu i dnia, liczy dzienny i miesięczny przychód netto po prowizjach i przygotowuje zestawienie dla biura rachunkowego
CzytamyAdres dostawy z ShopReceipt skrzyżowany z wpisami sprzedaży w PaymentAccountLedgerEntry według daty i receipt_id
AsystentPrzypisuje każdą sprzedaż do kraju kupującego i wskazuje, które transakcje Etsy objął jako marketplace facilitator, a które idą do Waszej deklaracji OSS
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Które zamówienia mają personalizację i jaki termin wysyłki?”
- „Co kupujący napisał w wiadomości po złożeniu zamówienia?”
- „Jakie opłaty Etsy pobrał w tym miesiącu i ile zostało po prowizjach?”
- „Które zamówienia przekraczają za chwilę deklarowany czas realizacji?”
Co się zmienia
Pracownia zamyka dzień o 17:00 zamiast wieczorami przepisywać personalizacje i tłumaczyć wiadomości od zagranicznych kupujących.
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
Etsy jest platformą sprzedażową dla pracowni i twórców oferujących wyroby ręczne, personalizowane i vintage. Korzystają z niej małe i średnie pracownie wysyłające paczki za granicę: biżuteria, hafty, wyroby z drewna, tekstylia. Każde zamówienie może zawierać indywidualną personalizację, wiadomość od kupującego i korespondencję w kilku językach.
Etsy przechowuje dane sklepu na własnych serwerach i udostępnia je przez Etsy Open API v3, interfejs REST z odpowiedziami JSON. Portal obejmuje moduły zamówień, ofert, konwersacji z kupującymi, wysyłek, finansów i opinii. Każdy obszar wymaga osobnego zakresu uprawnień OAuth 2.0 przyznanego przez właściciela konta w panelu developers.etsy.com.
Gdzie to działa najlepiej
Właścicielka pracowni
Rano przed pracą otwiera listę produkcyjną: 12 nowych zamówień, dziewięć z personalizacją. Jedno oznaczone czerwono: kupujący wpisał dwa różne imiona w polu personalizacji i w wiadomości do zamówienia.
Z asystentem: Asystent przygotował pytanie po angielsku z obu wersjami imienia. Właścicielka klika 'wyślij', bez wpisywania ani słowa, i przechodzi do produkcji.
Obsługa klienta
Kupujący z Niemiec napisał dzień po złożeniu zamówienia, że chce zmienić imię na personalizacji z Emma na Lea. Zamówienie ma status paid i nie ma jeszcze ShopReceiptShipment.
Z asystentem: Asystent potwierdził brak wysyłki, odpowiedział po niemiecku z potwierdzeniem zmiany i przesłał powiadomienie: 'Emma do Lea, zamówienie #1234, wiadomość wysłana'.
Kierownik wysyłki
Środa, 16:30. Na liście do nadania trzy zamówienia zbliżają się do końca deklarowanego okna wysyłki. Bez systemu pracownia dowiedziałaby się o tym, gdy kupujący napisaliby ze złością.
Z asystentem: Asystent wychwycił te zamówienia dwa dni wcześniej z pola estimated_delivery_dates i wstawił je na szczyt listy priorytetowej. Paczki były gotowe od południa.
Jak się łączymy
Podłączamy się przez Etsy Open API v3: interfejs REST z odpowiedziami JSON. Autoryzacja odbywa się tokenami OAuth 2.0, które właściciel sklepu wydaje przez panel developers.etsy.com z zakresami dopasowanymi do zadań: transactions_r, listings_r, billing_r i feedback_r. Każdy zakres daje dostęp do innego obszaru danych sklepu.
API nie ma webhooków w czasie rzeczywistym, więc odpytujemy je regularnie co kilka minut. Limit 10 zapytań na sekundę przy kilkudziesięciu zamówieniach dziennie nie stanowi problemu. Portal z bazami i historią rozmów stoi na serwerze klienta. Zamówienia, wiadomości i finanse czytamy w trybie odczytu; wiadomości do kupujących asystent wysyła tylko po zatwierdzeniu przez właściciela sklepu.
Czego potrzebujemy od Was
- Aktywne konto Etsy z działającym sklepem i historią zamówień
- Aplikacja założona w panelu developers.etsy.com i wygenerowany keystring
- Tokeny OAuth 2.0 z zakresami: transactions_r, listings_r, billing_r i feedback_r
- Osoba w firmie, która codziennie zatwierdza wiadomości do kupujących i listę produkcyjną
- Dostęp do serwera portalu dla programisty na czas konfiguracji połączenia OAuth
Czego asystent nie robi
- Nie wysyła publicznych odpowiedzi na opinie Etsy autonomicznie: przygotowuje wersję roboczą do zatwierdzenia.
- Nie zmienia statusu zamówienia, adresu dostawy ani treści oferty bez potwierdzenia właściciela sklepu.
- Nie zastępuje biura rachunkowego: zestawienie VAT OSS przekazuje księgowej, decyzja o deklaracji należy do niej.
- Nie odczytuje statystyk Star Seller, analityki ruchu na ofertach ani danych kont kupujących spoza Waszych transakcji.
Częste pytania
Czy podłączenie Etsy do AI wymaga ode mnie działań w ustawieniach sklepu?
Tak, jedno: zakładasz aplikację w panelu developers.etsy.com i wydajesz tokeny OAuth 2.0 z potrzebnymi zakresami. To kilkanaście minut po Waszej stronie. Konfigurację połączenia po stronie portalu przeprowadzamy przy wdrożeniu. Potem obsługujesz sklep tak jak dotąd.
Co się stanie z integracją, gdy odnowię tokeny albo zmienię dostępy w Etsy?
Tokeny OAuth 2.0 Etsy mają długi czas ważności i automatycznie się odświeżają. Gdyby wygasły lub zostały ręcznie unieważnione w panelu Etsy, integracja przestaje pobierać dane i zgłasza błąd. Wystarczy wydać nowe tokeny i zaktualizować je w ustawieniach portalu.
Ile trwa aktualizacja danych? Czy AI widzi nowe zamówienia od razu?
Etsy Open API v3 nie oferuje webhooków w czasie rzeczywistym, więc system odpytuje API regularnie co kilka minut. Nowe zamówienie pojawia się na liście produkcyjnej z kilkuminutowym opóźnieniem. Dla pracowni wysyłającej kilkadziesiąt paczek dziennie ta różnica nie ma znaczenia w codziennej pracy.
Co AI robi, gdy nie może rozstrzygnąć sprawy i musi ją przekazać dalej?
Prośby o zmianę personalizacji po nadaniu paczki, reklamacje i skargi trafiają na listę do ręcznego rozpatrzenia z pełnym kontekstem: treścią wiadomości, statusem wysyłki i historią konwersacji. Asystent przygotowuje wersję roboczą odpowiedzi w języku kupującego, ostateczną decyzję podejmuje właściciel sklepu.
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: portale i marketplace
Etsy 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.