Настройка интеграции с WhatsApp

Как работает интеграция

Интеграция с WhatsApp позволяет вашим сотрудникам получать и отправлять сообщения WhatsApp непосредственно в унифицированном интерфейсе 3CX. Сообщения приходят в то же окно веб-клиента, в которое приходят сообщения Live Chat, SMS и Facebook. Это позволяет быстро и удобно вести коммуникацию с клиентами по нескольким каналам связи.

Требования

  • Для использования интеграции у вас должен быть создан аккаунт WhatsApp Business Platform.На данном этапе вы можете пройти процедуру верификации компании, однако сервис не будет работать в полном объеме до ее завершения.
  • Необходимо добавить принадлежащий вам номер телефона. Этот номер не должен принадлежать другому аккаунту, а также не быть зарегистрирован виртуально или на другом физическом устройстве. Если вы хотите использовать существующий номер WhatsApp, сперва удалите этот аккаунт. Подробнее см. здесь.
  • Интеграция с WhatsApp предназначена только для ответов на входящие сообщения. Вы не можете отправить сообщение, если пользователь не написал вам до этого. Система позволяет ответить на сообщение в течение 24 часов.
  • Всегда используйте самую свежую версию WhatsApp API.

Шаг 1: Создайте приложение WhatsApp

  • Перейдите в https://developers.facebook.com и в правом верхнем углу нажмите “Log In”.
  • Перейдите в “My Apps”, нажмите “Create App”, присвойте имя и нажмите "Next".
  • Выберите"Connect with customers through WhatsApp" и нажмите “Next”.
  • Выберите нужное Business Portfolio (Бизнес-портфолио) и нажмите “Next”.

  • Для новой компании укажите как можно больше информации, в частности нормативные URL-адреса, перейдя в App settings > Basic.

  • Если указаны какие-либо дополнительные требования, выполните их перед тем, как продолжить. Нажмите "Next".
  • Подтвердите информацию в диалоговом окне Overview и нажмите "Create app".
  • Подтвердите пароль от учетной записи Meta, если потребуется.
  • Вы можете в любой момент перевести приложение в статус Published; при наличии дополнительных требований со стороны Meta вы получите соответствующее уведомление.
  • Статус Published необходим для взаимодействия конечных пользователей с вашей интеграцией, а также позволяет включать и отключать сервис. Опубликовать приложение можно на данном этапе, даже если его настройка еще полностью не завершена.

Шаг 2: Установите роль Admin

Если вы не используете существующий бизнес-аккаунт Meta с уже заданными пользователями и ролями, воспользуйтесь боковым меню раздела "My Apps" и в подразделе "App roles" добавьте как минимум одного администратора.

Шаг 3: Настройка основного приложения

Перейдите в раздел Use cases и выберите Customize.

Разрешения и функции

Убедитесь в наличии разрешений "whatsapp_business_messaging" и "whatsapp_business_management". Если они отсутствуют, добавьте их с помощью кнопки "+ Add".  

Подключение WhatsApp и 3CX

  • Выберите Step 1. Try it out на портале WhatsApp.
  • Запишите свой WhatsApp Business Account ID.
  • Сгенерировать токен доступа (access token) для тестового номера можно на данном этапе или после верификации реального номера телефона.
  • Выберите Step 2. Production setup на портале WhatsApp.

  • В консоли администратора 3CX перейдите в Voice & Chat -> + Add Messaging -> Add WhatsApp.
  • Скопируйте Webhook URL вашей АТС; оставьте эту страницу открытой.

  • Вставьте Webhook URL на портале WhatsApp в разделе Step 2. Production setup.
  • Введите произвольную строку в поле Verify token. Она больше не понадобится, поэтому сохранять ее для дальнейшего использования не нужно.

  • Убедитесь, что выбран вебхук "messages" и указана последняя версия (в данном примере — v25.0).
  • Нажмите кнопку Verify & Save.
  • Перейдите к разделу Register your WhatsApp phone number.

  • Добавьте свой номер телефона и верифицируйте его.
  • Включите опцию Subscribe webhooks.
  • Запишите Phone Number ID:
  • Вставьте Phone Number ID и сам номер телефона на странице конфигурации 3CX.
  • Вы также можете сгенерировать Access Token (токен доступа) и вставить его в 3CX.

После завершения верификации компании (Business Verification)

Теперь можно перейти к тестированию конфигурации, отправив сообщение на ваш бизнес-номер WhatsApp.

Дополнительная информация

Версия документа

Последнее обновление документа 7 августа 2026

https://www.3cx.ru/docs/manual/whatsapp/