1msg official logo
Официальный TECH PROVIDER WhatsApp

Официальный WhatsApp Business API (Cloud API) от 3045 руб за канал

Подключите номер компании к WhatsApp Cloud API через 1MSG — сообщения, вебхуки и шаблоны без своей инфраструктуры.

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

curl -X POST "$WHATSAPP_API/messages" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15550001234",
    "type": "text",
    "text": { "body": "Your order is on the way." }
  }'

Открыть быстрый старт

Один мессенджер. Три разных продукта.

WhatsApp Business API — это не ещё одно приложение WhatsApp. Это инфраструктура, через которую разработчики подключают WhatsApp к своему софту.

 WhatsAppWhatsApp Business AppWhatsApp Business API
Для когоЛичное общениеМалый бизнесСофт и бизнес-переписка любого масштаба
ИнтерфейсПриложениеПриложениеAPI
Ручные ответыДаВ основномПо желанию
АвтоматизацияНетБазоваяПолная
Интеграция с бэкендомНетЧастичноДа
CRM / хелпдескНетЧастичноДа
Нужны разработчикиНетНетОбычно да
МасштабДля себяНебольшие командыПриложения и компании

Business App — готовое приложение, в котором вы работаете. Business API — инфраструктура, на базе которой вы создаёте свои сервисы.

Если один-два сотрудника вручную отвечают небольшому числу клиентов, Business App вполне достаточно.

Неофициальные библиотеки и эмуляторы — это не Business API: номер на них могут заблокировать, сессии обрываются, и для важной переписки они не годятся.

С названиями тоже путаница: WhatsApp Business API, Cloud API и On-Premises часто считают одним и тем же. Это не так — разберёмся в следующем разделе, и больше к названиям возвращаться не будем.

Сегодня это называется Cloud API

WhatsApp Business Platform — так Meta называет весь бизнес-стек в WhatsApp: номера, аккаунты, шаблоны, сообщения и всё остальное.

Сегодня с этой платформой работают через Cloud API: Meta его хостит, вы отправляете запросы и получаете вебхуки. Свой сервер WhatsApp вам не нужен.

On-Premises API — прошлое поколение, которое разворачивали у себя. Отправку сообщений через него уже отключили. Если туториал до сих пор советует ставить On-Premises, он описывает стек, который строить не стоит.

Когда ищут WhatsApp Business API, имеют в виду Cloud API на Business Platform. Чтобы ориентироваться в документации, этого достаточно — с одной оговоркой: платформа шире, чем один эндпоинт для сообщений.

С названиями разобрались — остаётся главный вопрос: зачем уходить с бесплатного приложения.

Зачем нужен WhatsApp Business API

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

Автоматизация, интеграции с CRM и масштабирование — ниже на странице. А здесь — то, в чём большинство статей до сих пор ошибаются или о чём вовсе не пишут.

При переходе на API приложение остаётся.

Команды откладывают API, потому что думают, что от WhatsApp Business App придётся отказаться. Не придётся. Один и тот же номер может работать в приложении и в API одновременно: люди продолжают отвечать там, где привыкли, а софт параллельно отправляет уведомления и обрабатывает входящие. Вы добавляете API, а не отбираете у команды чат, в котором она уже работает.

У режима coexistence есть ограничения: какие функции приложения остаются и как синхронизируется история. Прежде чем полагаться на конкретную функцию, сверьтесь с актуальным списком в документации Meta. Как перейти — ниже, в разделе «Перенос номера из Business App».

Вы знаете, с какой рекламы пришёл клиент.

Реклама Click-to-WhatsApp в Facebook или Instagram может открывать чат и с Business App — этот формат рекламы есть не только у API. API добавляет событие: вебхук с первым сообщением сообщает, какая реклама и какой источник начали диалог. Этого достаточно, чтобы атрибутировать диалог и ответить на него или направить его программно, а не сопоставлять рекламу с чатами вручную.

Номер живёт в софте.

Business App живёт на телефоне. API — нет. Номер — это объект в ваших системах: никакому устройству не нужно быть онлайн, номером одновременно пользуются несколько приложений и операторов, и канал не зависит от того, у кого сегодня телефон.

Что можно создать

Если задача уже понятна, дальше на странице — реализация. Вот что команды на самом деле запускают на WhatsApp Business API.

Как это работает

Два направления — одна модель. Если вы реализовали только исходящие, у вас половина канала.

