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.

Włączanie narzędzi

Wyślij przyciski interaktywne

Wyślij przyciski interaktywne prezentuje od jednej do trzech opcji w bieżącej rozmowie przez wiadomości WhatsApp.

Każdy przycisk ma:

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.

Każda sekcja ma:

Każdy wiersz ma:

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:

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 mówi mu, jak dobrze z nich korzystać.

---
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.