Перейти к основному содержимому

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

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

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

Ограничения

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

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

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

    Лед выключатели

    «Ледоколы» — это настраиваемые текстовые строки, которые появляются в цепочке сообщений при первом общении с пользователем. Например, «Спланируйте поездку» или «Составьте план тренировок».
    Использование приемов для начала разговора отлично подходит для взаимодействия в сфере услуг, например, в службе поддержки клиентов или при работе с учетными записями. Например, вы можете встроить кнопку WhatsApp в свое приложение или веб-сайт. Когда пользователи нажимают на кнопку, они перенаправляются в WhatsApp, где могут выбрать один из настраиваемых вариантов, демонстрирующих, как взаимодействовать с вашими услугами.
    В чате WhatsApp кнопки для начала разговора отображаются как варианты, на которые можно нажать
    На рабочем телефонном номере можно настроить до 4 вариантов начала разговора. Каждый вариант может содержать максимум 80 символов. Использование эмодзи не поддерживается.
    Когда пользователь нажимает на кнопку «Ледокол», запускается стандартный веб-перехватчик, отправляющий сообщение. Строка ледокола присваивается пользователю тело свойство в полезной нагрузке. Если пользователь попытается отправить вам сообщение вместо того, чтобы нажать на кнопку «Начать разговор», клавиатура отобразится поверх всего остального, но её можно закрыть, чтобы снова увидеть меню «Начать разговор».
    Если пользователь 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 набирает текст, Представьте себе гонки автомобилей на МарсеЭто вызовет срабатывание веб-перехватчика для получения сообщения, содержащего именно эту текстовую строку тело свойство. Затем вы могли бы сгенерировать и вернуть изображение автомобилей, участвующих в гонках на планете Марс.
    Вы можете задать до 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 компонентов диалогового взаимодействия имеет две конечные точки:
    ПОЧТА /<PHONE_NUMBER_ID> /conversational_automation который используется для настройки компонентов диалога по заданному номеру телефона.
    ПОЛУЧАТЬ /<PHONE_NUMBER_ID> /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.Нажмите на рабочий телефон число'число'профиль.Нажмите «Очистить чат» > «Очистить все сообщения» .Удалить чат.Начните новый диалог с этой компанией.

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

            
      
        
      
    
      

    
      

    
    
      
        
      
             Вернуться наверх