Подключение 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 рабочих дней. Вам потребуется предоставить официальные документы компании: свидетельство о регистрации, БИН/ИИН, а также подтвердить домен и контактные данные.
Шаг 1. Перейдите в настройки интеграций
Войдите в HRStream под учётной записью администратора. В боковом меню откройте Настройки → Интеграции → WhatsApp Business API. Вы увидите страницу подключения с полями для ввода учётных данных API.
Шаг 2. Верификация Meta Business
Если ваш бизнес-аккаунт Meta ещё не верифицирован, выполните следующие шаги:
- Откройте Meta Business Manager → Настройки → Центр безопасности.
- Нажмите «Начать верификацию» и выберите страну регистрации.
- Загрузите документы компании: свидетельство о государственной регистрации, налоговая справка или выписка из реестра.
- Укажите юридическое название компании, адрес и контактный телефон.
- Подтвердите домен компании через DNS-запись или загрузку HTML-файла.
- Дождитесь подтверждения от Meta (обычно 2–5 рабочих дней).
Шаг 3. Подключение номера WhatsApp
После верификации бизнеса настройте WhatsApp в Meta Business Manager:
- В Meta Business Manager перейдите в Все инструменты → WhatsApp Manager.
- Нажмите «Начало работы» и следуйте мастеру настройки.
- Добавьте телефонный номер — Meta отправит код подтверждения по SMS или звонку.
- Введите код подтверждения для верификации номера.
- Настройте профиль бизнеса: название компании, описание, логотип, адрес.
Шаг 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
- Вернитесь на страницу Настройки → Интеграции → WhatsApp Business API в HRStream.
- Введите Phone Number ID в соответствующее поле.
- Введите WABA ID (WhatsApp Business Account ID).
- Вставьте Access Token — он будет сохранён в зашифрованном виде.
- Нажмите «Сохранить и проверить подключение».
Шаг 6. Тестирование подключения
После сохранения учётных данных HRStream автоматически выполнит проверку подключения. Если всё настроено верно, вы увидите статус «Подключено» с зелёным индикатором.
Для полной проверки отправьте тестовое сообщение: перейдите в раздел Мессенджер, начните новый диалог с помощью шаблона и отправьте сообщение на свой личный номер. Убедитесь, что сообщение доставлено и вы получаете ответные сообщения в интерфейсе HRStream.
Подключение нескольких номеров
HRStream поддерживает подключение нескольких номеров WhatsApp для разных подразделений или направлений найма. Это удобно, если у вас есть отдельные номера для массового подбора, IT-рекрутинга и корпоративного найма.
Для добавления дополнительного номера:
- На странице интеграций нажмите «Добавить номер».
- Введите учётные данные для нового номера (Phone Number ID, WABA ID, Access Token).
- Укажите название номера (например, «IT-подбор», «Массовый подбор»).
- Назначьте номер определённым пользователям или сделайте его доступным для всей организации.
Устранение проблем с подключением
| Проблема | Причина | Решение |
|---|---|---|
| Ошибка «Invalid Access Token» | Истёк или некорректный токен | Сгенерируйте новый постоянный токен через системного пользователя |
| Сообщения не доставляются | Номер не верифицирован | Проверьте статус верификации номера в WhatsApp Manager |
| Не приходят входящие сообщения | Не настроен Webhook | Убедитесь, что Webhook URL указан в настройках приложения Meta |
| Ошибка «Business not verified» | Бизнес-аккаунт не прошёл верификацию | Завершите верификацию бизнеса в Meta Business Manager |