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

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

Обновлено: 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 компонентов диалогового взаимодействия имеет две конечные точки:

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

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

Настройте компоненты диалога через 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.Нажмите на профиль телефонного номера компании.Нажмите «Очистить чат» > «Очистить все сообщения» .Удалить чат.Начните новый диалог с этой компанией.

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