Документация ›Каналы: WhatsApp, Instagram, Telegram, сайт

Настройка WhatsApp Business API

Подключите WhatsApp Business API для получения сообщений от клиентов в WhatsApp. Можно использовать любой номер из любой страны.

Быстрее всего — подключение в один клик

Откройте Панель → Интеграции → WhatsApp и нажмите кнопку «Подключить WhatsApp». Войдите через Meta, выберите номер WhatsApp Business — токен, подписку на webhook и маршрутизацию настроим автоматически. Ручные шаги ниже нужны только если вы приносите своё Meta-приложение или настраиваете вручную.

Требования:

  • Meta Business Account (бесплатно)
  • Номер телефона для WhatsApp (любая страна)
  • Доступ к получению SMS или звонка для верификации

Сколько берёт Meta и зачем ей карта

  • С 1 октября 2026 Meta берёт плату за ответы в течение 24 часов после сообщения клиента — то есть за ответы AI. Первая 1 000 в месяц на каждый номер WhatsApp бесплатна, дальше каждый ответ оплачивается по ставке страны клиента.
  • Напоминания и подтверждения по шаблону платные с первого сообщения, рассылки дороже. Сообщения клиентов вам всегда бесплатны.
  • Meta выставляет счёт напрямую вашему аккаунту WhatsApp Business — SIPmind не перепродаёт сообщения и не делает наценку. Добавьте карту в Meta Business Suite → «Оплата и счета» → ваш аккаунт WhatsApp Business. Без карты Meta перестаёт доставлять платные сообщения, как только бесплатная тысяча закончится.
  • Номер не должен работать в приложении WhatsApp. Если работает, удалите аккаунт WhatsApp в приложении перед подключением — номер останется вашим.
  • Актуальные ставки по странам: цены WhatsApp Business Platform.

Пошаговая настройка (8 шагов):

  1. Создайте Meta Business Account — перейдите на business.facebook.com и создайте аккаунт
  2. Добавьте WhatsApp — Настройки бизнеса → Аккаунты WhatsApp → Добавить
  3. Добавьте номер телефона — введите номер и подтвердите через SMS или звонок
  4. Создайте System User — Настройки бизнеса → Пользователи → Системные пользователи → Добавить. Дайте разрешение whatsapp_business_messaging
  5. Сгенерируйте Access Token — нажмите "Создать новый токен" для System User (токен бессрочный)
  6. Получите Phone Number ID — перейдите в WhatsApp Manager → Номера телефонов → скопируйте Phone Number ID
  7. Добавьте в SIPmind Settings — Панель → Настройки → вставьте Access Token + Phone Number ID. Если используете СОБСТВЕННОЕ Meta-приложение (а не общее SIPmind), также заполните App Secret + Verify Token — см. блок "Своё Meta-приложение" ниже.
  8. Добавьте Phone Mapping — Панель → Интеграции → WhatsApp → «Добавить номер WhatsApp» → вставьте тот же Phone Number ID. Этот шаг обязателен — без него входящие webhook'и не знают, к какому аккаунту их отнести.

Используете собственное Meta WhatsApp Business приложение?

Большинство клиентов использует общее SIPmind Meta-приложение — настройка проще, дополнительные токены не нужны.

Если вы создали своё Meta-приложение (рекомендуется для white-label, выделенного биллинга или жёсткой изоляции данных), также укажите:

  • App Secret — Meta Developers → ваше приложение → Settings → Basic → App Secret. Используется для проверки, что входящий webhook реально пришёл от Meta (HMAC-подпись). Без него: webhook вернёт 403 → бот выглядит мёртвым.
  • Verify Token — любая случайная строка ≥10 символов. Вставьте ОДНУ И ТУ ЖЕ строку в Meta Developers → Webhooks → Verify Token при регистрации https://sipmind.net/api/v1/whatsapp/webhook.

Оба поля в Настройки → Каналы, помечены как "(опционально)". Оставьте пустыми, если используете общее SIPmind-приложение.

Лимиты Meta, коротко

  • Ответы клиентам, которые написали вам: без ограничений, бесплатно до 1 000 в месяц на номер.
  • Написать первым (шаблоны): 250 разных клиентов в сутки для нового бизнес-портфолио; 2 000 после подтверждения компании; дальше 10 000, 100 000 и без ограничений, пока держится качество.
  • Звонки в WhatsApp: Meta включает их с лимита 2 000.

Как растут лимиты и как подтвердить компанию.

Настройка Webhook:

После настройки укажите webhook в Meta Dashboard:

https://sipmind.net/api/v1/whatsapp/webhook

Подпишитесь на: messages, calls — и message_template_status_update, если вы делаете рассылки в WhatsApp