> For the complete documentation index, see [llms.txt](https://docs.messageflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.messageflow.com/pl/rcs/rcs-flow-studio-tworzenie-wiadomosci-i-scenariuszy/bloki-zaawansowane-integracje-z-twoim-api.md).

# Bloki zaawansowane - integracje z Twoim API

Dwa bloki pozwalają połączyć rozmowę z Twoimi systemami: Karuzela dynamiczna (buduje karty na podstawie danych z API) oraz HTTP Request (wywołuje API w tle). Wymagają współpracy z osobą techniczną po Twojej stronie — poniżej znajdziesz, co przygotować i jak to przetestować.

#### Karuzela dynamiczna

Zamiast wpisywać karty ręcznie, kreator pobiera je w czasie rzeczywistym z Twojego API — idealne dla oferty, która często się zmienia (produkty, dostępność, ceny).

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FAGPnfx0qz7fu5hmcPDGM%2FZrzut%20ekranu%202026-10-12%20o%2011.54.06.png?alt=media&amp;token=6e274cf2-753f-4478-8b7e-9453852a3fe0" alt=""><figcaption></figcaption></figure>

Co przygotować (po stronie technicznej):

* Adres (URL) endpointu, który zwróci dane — wywoływany metodą GET.
* Odpowiedź w formacie JSON — tablica obiektów, gdzie każdy element ma: title (tytuł), description (opis) oraz obraz w polu media\_url / image\_url / imageUrl / mediaUrl.
* Wartości sugestii w przewidywalnym formacie (np. z prefiksem kat\_), żeby dało się na nie zareagować w bloku Decyzja.

Przykładowa odpowiedź API:

```
[
  {
    "title": "Buty do biegania",
    "description": "Lekkie, na każdą pogodę",
    "media_url": "https://twojsklep.pl/img/buty.jpg"
  },
  {
    "title": "Kurtka sportowa",
    "description": "Oddychająca membrana",
    "image_url": "https://twojsklep.pl/img/kurtka.jpg"
  }
]

```

#### Jak skonfigurować:

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FksyypFF3NRza0bDuPGIu%2FZrzut%20ekranu%202026-10-12%20o%2011.55.01.png?alt=media&amp;token=5cdbb35b-6763-4660-ad0b-e5b2089f81f9" alt=""><figcaption></figcaption></figure>

1. Dodaj blok Karuzela dynamiczna i wklej adres (URL) endpointu.
2. Dodaj wymagane nagłówki (np. autoryzację) i ustaw „Limit czasu” (zgodnie z zakresem w kreatorze).
3. Ustaw obsługę błędu: „Nie rób nic” lub „Przejdź do” wskazanego bloku (opcjonalnie z ponawianiem).
4. Poprowadź wspólne wyjście po kliknięciu karty do bloku Set Value, a następnie do bloku Decyzja.

{% hint style="info" %}
Jak reagować na kliknięcia: karty z API mają jedno wspólne wyjście „po kliknięciu”. Aby rozpoznać, co wybrał odbiorca, zapisz wartość w zmiennej (Set Value), a potem rozgałęź rozmowę blokiem Decyzja według tej wartości. <br>

Uwagi i ograniczenia: karty z API nie mają osobnych przycisków per karta; szerokość kart jest stała. Obsługiwany jest wyłącznie format JSON. Jeśli po stronie API zmienią się wartości sugestii, pamiętaj o aktualizacji warunków w bloku Decyzja.
{% endhint %}

#### HTTP Request

Ten blok nie wysyła wiadomości do odbiorcy — działa w tle. Pobiera dane z Twojego systemu (np. status zamówienia) albo je do niego wysyła (np. zapis zgody). Pobrane dane możesz zapisać w zmiennych i użyć w dalszej rozmowie.

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FlOctNDINtdVZLl3asFFL%2FZrzut%20ekranu%202026-10-16%20o%2009.18.14.png?alt=media&amp;token=1f328d40-03e1-4c04-9e5a-59e7abe7384b" alt=""><figcaption></figcaption></figure>

Co przygotować:

* Adres (URL) i metodę — GET, POST, PUT, DELETE lub PATCH.
* Nagłówki (np. token autoryzacyjny) jako pary nazwa–wartość.
* Treść żądania (body) — dla POST/PUT/PATCH; możesz wstawiać zmienne przez {{zmienna}}.
* Nazwy zmiennych zgodne z polami w odpowiedzi (patrz niżej).

Jak zapisać dane z odpowiedzi w zmiennych:

Odpowiedź JSON jest „spłaszczana”, dzięki czemu do pól zagnieżdżonych odwołujesz się kropką i nawiasami, np. user.name albo orders\[0].id. Utwórz zmienne o nazwach dokładnie odpowiadających tym polom — kreator dopasuje wartości automatycznie.

```
// Odpowiedź z API:
{ "user": { "name": "Anna", "points": 340 } }
 
// Utwórz zmienne o nazwach:
user.name    -> zapisze "Anna"
user.points  -> zapisze 340

```

{% hint style="info" %}
Mapowanie pól: dopasowanie działa po nazwie. Zadbaj, aby nazwy zmiennych i typy odpowiadały polom w odpowiedzi. Klucze, do których nie ma pasującej zmiennej, są po prostu pomijane.
{% endhint %}

#### Jak skonfigurować i przetestować:

<figure><img src="https://329730659-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2s632FgUSm9RH1pVB9a%2Fuploads%2FRvpPmkXZ7IWwdTjVzJDZ%2FZrzut%20ekranu%202026-10-12%20o%2011.58.17.png?alt=media&amp;token=d3a945fe-702b-4ee2-af42-6dd47f66a19f" alt=""><figcaption></figcaption></figure>

1. Dodaj blok HTTP Request, wpisz adres i wybierz metodę.
2. Dodaj nagłówki i — jeśli trzeba — treść żądania ze zmiennymi.
3. Utwórz zmienne odpowiadające polom odpowiedzi, które chcesz zachować.
4. Ustaw „Limit czasu” (zgodnie z zakresem w kreatorze) i skonfiguruj obsługę błędu („Nie rób nic” lub „Przejdź do” bloku).
5. Przetestuj na przykładowych danych i sprawdź, czy zmienne uzupełniły się poprawnie.

Ponawianie: w obsłudze błędu możesz włączyć ponawianie prób (retry) — maksymalnie 3.

{% hint style="info" %}
Kiedy uruchamia się obsługa błędu: błąd połączenia lub przekroczenie limitu czasu, odpowiedź HTTP 4xx/5xx albo nieoczekiwany błąd. Jeśli odpowiedź jest poprawna, ale któreś pole nie pasuje do żadnej zmiennej, jest po prostu pomijane (to nie jest błąd).
{% endhint %}
