Подключение WhatsApp Business API

Обновлено 9 марта 2026 г.

Подключение WhatsApp Business API

WhatsApp Business API — основной канал коммуникации с кандидатами в HRStream. Интеграция позволяет отправлять и получать сообщения напрямую из интерфейса платформы, использовать шаблоны сообщений и запускать автоматический AI-скрининг.

Что вам понадобится для подключения:
  • Верифицированный аккаунт Meta Business (ранее Facebook Business)
  • Телефонный номер, который будет использоваться для WhatsApp Business
  • Активный аккаунт HRStream с правами администратора

Предварительные требования

Перед началом настройки убедитесь, что у вас есть доступ к Meta Business Manager (business.facebook.com). Ваш бизнес-аккаунт должен быть верифицирован — это обязательное требование Meta для доступа к WhatsApp Business API.

Верификация бизнеса в Meta занимает от 1 до 7 рабочих дней. Вам потребуется предоставить официальные документы компании: свидетельство о регистрации, БИН/ИИН, а также подтвердить домен и контактные данные.

Важно: телефонный номер, который вы планируете использовать для WhatsApp Business API, не должен быть зарегистрирован в обычном приложении WhatsApp или WhatsApp Business. Если номер уже используется, его необходимо сначала удалить из приложения. Рекомендуем выделить отдельный корпоративный номер для интеграции.

Шаг 1. Перейдите в настройки интеграций

Войдите в HRStream под учётной записью администратора. В боковом меню откройте Настройки → Интеграции → WhatsApp Business API. Вы увидите страницу подключения с полями для ввода учётных данных API.

Шаг 2. Верификация Meta Business

Если ваш бизнес-аккаунт Meta ещё не верифицирован, выполните следующие шаги:

  1. Откройте Meta Business Manager → Настройки → Центр безопасности.
  2. Нажмите «Начать верификацию» и выберите страну регистрации.
  3. Загрузите документы компании: свидетельство о государственной регистрации, налоговая справка или выписка из реестра.
  4. Укажите юридическое название компании, адрес и контактный телефон.
  5. Подтвердите домен компании через DNS-запись или загрузку HTML-файла.
  6. Дождитесь подтверждения от Meta (обычно 2–5 рабочих дней).

Шаг 3. Подключение номера WhatsApp

После верификации бизнеса настройте WhatsApp в Meta Business Manager:

  1. В Meta Business Manager перейдите в Все инструменты → WhatsApp Manager.
  2. Нажмите «Начало работы» и следуйте мастеру настройки.
  3. Добавьте телефонный номер — Meta отправит код подтверждения по SMS или звонку.
  4. Введите код подтверждения для верификации номера.
  5. Настройте профиль бизнеса: название компании, описание, логотип, адрес.

Шаг 4. Получение API-данных

Для подключения HRStream вам понадобятся три параметра из Meta Business Manager:

Параметр Где найти Описание
Phone Number ID WhatsApp Manager → Настройка API Уникальный идентификатор вашего номера WhatsApp
WABA ID WhatsApp Manager → Настройка API Идентификатор аккаунта WhatsApp Business
Access Token Meta for Developers → Приложение → Системные пользователи Постоянный токен доступа к API (рекомендуется использовать токен системного пользователя)

Для генерации постоянного токена доступа рекомендуем создать системного пользователя в Meta Business Manager (Настройки → Пользователи → Системные пользователи), назначить ему роль администратора приложения и выдать разрешение whatsapp_business_messaging.

Шаг 5. Ввод учётных данных в HRStream

  1. Вернитесь на страницу Настройки → Интеграции → WhatsApp Business API в HRStream.
  2. Введите Phone Number ID в соответствующее поле.
  3. Введите WABA ID (WhatsApp Business Account ID).
  4. Вставьте Access Token — он будет сохранён в зашифрованном виде.
  5. Нажмите «Сохранить и проверить подключение».

Шаг 6. Тестирование подключения

После сохранения учётных данных HRStream автоматически выполнит проверку подключения. Если всё настроено верно, вы увидите статус «Подключено» с зелёным индикатором.

Для полной проверки отправьте тестовое сообщение: перейдите в раздел Мессенджер, начните новый диалог с помощью шаблона и отправьте сообщение на свой личный номер. Убедитесь, что сообщение доставлено и вы получаете ответные сообщения в интерфейсе HRStream.

Подключение нескольких номеров

HRStream поддерживает подключение нескольких номеров WhatsApp для разных подразделений или направлений найма. Это удобно, если у вас есть отдельные номера для массового подбора, IT-рекрутинга и корпоративного найма.

Для добавления дополнительного номера:

  1. На странице интеграций нажмите «Добавить номер».
  2. Введите учётные данные для нового номера (Phone Number ID, WABA ID, Access Token).
  3. Укажите название номера (например, «IT-подбор», «Массовый подбор»).
  4. Назначьте номер определённым пользователям или сделайте его доступным для всей организации.
Совет: каждый номер WhatsApp может иметь свой профиль бизнеса с отдельным названием и описанием. Настройте их соответствующим образом, чтобы кандидаты сразу понимали, с каким подразделением компании они общаются.

Устранение проблем с подключением

Проблема Причина Решение
Ошибка «Invalid Access Token» Истёк или некорректный токен Сгенерируйте новый постоянный токен через системного пользователя
Сообщения не доставляются Номер не верифицирован Проверьте статус верификации номера в WhatsApp Manager
Не приходят входящие сообщения Не настроен Webhook Убедитесь, что Webhook URL указан в настройках приложения Meta
Ошибка «Business not verified» Бизнес-аккаунт не прошёл верификацию Завершите верификацию бизнеса в Meta Business Manager