> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Звонки в WhatsApp

> Узнайте о входящих и исходящих голосовых вызовах в WhatsApp, разрешениях клиентов и вариантах интеграции с YCloud.

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

## Входящие и исходящие вызовы

| Направление | Кто инициирует | Основное требование |
| - | - | - |
| Входящий (инициирован пользователем) | Клиент звонит в вашу компанию. | Звонки включены, и приём вызовов настроен. |
| Исходящий (инициирован компанией) | Ваша компания звонит клиенту. | Номер соответствует требованиям, и клиент предоставил необходимое разрешение на звонок. |

Обычная кнопка с номером телефона запускает телефонный звонок вне WhatsApp. Кнопка вызова WhatsApp и запрос разрешения на звонок — это разные типы взаимодействия.

## Проверьте доступность перед проектированием рабочего процесса

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

Проверьте конкретный номер, который планируете использовать. Не считайте, что номер, доступный для отправки сообщений, автоматически подходит для исходящих вызовов или что [сосуществование приложений (app coexistence)](/ru/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence) предоставляет доступ через API к звонкам из приложения.

Meta обновляет правила разрешений и лимиты звонков. Обратитесь к [документации по звонкам](https://developers.facebook.com/docs/whatsapp/cloud-api/calling/) для получения актуальных правил провайдера и уточните поддерживаемую конфигурацию в YCloud.

## Разрешение на отправку сообщений не является разрешением на звонок

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

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

С уважением относитесь к отказу или отзыву согласия. Повторные неотвеченные вызовы — это повод остановиться и пересмотреть время контакта, а не увеличивать количество попыток.

<Frame caption="Meta example: the customer opens a call-permission request and chooses whether to allow calls. The available controls depend on the current client and eligibility.">
  <img src="https://mintcdn.com/lchnan/3gBf_HfRdWRqXdyx/images/whatsapp-platform/meta-calling-permission.jpg?fit=max&auto=format&n=3gBf_HfRdWRqXdyx&q=85&s=fd6ad0dd0421c4b5e4abdc2c7d35a8e0" alt="Три экрана WhatsApp, показывающие запрос бизнес-разрешения на звонок, варианты выбора для клиента и разрешённое состояние." className="bg-white" width="1228" height="816" data-path="images/whatsapp-platform/meta-calling-permission.jpg" />
</Frame>

Источник: [официальный пример Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/user-call-permissions/).

## Выберите способ интеграции с YCloud

В документации YCloud описаны два подхода:

* **Звонки через платформу YCloud:** ваша команда обрабатывает вызовы через интерфейс консоли.
* **Интеграция по API:** ваше приложение управляет сигнализацией вызовов и соответствующей передачей медиапотока.

Проверьте конфигурацию перед включением звонков. В руководстве YCloud эти варианты рассматриваются как альтернативные режимы интеграции, а не как две опции, включаемые одновременно.

Для операционной настройки используйте раздел [Calling administration](/ru/documentation/calling/admin-guide). Для интеграции обратитесь к разделу [Manage WhatsApp Calling](/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-calls).

## Подготовьте процессы для клиентов и операторов

Определите следующее:

* В какие часы доступны звонки.
* Кто из участников команды может использовать номер.
* Как клиенты связываются с нужным отделом.
* Что происходит при пропущенном или отклонённом вызове.
* Как после звонка диалог возвращается в текстовый чат.
* Требуется ли дополнительное уведомление или согласие для записи и хранения разговоров.

Проверьте доступ к микрофону, качество звука, доступность операторов и резервные сценарии обработки. Успешный ответ API означает лишь приём запроса, но не гарантирует, что клиент ответил или звук подключился корректно.

## Настройка и тестирование звонков через платформу

Для работы со звонками через платформу YCloud в текущем руководстве консоли предусмотрена следующая последовательность:

1. Убедитесь, что нужные операторы добавлены в разделе **Settings → Users and teams → Users**.
2. Откройте для бизнес-номера раздел **Calling → Authority** и включите **Calling configuration**.
3. Выберите, отображать ли значок вызова ( **Call icon visibility** ) в чате и профиле у клиента.
4. Выберите предусмотренный документацией метод распределения: случайное назначение на доступных операторов или балансировка по наименьшему числу принятых за день звонков.
5. Протестируйте работу с подходящего номера при доступном операторе, затем проверьте запись звонка в разделе **Calling logs**.

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

<Frame caption="Review Calling configuration and Call icon visibility in Calling > Authority.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/calling-authority.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=380a48c16bbd160ee7914533b97b8fdc" alt="Разрешение на звонки с включёнными вызовами, видимостью значка вызова и диплинком на звонок" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/calling-authority.png" />
</Frame>

<Frame caption="Choose the receiving agents and the default assignment rule in Calling > Assignment.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/calling-assignment.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=83e6058672b7c25c8a6e7120b82d8a34" alt="Распределение входящих звонков со случайным назначением и по наименьшему объёму звонков за день" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/calling-assignment.png" />
</Frame>

## Разделяйте этапы разрешения, дозвона и соединения

Для исходящих вызовов проверяйте каждый этап отдельно:

| Этап | Что подтверждает успех | Чего он не подтверждает |
| - | - | - |
| Разрешение получено | Клиент разрешил поддерживаемый тип взаимодействия через звонки. | Что разрешение действует бессрочно. |
| Запрос на звонок принят | Платформа приняла попытку. | Что у клиента зазвонил телефон или что он ответил. |
| Звонок соединен | Звонок переходит в состояние соединения. | Что качество звука приемлемо или что вопрос решен. |
| Звонок завершен | Сессия завершена. | Что состоялась продажа, решение вопроса или другой бизнес-результат. |

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

Если исходящие звонки недоступны, сначала проверьте доступность для страны и номера, текущее разрешение, режим подключения и конфигурацию. Не запрашивайте разрешение повторно и не повторяйте звонки для обхода ограничения. Лимиты на звонки в более старых материалах YCloud и более новых материалах Meta могут различаться; уточните действующий лимит для вашего подключения YCloud перед настройкой автоматических повторных попыток.

## Раздельный расчет стоимости

Тарификация звонков осуществляется отдельно от тарификации шаблонных сообщений. Ознакомьтесь с актуальными тарифами на звонки и коммерческими условиями YCloud перед оценкой расходов.

Окно сообщений с бесплатной точкой входа (free-entry-point) не следует рассматривать как общее освобождение от платы за звонки или рекламу. Модель обмена сообщениями описана в разделе [Цены WhatsApp](/ru/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing).

## Продолжить

* [Настройка звонков и администрирование](/ru/documentation/calling/admin-guide)
* [Звонки во Входящих](/ru/documentation/inbox/whatsapp-calling-in-inbox)
* [Журналы звонков](/ru/documentation/calling/calling-logs)
* [Руководство по Calling API](/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-calls)

## Часто задаваемые вопросы

<AccordionGroup>
  <Accordion title="Клиент разрешал звонки ранее. Почему исходящий звонок сейчас недоступен?">
    Проверьте текущее разрешение, а не старый снимок экрана. Разрешения могут быть изменены или отозваны, а настройки доступности или подключения также могут блокировать звонок. Изучите фактическую ошибку звонка и конфигурацию номера перед повторным запросом разрешения; не звоните повторно и не отправляйте запросы на разрешение многократно в попытке обойти отказ.
  </Accordion>

  <Accordion title="Значок звонка скрыт. Почему клиент все равно может позвонить из сообщения?">
    Видимость значка управляет точкой входа в чате/профиле, но не обязательно каждой точкой входа для звонка. Сообщение с поддерживаемой кнопкой вызова все еще может инициировать звонок. Если вам необходимо прекратить прием звонков, проверьте фактические настройки включения звонков и маршрутизации, а не только значок.
  </Accordion>

  <Accordion title="Звонок отображается как подключенный, но звука нет. Это проблема с разрешениями?">
    Подключенный звонок — это другой этап, отличный от получения разрешения или принятия запроса. Проверьте разрешение на доступ к микрофону, выбранное оператором устройство ввода/вывода, состояние сети и — при использовании интеграции через API — настройку медиапотока. Используйте идентификатор звонка и журналы для исследования затронутой сессии вместо повторных запросов разрешения у клиента.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.