인터랙티브 메시지

에이전트가 WhatsApp 대화에서 탭 가능한 버튼과 목록을 제공하도록 설정하세요

개요

사용자에게 답변을 입력하도록 요청하는 대신, 에이전트는 WhatsApp 인터랙티브 메시지를 전송할 수 있습니다. 탭 가능한 답장 버튼은 최대 3개, 옵션 목록은 최대 10개까지 제공할 수 있습니다. 사용자가 탭하면 다음 메시지로 전달되며, 에이전트는 어떤 옵션이 선택되었는지 정확히 확인합니다.

인터랙티브 메시지는 활성 WhatsApp 메시지 대화에서만 작동합니다. 에이전트는 다음 두 통합 도구를 통해 메시지를 전송합니다.

  • 인터랙티브 버튼 전송 — 적은 수의 선택지에 적합한 최대 3개의 답장 버튼입니다.
  • 인터랙티브 목록 전송 — 3개를 초과하는 선택지에 적합한, 섹션별로 그룹화된 탭 가능한 옵션 목록입니다.
사용자가 목록 메뉴와 답장 버튼을 사용해 통화 시간을 구매합니다.

출처: WhatsApp 인터랙티브 메시지에 대한 Meta 가이드.

도구 활성화

1

WhatsApp 통합 추가

WhatsApp 비즈니스 계정을 가져온 후(안내), 통합 페이지로 이동하여 _통합 추가 _ 버튼을 클릭하고 WhatsApp을 선택한 다음 계정을 연결하세요.

2

도구 추가

도구 페이지로 이동하여 _통합 도구 추가 _ 버튼을 클릭하고 WhatsApp 통합을 선택한 다음, _ 인터랙티브 버튼 전송 _ 및 인터랙티브 목록 전송 도구를 추가하세요.

WhatsApp 계정을 두 개 이상 가져온 경우 각 계정에는 자체 WhatsApp 통합이 있습니다. 에이전트가 사용하는 계정에 연결된 통합에서 도구를 추가해야 합니다. 다른 계정의 통합에서 추가한 도구는 이 에이전트의 대화에서 작동하지 않습니다.

3

에이전트에 도구 연결

에이전트 구성에 도구를 추가하세요. 도구는 항상 실시간 대화의 사용자에게 메시지를 보냅니다. 콘텐츠는 에이전트가 선택하며, 수신자는 선택하지 않습니다.

인터랙티브 버튼 전송

인터랙티브 버튼 전송은 현재 WhatsApp 메시지 대화에서 1~3개의 선택지를 제공합니다.

매개변수필수설명
body_text예버튼 위에 표시되는 메시지입니다. 최대 1024자입니다.
buttons예표시 순서대로 나열한 1~3개의 버튼입니다. 제목은 고유해야 합니다.
footer_text아니요버튼 아래에 표시되는 작은 글씨입니다. 최대 60자입니다.

각 버튼에는 다음 항목이 있습니다.

필드필수설명
id예사용자가 이 버튼을 탭할 때 반환되는 식별자입니다. 최대 256자입니다.
title예버튼 레이블입니다. 최대 20자입니다.

인터랙티브 목록 전송

인터랙티브 목록 전송은 현재 WhatsApp 메시지 대화에서 섹션별로 그룹화된 옵션을 제공합니다. 사용자는 목록을 열고 행을 선택합니다.

매개변수필수설명
body_text예목록 위에 표시되는 메시지입니다. 최대 4096자입니다.
button_text예목록을 여는 버튼의 레이블입니다. 최대 20자입니다.
sections예1~10개의 옵션 그룹입니다. 목록은 모든 섹션을 합쳐 최대 10개의 행을 포함할 수 있습니다.
header_text아니요메시지 본문 위에 표시되는 제목입니다. 최대 60자입니다.
footer_text아니요목록 아래에 표시되는 작은 글씨입니다. 최대 60자입니다.

각 섹션에는 다음 항목이 있습니다.

필드필수설명
title예섹션 제목입니다. 최대 24자입니다.
rows예이 섹션의 옵션 1~10개입니다.

각 행에는 다음 항목이 있습니다.

필드필수설명
id예사용자가 이 행을 선택할 때 반환되는 식별자입니다. 최대 200자입니다.
title예행 레이블입니다. 최대 24자입니다.
description아니요행 레이블 아래에 표시되는 보조 텍스트입니다. 최대 72자입니다.

에이전트가 제한을 초과하는 콘텐츠를 생성하면 도구 호출이 실패하고 에이전트에 이유가 전달되므로, 더 짧은 콘텐츠로 다시 시도할 수 있습니다.

에이전트 프롬프트 작성

시스템 프롬프트에서 에이전트가 언제 선택지를 제공해야 하는지 알려주세요. 예를 들면 다음과 같습니다.

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.

선택 사항: 에이전트의 도구 사용을 안내하는 절차 추가

에이전트에 도구를 제공하는 것은 작업의 절반일 뿐입니다. 절차는 도구를 효과적으로 사용하는 방법을 안내합니다.

아래 절차는 바로 사용할 수 있는 내용이 아니라 템플릿입니다. 복사한 후 용도에 맞게 수정하세요. 흐름에 맞게 트리거를 조정하고, 에이전트에 실제로 있는 도구만 유지하며, 사용 사례에 맞게 옵션 예시와 규칙을 다시 작성하세요.

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

제약 사항

  • 인터랙티브 메시지는 메시지 대화에서만 전송할 수 있습니다. WhatsApp 음성 통화 중이거나 다른 채널에서는 전송할 수 없습니다.
  • WhatsApp Flows(인터랙티브 양식)는 지원되지 않습니다. 사용자가 Flow 응답을 보내면 에이전트에 전달되지 않습니다.
  • 인터랙티브 메시지는 세션 메시지입니다. 첫 발신 연락으로는 전송할 수 없고 활성 대화 안에서만 보낼 수 있습니다. 대화를 시작하려면 메시지 템플릿을 사용하세요.