Компоненты диалогового взаимодействия | Документация для разработчиков

Компоненты разговора

Обновлено: 27 марта 2026 г

Компоненты для общения — это функции чата, которые можно включить для корпоративных телефонных номеров. Они упрощают взаимодействие пользователей WhatsApp с вашей компанией. Вы можете настроить простые в использовании команды и предоставить заранее подготовленные варианты начала разговора, на которые пользователи могут нажимать.

Ограничения

Если пользователь WhatsApp нажимает на универсальную ссылку( то есть wa.me ), содержащую предварительно заполненный текст, интерфейсы для начала разговора автоматически закрываются.

Настройка с помощью WhatsApp Manager (WAM)

Все эти функции можно настроить в WhatsApp Manager для выбранных вами номеров:

Перейдите в панель управления «Мои приложения» на сайте Meta for Developers.Выберите своё приложение, затем на левой панели выберите «Настройки» в разделе WhatsApp.В разделе «Номера телефонов» выберите «Управление номерами телефонов».В правой части экрана рядом с номером телефона, который вы хотите настроить, выберите значок шестеренки в разделе «Настройки».Выберите «Автоматизация».Получите доступ к компонентам диалогового взаимодействия и настройте их.

Партнеры по решениям также могут настраивать эти функции для своих клиентов, если у них есть доступ к бизнес-аккаунту WhatsApp своих клиентов в WhatsApp Manager.

Ледоколы

«Ледоколы» — это настраиваемые текстовые строки, которые появляются в цепочке сообщений при первом общении с пользователем. Например, «Спланируйте поездку» или «Составьте план тренировок».

Использование приемов для начала разговора отлично подходит для взаимодействия в сфере услуг, например, в службе поддержки клиентов или при работе с учетными записями. Например, вы можете встроить кнопку WhatsApp в свое приложение или веб-сайт. Когда пользователи нажимают на кнопку, они перенаправляются в WhatsApp, где могут выбрать один из настраиваемых вариантов, демонстрирующих, как взаимодействовать с вашими услугами.

В чате WhatsApp кнопки для начала разговора отображаются как варианты, на которые можно нажать

На рабочем телефонном номере можно настроить до 4 вариантов начала разговора. Каждый вариант может содержать максимум 80 символов. Использование эмодзи не поддерживается.

Когда пользователь нажимает на кнопку «Начать разговор», запускается стандартный веб-перехватчик получения сообщения. Строка кнопки «Начать разговор» присваивается body в полезной нагрузке. Если пользователь попытается отправить вам сообщение вместо того, чтобы нажать на кнопку «Начать разговор», клавиатура отобразится в виде всплывающего окна, но её можно закрыть, чтобы снова увидеть меню «Начать разговор».

Если пользователь WhatsApp нажимает на универсальную ссылку( ,wa.me или api.whatsapp.com содержащую предварительно заполненный текст, интерфейсы для начала разговора автоматически закрываются.

Полезная нагрузка веб-перехватчика

{ "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<WHATSAPP_USER_NAME> " }, "wa_id": "<WHATSAPP_USER_ID> " } ], "сообщения": [ { "из": "<WHATSAPP_USER_PHONE_NUMBER_ID> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<TIMESTAMP> ", "text": { "body": "Спланируйте поездку" }, "type": "text" } ] }, "field": "messages" } ] } ] }

Команды

Команды — это текстовые строки, которые пользователи WhatsApp могут увидеть, набрав косую черту в переписке с вашей компанией.

Меню команд появляется, когда пользователь вводит косую черту в WhatsApp

Команды состоят из самой команды и подсказки, которая дает пользователю представление о том, что может произойти при использовании команды. Например, можно определить команду:

/imagine - Создание изображений с помощью текстовой подсказки

Когда пользователь WhatsApp вводит /imagine cars racing on Mars, это запускает веб-хук получения сообщения, в теле . Затем можно сгенерировать и вернуть изображение гоночных автомобилей на планете Марс.

Вы можете задать до 30 команд. Каждая команда содержит максимум 32 символа, а каждая подсказка — максимум 256 символов. Эмодзи не поддерживаются.

Полезная нагрузка веб-перехватчика

{ "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<WHATSAPP_USER_NAME> " }, "wa_id": "<WHATSAPP_USER_ID> " } ], "сообщения": [ { "из": "<WHATSAPP_USER_PHONE_NUMBER_ID> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<TIMESTAMP> ", "text": { "body": "/imagine cars racing on Mars" }, "type": "text" } ] }, "field": "messages" } ] } ] }

Настройте с помощью API

С помощью API вы также можете настраивать компоненты диалога и просматривать любые заданные значения.

API компонентов диалогового взаимодействия имеет две конечные точки:

ПОЧТА / который используется для настройки компонентов диалога по заданному номеру телефона.

ПОЛУЧАТЬ / Эта функция возвращает текущие значения полей команд и подсказок для заданного номера телефона.

Настройте компоненты диалога через API

Вы можете настроить компоненты диалога для заданного номера телефона, позвонив по POST-запросу.

Синтаксис запроса

// Настройка команд с указанием имен и описаний POST /<PHONE_NUMBER_ID> /conversational_automation?commands=<COMMAND_LIST> // Настройка подсказок POST /<PHONE_NUMBER_ID> /conversational_automation?prompts=<PROMPT>

Свойства тела

Заполнитель	Описание	Пример значения
`<PHONE_NUMBER_ID>` Нить	Необходимый. Идентификатор телефонного номера в аккаунте WhatsApp Business.	`+12784358810`
`<COMMAND_LIST>` JSON	Необязательный. Список команд, подлежащих настройке.	[ { “command_name”: “generate”, “command_description”: “Создать новое изображение” }, { “command_name”: “rethink”, “command_description”: “Создать новые изображения из существующих изображений” } ]
`<PROMPTS>` Список строк	Необязательный. Запрос(ы), подлежащий(ие) настройке.	`"подсказки": ["Забронируйте рейс","спланируйте отпуск"]`

Пример запроса

   curl -X POST \ 'https://graph.facebook.com/v22.0/PHONE_NUMBER_ID/conversational_automation' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "commands": [ { "command_name": "tickets", "command_description": "Book flight tickets" }, { "command_name": "hotel", "command_description": "Book hotel" } ], "prompts": ["Book a flight", "plan a vacation"] }'

Пример ответа

{ "success": true }

Просмотреть текущую конфигурацию можно с помощью API

Текущую конфигурацию компонентов диалога для заданного номера телефона можно просмотреть, позвонив по GET-запросу.

Синтаксис запроса

ПОЛУЧАТЬ /<PHONE_NUMBER_ID> ?fields=conversational_automation

Пример ответа

{ "conversational_automation": { "prompts": [ "Найти лучшие отели в этом районе", "Найти выгодные предложения по аренде автомобилей" ], "commands": [ { "command_name": "tickets", "command_description": "Забронировать авиабилеты" }, { "command_name": "hotel", "command_description": "Забронировать отель" } ] }, "id": "123456" }

Тестирование

Чтобы протестировать компоненты диалога после их настройки, откройте клиент WhatsApp и начните чат, используя свой рабочий номер телефона.

Для начала разговора, если у вас уже есть чат с номером телефона компании, сначала необходимо удалить этот чат:

Откройте переписку в приложении WhatsApp.Нажмите на профиль телефонного номера компании.Нажмите «Очистить чат» > «Очистить все сообщения».Удалить чат.Начните новый диалог с этой компанией.

Затем вы можете отправить сообщение на рабочий телефонный номер, чтобы проверить свои способы начать разговор.