Клиент ↔ WhatsApp ↔ WhatsApp Cloud API ↔ Ваш бэкенд — со стороны бэкенда: CRM, ИИ, Поддержка.

  1. Ваше приложение отправляет запросы к API. Исходящее сообщение — это HTTP-запрос: сообщение, шаблон, загрузка медиа. WhatsApp не опрашивает ваш сервер.

  2. WhatsApp доставляет сообщение. Инфраструктура Meta доводит его до телефона пользователя. Этот участок пути вы не контролируете.

  3. Вебхуки возвращают события. Входящие сообщения и статусы — sent, delivered, read или failed — приходят колбэками. Ваше приложение реагирует, а не спрашивает «есть что-то новое?»

Возможности API

WhatsApp Business API — это не эндпоинт «отправить сообщение» с довесками. Вот с чем вы на самом деле интегрируетесь.

Сообщения

Отправка и получение сообщений WhatsApp.

Текст — это начало, а не продукт. Тот же API отправляет и получает изображения, видео, аудио и документы, а также геолокацию, контакты, реакции и стикеры. Медиа загружаются и скачиваются через API, а не прикрепляются с телефона.

Интерактивные сценарии

Превратите диалог в интерфейс.

Кнопки ответа, списки, призывы к действию и структурированные ответы собирают выбор без разбора свободного текста. WhatsApp Flows — встроенные мини-формы прямо в переписке: запись, заявки, опросы, регистрация, онбординг — пользователю не нужно выходить из WhatsApp, чтобы отправить форму.

Шаблоны и исходящие сообщения

Начинайте диалоги, которые канал действительно доставит.

Компания, которая пишет первой, использует шаблоны, проверенные Meta: Utility, Authentication, Marketing. Шаблоны нужны потому, что в WhatsApp писать можно только с разрешения. Проверка проходит до первого исходящего сообщения, а не после жалобы. Это ограничение намеренное — поэтому сессионные и шаблонные сообщения в коде не взаимозаменяемы.

События и вебхуки

Реагируйте, пока диалог идёт.

Вебхуки доставляют входящие сообщения; статусы sent, delivered, read и failed; ошибки; ответы на интерактивные сообщения; заказы; события звонков; события аккаунта; и контекст клика, если диалог начался с рекламы. Приложение, которое игнорирует вебхуки, может отправлять. Работать — нет.

Коммерция

Каталог прямо в переписке.

Каталоги товаров, сообщения с одним и несколькими товарами, карусели, заказы и настройки коммерции позволяют выбрать и купить товар, не переходя на сторонний сайт. Каталог — это бизнес-объект, а не PDF во вложении.

Звонки

Звонки WhatsApp на том же бэкенде, что и чат.

Принимайте и совершайте звонки WhatsApp из своего приложения. Подключите АТС или контакт-центр — в том числе по SIP, — если звонки должны попадать в ту же карточку клиента, что и переписка.

Управление аккаунтом

Управляйте аккаунтом WhatsApp из софта, а не в настройках телефона.

Номера телефонов, бизнес-профили, WhatsApp Business Accounts, шаблоны, QR-коды и настройки аккаунта — это объекты API. Embedded Signup — встроенное окно Meta, чтобы подключить WhatsApp клиента или филиала без переписки в тикетах. Это важно, если вы подключаете WhatsApp другим компаниям, а не только себе.

Масштаб и эксплуатация

Узнайте ограничения канала до того, как обещать дату запуска.

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

Писать всем подряд нельзя

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

  • Инициатива клиента. Человек написал первым. Внутри окна обслуживания можно отвечать в свободной форме. Когда окно закрывается, остаются только шаблоны.

  • Инициатива компании. Первым можно писать только одобренным шаблоном и только по поводу, которого человек вправе ожидать.

  • Согласие (opt-in). Человек согласился получать от вас сообщения и ждёт именно такие. Opt-in — не лазейка в обход шаблонов.

Диалог не обязательно начинается с сообщения в чате. Реклама Click-to-WhatsApp, QR-код или кнопка на сайте — это тоже переписка, которую начал пользователь. У некоторых из этих точек входа своё окно обслуживания. Принцип не меняется, а сроки меняются: ориентируйтесь на документацию Meta, а не на цифры с этой страницы.

Сколько это стоит

Единой «цены WhatsApp Business API» нет. Есть структура затрат. Тарифы меняются, структура — нет.

