Звонки в WhatsApp Cloud API

Подписка на поле calls нужна, чтобы ChatApp получал события входящих и исходящих звонков.

1. Перейдите в Meta for Developers и откройте приложение, к которому подключён номер WhatsApp* Cloud API.
2. В левом меню откройте раздел «Webhooks» или раздел «Конфигурация»
3. В разделе «Поля Webhook» найдите строку calls и включите переключатель в столбце «Подписаться». Рядом появится статус «Есть подписка».

Подробнее о событиях звонков — в официальной документации Meta*.

1. Перейдите в WhatsApp Manager → «Номера телефонов».
2. Если у вас несколько аккаунтов WhatsApp*, выберите нужный аккаунт. Нажмите на номер, подключённый к ChatApp.
3. Откройте вкладку «Настройки звонка».
4. Включите переключатель «Включите аудиозвонки». Убедитесь, что рядом отображается «Вкл.».

Подробнее о параметрах звонков — в официальной документации Meta*.

1. Перейдите в WhatsApp Manager → «Номера телефонов».
2. Выберите нужный аккаунт WhatsApp* и номер, подключённый к ChatApp.
3. Откройте вкладку «Настройки звонка».
4. В разделе «Настройки входящих звонков» найдите пункт «Укажите часы приёма звонков» и нажмите «Настроить».

Подробнее о расписании, часовом поясе и праздничных днях — в официальной документации Meta* о настройках звонков.

1. В Scenario Dialogs откройте раздел «Настройки».
2. Перейдите на вкладку «Проект».
3. Выберите «Звонки в WhatsApp».

4. Настройте переключатели:

1. Перейдите в WhatsApp Manager и выберите нужный аккаунт WhatsApp*.
2. В левом меню откройте «Шаблоны сообщений» → «Управление шаблонами».
3. Нажмите «Создать шаблон».

4. Выберите «Запрос разрешений на звонки».

Порядок заполнения шаблона и отправки на проверку описан в официальной инструкции Meta* по созданию шаблонов. Параметры шаблонов запроса разрешения на звонок — в документации Meta*.

1. В Scenario Dialogs откройте диалог с клиентом по каналу WhatsApp* Cloud API.
2. Нажмите на значок телефонной трубки в верхней части диалога.
3. Выберите «Отправить запрос».
   
4. В окне «Шаблоны WhatsApp Business» выберите одобренный шаблон для запроса разрешения на звонок.
5. Если в шаблоне есть переменные, заполните соответствующие поля по смыслу текста. Например, если переменная обозначает цель звонка, укажите «уточнить детали заказа».
   
6. Нажмите «Отправить» и дождитесь решения клиента.

В WhatsApp* клиент может выбрать один из вариантов:

Клиент может изменить настройку разрешения в профиле компании в WhatsApp*.

После получения согласия в Scenario Dialogs появляется системное сообщение:

• «Получено временное разрешение на голосовой вызов»;
  
• «Получено постоянное разрешение на голосовой вызов».
  

Когда WhatsApp* подтвердит доступность звонка, в меню станет доступна кнопка «Позвонить в WhatsApp». Если указан срок действия разрешения, проверьте его перед звонком.

Подробнее — в официальной документации Meta* о разрешениях на звонки.

Для запросов разрешения одному клиенту Meta* устанавливает ограничения:

• не более одного запроса за 24 часа;
• не более двух запросов за 7 дней.

Если повторный запрос недоступен, ориентируйтесь на сообщение в меню звонка. Ограничения и доступность действия определяются Meta*.

Подробнее — в официальной документации Meta*.

1. В Scenario Dialogs откройте диалог с клиентом по каналу WhatsApp* Cloud API.
2. Нажмите на значок телефонной трубки в верхней части диалога.
3. Убедитесь, что разрешение клиента действует и звонок доступен.
4. Нажмите «Позвонить в WhatsApp».
5. Если браузер запросит доступ к микрофону, разрешите его использование.
6. Дождитесь ответа клиента и установления соединения. Когда разговор начнётся, на панели звонка появится таймер продолжительности.

1. Когда клиент позвонит, в Scenario Dialogs появится панель входящего вызова.
2. Нажмите «Принять». Если браузер запросит доступ к микрофону, разрешите его использование.
3. Дождитесь соединения. Когда разговор начнётся, на панели появится таймер продолжительности.

Для отображения входящего вызова должен быть включён приём входящих звонков в настройках сотрудника и доступен соответствующий канал. Если у сотрудника уже идёт другой звонок, панель нового входящего вызова не появится.

Во время разговора доступны следующие действия:

1. Откройте диалог с клиентом и найдите карточку «WhatsApp вызов» со статусом «Завершён».
2. Нажмите на кнопку воспроизведения, чтобы прослушать разговор. В плеере можно поставить запись на паузу и перемотать её по шкале.
3. Для изменения скорости воспроизведения нажмите на обозначение скорости. Доступны 1×, 1,5× и 2×.
4. Чтобы сохранить запись на устройство, нажмите «Скачать аудио».

1. В карточке звонка нажмите «Расшифровать».
2. Дождитесь завершения обработки. Готовый текст раскроется автоматически.
3. Если расшифровка уже существует, нажмите «Показать текст». Чтобы свернуть её, нажмите «Скрыть текст».

При наличии текста также доступны:

• «Скачать txt» — сохранить расшифровку в текстовый файл;
• «Скопировать текст» — скопировать расшифровку в буфер обмена.

Подробнее о ChatCoins, покупке и просмотре расходов — в статье «Scenario AI-ассистент».

Если клиент уже дал согласие, а WhatsApp* пока не разрешает звонок:

• при открытом 24-часовом окне отправьте клиенту обычное сообщение;
• при закрытом 24-часовом окне отправьте другой одобренный шаблон, не связанный с запросом на звонок.

После отправки Scenario Dialogs повторно проверит доступность звонка.

Если запрос на разрешение уже отправлен и клиент ещё не ответил, дождитесь его согласия.