# Pobieranie wiadomości

Jak Ritevo pobiera wiadomości, dyskusje i reklamacje z kanałów sprzedaży, poczty i komunikatorów, jak często to robi i co zrobić, gdy wiadomości nie widać.

Ritevo zbiera wiadomości od klientów ze wszystkich podłączonych kanałów w jednej skrzynce. Ta strona opisuje zasady wspólne dla każdej integracji - niezależnie od tego, czy to marketplace, sklep, poczta e-mail czy komunikator.

> **Wymagana integracja:** Potrzebujesz co najmniej jednej integracji, która obsługuje wiadomości: **marketplace** (np. Allegro), **sklepu internetowego**, **poczty e-mail** albo **komunikatora** (np. Messenger). Nie każda integracja ma wiadomości - jeśli ich nie obsługuje, w jej ustawieniach nie ma przełącznika **Pobieranie wiadomości**.

## Włączanie i wyłączanie pobierania

Pobieranie wiadomości ustawiasz **osobno dla każdej integracji**. Po dodaniu nowej integracji jest ono **wyłączone** - dopóki go nie włączysz, z tego kanału nie pobieramy wiadomości.

Żeby je włączyć:

1. Wejdź w **Integracje** i otwórz integrację, z której chcesz pobierać wiadomości.
2. Włącz przełącznik **Pobieranie wiadomości**.
3. Zapisz zmiany.

![Przełącznik „Pobieranie wiadomości" w ustawieniach integracji](https://ritevo.com/docs/messages/pl-fetch-messages-toggle.webp)

Pobieranie wyłączysz w każdej chwili tym samym przełącznikiem. Wiadomości pobrane wcześniej zostają w Ritevo, przestają tylko dochodzić nowe z tej integracji.

Pobieranie wiadomości i [pobieranie zamówień](https://ritevo.com/pl/docs/orders/fetching-orders) to dwa niezależne przełączniki. Możesz mieć włączone jedno, drugie albo oba.

## Jak często sprawdzamy wiadomości

- **Marketplace'y, sklepy i poczta e-mail**: każdą integrację sprawdzamy mniej więcej **co 10 minut**.
- **Komunikatory** (Messenger, WhatsApp): wiadomość trafia do Ritevo **od razu**, gdy klient ją wyśle.

## Co pobieramy

Każdy wątek w Ritevo ma jeden z trzech typów:

- **Wiadomość** (API: "Wiadomość" = `MESSAGE`; wartość w `threadType`) - zwykła rozmowa z klientem. Obsługuje ją każda integracja z wiadomościami.
- **Dyskusja** (API: "Dyskusja" = `DISCUSSION`; wartość w `threadType`) - spór otwarty przez klienta w kanale sprzedaży.
- **Reklamacja** (API: "Reklamacja" = `CLAIM`; wartość w `threadType`) - zgłoszenie reklamacyjne z kanału sprzedaży.

Dyskusje i reklamacje pobieramy tylko z tych kanałów sprzedaży, które same je prowadzą. Poczta e-mail i komunikatory mają wyłącznie wiadomości. Które typy obsługuje konkretna integracja, przeczytasz na jej stronie.

## Gdzie zobaczysz pobrane wiadomości

Wszystkie wątki trafiają do wspólnej skrzynki w zakładce **Wiadomości**. Przy każdym widać, z której integracji pochodzi i jakiego jest typu.

## Wiadomość a zamówienie

W części integracji wiadomość, dyskusja albo reklamacja odnosi się do konkretnego zamówienia. Ritevo łączy wtedy wątek z tym zamówieniem, żebyś od razu widział, czego dotyczy rozmowa.

> **Warto wiedzieć:** Jeśli takiego zamówienia nie ma jeszcze w Ritevo, **samo je dociągamy** - także wtedy, gdy pobieranie zamówień dla tej integracji jest wyłączone. Dociągamy tylko to jedno, powiązane zamówienie. Więcej w [Pobieranie zamówień](https://ritevo.com/pl/docs/orders/fetching-orders#linked-orders).

## Nie widzę wiadomości

> **Warto wiedzieć:** Najczęstsza przyczyna: integracja pokazuje **Wymaga ponownego połączenia**. Zwykle oznacza to, że dostęp, którego udzieliłeś Ritevo w tym kanale, wygasł albo został cofnięty - na przykład po zmianie hasła lub po upływie ważności połączenia. Dopóki nie połączysz integracji ponownie, wiadomości z tego kanału nie są pobierane.

Sprawdź po kolei:

1. Czy integracja jest **Aktywna**.
2. Czy ma włączone **Pobieranie wiadomości** - po dodaniu integracji jest ono domyślnie wyłączone.
3. Czy ta integracja w ogóle obsługuje wiadomości - jeśli nie, przełącznika nie ma.
4. Czy minęło już kilkanaście minut od wysłania wiadomości (nie dotyczy komunikatorów).

## Typy i statusy wątków przez API

Dyskusje i reklamacje mają dodatkowo status (`threadStatus`):

- **Trwa**, **Zamknięta**, **Nierozwiązana** (API: "Trwa" = `DISPUTE_ONGOING`, "Zamknięta" = `DISPUTE_CLOSED`, "Nierozwiązana" = `DISPUTE_UNRESOLVED`; wartość w `threadStatus`) - statusy dyskusji.
- **Złożona**, **Zaakceptowana**, **Odrzucona** (API: "Złożona" = `CLAIM_SUBMITTED`, "Zaakceptowana" = `CLAIM_ACCEPTED`, "Odrzucona" = `CLAIM_REJECTED`; wartość w `threadStatus`) - statusy reklamacji.

Co potrafi każdy kanał (odpowiadanie, załączniki, limit znaków), zwraca `GET /integrations/messages/capabilities`. Aktualny kształt odpowiedzi jest w Swaggerze: https://api.ritevo.com/api/v1/api-docs.


---

Cała pomoc w jednym pliku: https://ritevo.com/llms-full.txt. Mapa pomocy z linkami do wszystkich stron: https://ritevo.com/llms.txt.