Ваши затраты = сообщения WhatsApp + платформа или собственная инфраструктура

  • Meta. Вы платите за сообщения WhatsApp. Сумма зависит от типа сообщения, рынка и текущей модели цен Meta — она уже менялась и изменится снова. Тарифы на этой странице не приводим.

  • Платформа. Провайдеры берут подписку, наценку на сообщения, плату за номер, иногда плату за подключение — часто всё вместе. Сравнивайте итоговый счёт, а не одну строку в прайсе.

  • Напрямую к Cloud API. Счёта от провайдера нет. Но расходы остаются: хостинг, база данных, хранение медиа, очереди, мониторинг и время разработчиков, чтобы всё это работало, когда API меняется.

Цены 1MSG — в шапке и подвале сайта. Здесь мы их не повторяем.

Сделать самим или взять платформу

API даёт возможности, но не продукт.

Подключаясь напрямую к WhatsApp Cloud API, вы получаете примитивы, чтобы построить свой продукт на WhatsApp. Вы сами решаете, как хранить, показывать и маршрутизировать сообщения и как связать их с остальным стеком. Twilio, 1MSG, respond.io и другие существуют потому, что эта вторая половина — серьёзная работа, а не потому, что WhatsApp у разных вендоров разный.

WhatsApp Business API даёт: сообщения, вебхуки, шаблоны, медиа, Flows, звонки, бизнес-объекты.

Платформа добавляет: инбокс, историю диалогов, инструменты операторов, интеграции с CRM, автоматизацию, аналитику, логи, повторные попытки, управление пользователями, ИИ-интеграции, биллинг и инструменты разработчика.

Разница проявляется во времени до продакшена, в стоимости поддержки и в том, кто не спит, когда вебхуки падают в 2 часа ночи. Cloud API не хуже — просто как продукт он неполный.

Способ получить доступ и способ хранить сообщения — разные вопросы. Три пути: своё приложение Meta, BSP или Tech Provider. Меняется то, кому принадлежат WhatsApp Business Account и номер, нужен ли BSP и можно ли перенести номер. BSP не обязателен. Через Tech Provider WABA и номер могут остаться вашими, а подключение идёт через Embedded Signup. Подробности — в FAQ; эта страница — не договор.

Разработчикам нужно больше, чем Cloud API

WhatsApp Cloud API предоставляет основные примитивы для отправки и получения сообщений. 1MSG дополняет это инфраструктурой вокруг WhatsApp Business API, чтобы вы могли сосредоточиться на вашем продукте и запустить его за несколько часов, а не недель.

ВозможностьWABAС 1MSG
История сообщенийНужно разрабатывать самостоятельноAPI для истории сообщений
Хранение медиафайловХранится всего 30 днейБез ограничения времени
Журнал отправкиНужно разрабатывать самостоятельноВключено
ШаблоныРучная настройкаАвтошаблон включён
ТехподдержкаСамообслуживаниеВключено
ЛогиНужно разрабатывать самостоятельноСкоро
Deploy-платформаХостите самостоятельноСкоро

Всё, что нужно для разработки на WhatsApp

В бюрократической версии этой истории до первого Hello World — месяц тикетов в Meta. В рабочей — короткий чек-лист и первое сообщение.

Что нужно

  • Бизнес-портфолио Meta

  • WhatsApp Business Account

  • Номер телефона компании

  • Подтверждение номера

  • Верификация компании — только если её требует Meta

  • Токен доступа

  • Эндпоинт для вебхуков

Тестовый номер и песочница позволяют подключиться, настроить вебхуки и отправить первое сообщение без собственного номера. Этот чек-лист — для продакшена; чтобы попробовать, он не нужен.

Шаги

  1. Создайте или подключите WhatsApp Business Account

  2. Добавьте номер телефона компании

  3. Подключите API

  4. Настройте вебхуки

  5. Отправьте первое сообщение

  6. Создайте свою интеграцию

Начать · Открыть быстрый старт · Документация

Перенос номера из Business App

Номер можно перенести из WhatsApp Business App в API — и он останется вашим. Обычно боятся именно этого, и здесь ответ однозначный.

История переписки в приложении не превращается автоматически в полную историю, доступную через API. Считайте историю чатов деталью миграции и уточните её в документации Meta для своего случая: coexistence, полный переезд и новый номер — разные сценарии. Не планируйте переход в расчёте на то, что все старые переписки окажутся в софте.

Частые вопросы

Нет. WhatsApp Business App можно скачать бесплатно, а API — другой продукт. Meta берёт плату за сообщения WhatsApp по текущим тарифам. Если вы используете платформу поверх API, вы платите и ей. Назвать одну цифру «цена API» нельзя — смотрите раздел «Сколько это стоит».

Интегрируйте WhatsApp за часы
без возни с инфраструктурой