W ramach prac nad ujednoliceniem obsługi komunikacji, rozszerzamy możliwości istniejących endpointów na ścieżce /messaging o obsługę nowego typu wątku w Centrum Wiadomości czyli Problemów z zakupem, które z czasem całkowicie zastąpią Dyskusje. Nowa struktura endpointów /messaging dostępna jest w wersji beta.v1.

Sprzedający na Allegro, którzy korzystają z Twoich rozwiązań, dostaną od nas osobną komunikację o tych zmianach. Poinformujemy ich o tym z odpowiednim wyprzedzeniem.

Co zmieniliśmy?

W ramach nowej struktury wybranych endpointów /messaging dostępnych w wersji beta.v1, wprowadziliśmy kilka istotnych zmian, które umożliwią zarządzanie nowymi Problemami z zakupem.

1. GET /messaging/threads:
   • pobierzesz teraz listę wątków, dla których “type”:
     • COMMON - obejmuje dotychczasowe wątki,
     • POST_PURCHASE_ISSUE - to Problemy z zakupem,
   • zamiast parametrów “offset” i “limit” skorzystasz teraz z nowego parametru “page.id”. Rozwiązanie to eliminuje problemy wydajnościowe przy dużej liczbie wątków i wiadomości,
   • dodaliśmy również parametry:
     • "read" - określający czy wątek został odczytany; true - tak, false - nie,
     • "status" - status wątku; dostępne wartości: OPEN, CLOSED,
     • "orderId" - numer zamówienia (dostępne tylko dla typu wątku: POST_PURCHASE_ISSUE),
   • dodaliśmy nowe pola - przykładowa odpowiedź poniżej:

{
  "threads": [
...
 {
      "id": "88ae369b-8f65-4fc4-9c77-bedf604a2e2",
      "type": "POST_PURCHASE_ISSUE", // typ wątku; możliwe wartości: COMMON - dotychczasowe wątki, POST_PURCHASE_ISSUE - problemy z zakupem
      "read": false,
      "createdAt": "2026-06-02T09:00:00Z", // data utworzenia
      "lastMessageDateTime": "2026-06-02T10:00:00Z",
      "participants": [ // użytkownicy wątku
        {
          "role": "BUYER", // rola użytkownika; możliwe wartości: BUYER (kupujący), SELLER (sprzedający), USER (użytkownik występujący w dotychczasowych wątkach)
          "login": "BuyerLogin" // login użytkownika
        },
        {
          "role": "SELLER",
          "login": "SellerLogin"
        }
      ],
      "orders": [ // lista zamówień
        {
          "id": "29738e61-7f6a-11e8-ac45-09db60ede9d6", // identyfikator zamówienia
          "offers": [ // lista ofert
            {
              "id": "82398120310", // identyfikator oferty
              "quantity": 1 // liczba sztuk
            }
          ]
        }
      ],
      "subType": "PRODUCT_INCONSISTENT_WITH_THE_OFFER", // podtyp wątku, rodzaj problemu pozakupowego; możliwe wartości dostępne w dokumentacji
      "status": "OPEN" // status wątku
    }
  ],
  "nextPage": "cD0yMDI2LTA2LTAyVDEyOjEwOjAwWjtzPTEwMDQ=" // token, który pozwala pobrać następną stronę wątków
}

2. GET /messaging/threads/{threadId}:
   • podobnie jak powyżej dla GET /messaging/threads, dodaliśmy nowe pola – z wyjątkiem „nextPage”.
3. PUT /messaging/threads/{threadId}/read:
   • zmieniliśmy response body dla status code: 200

Przykładowy response:

{
  "read": true
}

4. GET /messaging/threads/{threadId}/messages: zamiast parametrów “offset” i “limit” skorzystasz teraz z nowego parametru “page.id”, dodaliśmy nowe pola:
   • “author.role” - rola użytkownika w wiadomości; dostępne wartości: USER, SYSTEM, CHATBOT, CONSULTANT, BUYER, SELLER,
   • “attachments.id” - identyfikator załącznika,
   • „nextPage” - token pozwalający na pobranie kolejnej strony wiadomości.
5. GET /messaging/messages/{messageId}:
   • podobnie jak powyżej dla GET /messaging/threads/{threadId}/messages, dodaliśmy nowe pola – z wyjątkiem „nextPage”.
6. Endpoint DELETE /messaging/messages/{messageId} do usuwania wiadomości oznaczyliśmy jako deprecated i w przyszłości go usuniemy.

Harmonogram prac

Poniżej znajdziesz plan zmian w dostępności ścieżek API przeznaczonych do obsługi zgłoszeń transakcyjnych (Dyskusji oraz nowych Problemów z zakupem):

ETAP I - Stan obecny:

• zarządzanie wszystkimi problemami transakcyjnymi w ramach dyskusji odbywa się standardowo poprzez ścieżkę /sale/issues,
• w dokumentacji znajdziecie dwie wersje endpointów /messaging:
  • public.v1 - dotychczasowe funkcjonalności,
  • beta.v1 - nowa struktura obejmująca dotychczasowe funkcjonalności oraz obsługę Problemów z zakupem, która wdrożona zostanie w ETAPIE III. Udostępniliśmy nową wersję póki co jedynie w naszej dokumentacji.

ETAP II - Od 3 sierpnia 2026:

• sprzedający z kontem zwykłym zaczną otrzymywać pierwsze zgłoszenia Problemów z zakupem w Centrum Wiadomości,
• jednocześnie na tym etapie proces ten nie wpłynie jeszcze bezpośrednio na Allegro API.

ETAP III - Koniec sierpnia: wdrożymy nową wersję endpointów na ścieżce /messaging, w wersji beta.v1.

ETAP IV - Od 28 października 2026 r.:

• u wszystkich sprzedających z kontem firmowym zaczniemy wprowadzać Problemy z zakupem jako nowy typ komunikacji w ramach Centrum Wiadomości, które będą obsługiwane wyłącznie przez ścieżkę /messaging,
• wszystkie utworzone wcześniej Dyskusje nadal będą obsługiwane za pomocą endpointów na ścieżce /sale/issues, które docelowo służyć będą jednak do obsługi wyłącznie reklamacji,
• nie planujemy migracji wcześniej utworzonych Dyskusji do Problemów z zakupem.

Zadbaj o to, aby do 28 października 2026 r. Twoje oprogramowanie korzystało z nowej wersji zasobów na ścieżce /messaging, która obejmuje:

• dotychczasową komunikację sprzedającego z kupującym, w ramach Centrum Wiadomości,
• obsługę nowych Problemów z zakupem.

Dlaczego wprowadzamy zmiany?

Zmiana ma na celu uporządkowanie sposobu rozwiązywania problemów transakcyjnych poprzez stopniowe przeniesienie ich z Dyskusji do wątków „Problem z zakupem” w ramach Centrum Wiadomości.

Dzięki temu sprzedający zyskają możliwość szybszego rozwiązywania spraw dzięki precyzyjnemu wskazaniu problematycznych produktów przez klientów oraz lepszą ochronę jakości sprzedaży, ponieważ kupujący nie będą mogli subiektywnie oznaczać spraw jako nierozwiązanych.

Jakie są kolejne kroki?

W przyszłości planujemy przenieść strukturę zasobu w wersji beta.v1 na wersję public.v1. Poinformujemy o tym z odpowiednim wyprzedzeniem. Natomiast do tego czasu dostępne będą obie wersje endpointów /messaging.

Więcej informacji na temat nowych funkcjonalności, znajdziesz w naszym poradniku.