> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Wiadomości interaktywne ## Omówienie Zamiast prosić użytkownika o wpisanie odpowiedzi, agent może wysyłać w WhatsApp **wiadomości interaktywne**: do trzech przycisków odpowiedzi do kliknięcia lub listę do dziesięciu opcji. Kliknięcie użytkownika wraca jako jego kolejna wiadomość, a agent dokładnie widzi, którą opcję wybrano. Wiadomości interaktywne działają tylko w aktywnych rozmowach przez wiadomości WhatsApp. Agent wysyła je za pomocą dwóch narzędzi integracji: * **Wyślij przyciski interaktywne** — do trzech przycisków odpowiedzi, dla niewielkiej liczby opcji. * **Wyślij listę interaktywną** — lista opcji do kliknięcia podzielona na sekcje, dla więcej niż trzech opcji. Źródło: [przewodnik Meta po interaktywnych wiadomościach WhatsApp](https://developers.facebook.com/docs/whatsapp/guides/interactive-messages/). ## Włączanie narzędzi #### Dodaj integrację WhatsApp Zaimportuj konto firmowe WhatsApp ([instrukcje](/docs/pl/eleven-agents/whatsapp)), a następnie przejdź na [stronę Integracje](https://elevenlabs.io/app/agents/integrations), kliknij przycisk **\_Dodaj integrację \_**, wybierz WhatsApp i połącz konto. #### Dodaj narzędzia Przejdź na [stronę Narzędzia](https://elevenlabs.io/app/agents/tools), kliknij przycisk **\_Dodaj narzędzie integracji \_**, wybierz integrację WhatsApp i dodaj narzędzia **\_ Wyślij przyciski interaktywne \_** oraz ***Wyślij listę interaktywną***. > **Warning** > > Jeśli zaimportowano więcej niż jedno konto WhatsApp, każde ma własną integrację WhatsApp. > Upewnij się, że dodajesz narzędzia z integracji połączonej z kontem używanym przez agenta — > narzędzia dodane z integracji innego konta nie będą działać w rozmowach tego > agenta. #### Podłącz narzędzia do agenta Dodaj narzędzia w konfiguracji agenta. Narzędzia zawsze wysyłają wiadomość do użytkownika trwającej rozmowy — agent wybiera treść, ale nigdy odbiorcę. ## Wyślij przyciski interaktywne **Wyślij przyciski interaktywne** prezentuje od jednej do trzech opcji w bieżącej rozmowie przez wiadomości WhatsApp. | Parametr | Wymagany | Opis | | ------------- | -------- | ------------------------------------------------------------------------------------- | | `body_text` | Tak | Wiadomość wyświetlana nad przyciskami. Maks. 1024 znaki. | | `buttons` | Tak | Od jednego do trzech przycisków w kolejności wyświetlania. Tytuły muszą być unikalne. | | `footer_text` | Nie | Drobny tekst wyświetlany pod przyciskami. Maks. 60 znaków. | Każdy przycisk ma: | Pole | Wymagane | Opis | | ------- | -------- | ---------------------------------------------------------------------------------------- | | `id` | Tak | Identyfikator zwracany po kliknięciu tego przycisku przez użytkownika. Maks. 256 znaków. | | `title` | Tak | Etykieta przycisku. Maks. 20 znaków. | ## Wyślij listę interaktywną **Wyślij listę interaktywną** prezentuje opcje pogrupowane w sekcje w bieżącej rozmowie przez wiadomości WhatsApp. Użytkownik otwiera listę i wybiera wiersz. | Parametr | Wymagany | Opis | | ------------- | -------- | --------------------------------------------------------------------------------------------- | | `body_text` | Tak | Wiadomość wyświetlana nad listą. Maks. 4096 znaków. | | `button_text` | Tak | Etykieta przycisku otwierającego listę. Maks. 20 znaków. | | `sections` | Tak | Od jednej do 10 grup opcji. Lista może zawierać do 10 wierszy we wszystkich sekcjach łącznie. | | `header_text` | Nie | Nagłówek wyświetlany nad treścią wiadomości. Maks. 60 znaków. | | `footer_text` | Nie | Drobny tekst wyświetlany pod listą. Maks. 60 znaków. | Każda sekcja ma: | Pole | Wymagane | Opis | | ------- | -------- | ----------------------------------- | | `title` | Tak | Nagłówek sekcji. Maks. 24 znaki. | | `rows` | Tak | Od jednej do 10 opcji w tej sekcji. | Każdy wiersz ma: | Pole | Wymagane | Opis | | ------------- | -------- | ----------------------------------------------------------------------------- | | `id` | Tak | Identyfikator zwracany, gdy użytkownik wybierze ten wiersz. Maks. 200 znaków. | | `title` | Tak | Etykieta wiersza. Maks. 24 znaki. | | `description` | Nie | Tekst dodatkowy wyświetlany pod etykietą wiersza. Maks. 72 znaki. | Jeśli agent utworzy treść przekraczającą limit, wywołanie narzędzia się nie powiedzie, a agent dowie się dlaczego, dzięki czemu może spróbować ponownie z krótszą treścią. ## Instrukcje dla agenta Powiedz agentowi w prompcie systemowym, kiedy ma oferować wybory. Na przykład: ```text When you need the user to pick from a fixed set of options (appointment slots, product variants, yes/no confirmations), use the Send Interactive Buttons tool for up to 3 options or the Send Interactive List tool for more. Keep option titles short. Do not use interactive messages for open-ended questions. ``` ### Opcjonalnie: dodaj procedurę, aby pokierować użyciem narzędzi przez agenta Przekazanie agentowi narzędzi to połowa pracy — [procedura](/docs/pl/eleven-agents/customization/procedures) mówi mu, jak dobrze z nich korzystać. > **Note** > > Poniższa procedura to szablon, a nie gotowe rozwiązanie. Po skopiowaniu dostosuj ją do siebie: > zmień wyzwalacz pod swoje procesy, zachowaj tylko narzędzia, które faktycznie ma twój agent, i przeredaguj przykłady > opcji oraz zasady pod swój przypadek użycia. #### Skopiuj przykładową procedurę ```markdown --- name: Offer choices with interactive messages trigger: The user must pick from a fixed set of known options in a WhatsApp message conversation, such as appointment slots, product variants, or order confirmations. --- Offer the options as an interactive message instead of asking the user to type an answer. 1. Check which interactive tools you have. Prefer Send Interactive Buttons for 2–3 options and Send Interactive List for 4–10. If only one of the two is available, use it for any option count that fits its limits; if no interactive tool fits, ask the question in plain text. Never present more than 10 options; narrow them down with a question first. 2. Write a body_text that asks one clear question. Do not stack multiple questions into one interactive message. 3. Give every option a stable, machine-readable id (for example slot_2026-08-20_10am) and a short human title — 20 characters for buttons, 24 for list rows. 4. For lists, group related rows into titled sections, and add a description to a row only when its title alone is ambiguous. 5. Send the message with the tool, then wait for the user's reply. Do not send a second interactive message before the user responds to the first. 6. Treat the reply as the user's choice. Confirm it back in one short line and continue the flow. Rules: - Never use interactive messages for open-ended questions. - When the fixed options may not cover everyone, include a final option such as "Something else" and follow up with a free-text question. - If the tool call fails because content exceeds a limit, shorten titles and descriptions and retry once. - If the user types an answer instead of tapping, accept it — do not re-send the options. ``` ## Ograniczenia * Wiadomości interaktywne można wysyłać tylko w rozmowach przez **wiadomości** — nie podczas połączeń głosowych WhatsApp ani na innych kanałach. * WhatsApp Flows (interaktywne formularze) nie są obsługiwane. Jeśli użytkownik odpowie przez Flow, odpowiedź nie zostanie przekazana agentowi. * Wiadomości interaktywne są wiadomościami sesyjnymi: można je wysyłać tylko w aktywnej rozmowie, a nie jako pierwszy kontakt wychodzący. Do rozpoczynania rozmów używaj [szablonów wiadomości](/docs/pl/eleven-agents/whatsapp/outbound).