О платформе WhatsApp Business | Документация для разработчиков
О платформе WhatsApp Business
Обновлено: 5 декабря 2025 г
Платформа WhatsApp Business позволяет компаниям общаться с клиентами в больших масштабах.
, использующих наши API. Если вы ищете информацию о других способах использования WhatsApp для вашего бизнеса, посетите сайт WhatsApp Business .
Основные API и возможности
WhatsApp Cloud API
WhatsApp Cloud API позволяет программно отправлять сообщения и совершать звонки в WhatsApp. Вы можете использовать Cloud API для отправки пользователям самых разных сообщений, от простых текстовых сообщений до мультимедийных и интерактивных сообщений.
WhatsApp Cloud API включает в себя:
Обмен сообщениями в WhatsApp — это мощный и конфиденциальный способ взаимодействия с клиентами. Используйте Cloud API для:
API управления бизнесом
API управления бизнес-аккаунтом WhatsApp позволяет программно управлять бизнес-аккаунтом WhatsApp и связанными с ним ресурсами.
Управляйте активами учетной записи с помощью Business Management API, например:
API управления бизнесом также предоставляет доступ к аналитике учетных записей, например:
Аналитика шаблонов: показатели отправленных/прочитанных/доставленных шаблонов, а также клики по кнопкам в сообщениях, созданных на основе шаблонов.
Узнайте больше о шаблонах сообщений.Узнайте больше об управлении корпоративными телефонными номерами.Узнайте больше об аналитике учетных записей.
API для маркетинговых сообщений в WhatsApp
MM API для WhatsApp — это API для отправки оптимизированных маркетинговых сообщений в WhatsApp.
Отправляя маркетинговые сообщения через MM API для WhatsApp, вы получаете доступ к новым функциям, недоступным в Cloud API, и автоматическую оптимизацию, благодаря чему сообщения с высокой вовлеченностью достигают большего числа клиентов.
API MM для WhatsApp включает в себя:
Ключевые ресурсы
Бизнес-портфели
Бизнес-портфолио позволяет организациям объединить все свои бизнес-активы Meta для управления ими в одном месте. На платформе WhatsApp Business бизнес-портфолио в основном служит контейнером для бизнес-аккаунтов WhatsApp (WABA). Для использования платформы необходимо иметь бизнес-портфолио.
Портфели предприятий могут быть проверены, а статус проверки влияет на улучшенную функциональность, например, на повышение пропускной способности и статус официального бизнес-аккаунта
Бизнес-аккаунты WhatsApp (WABA)
Бизнес-аккаунт WhatsApp представляет вашу компанию, хранит метаданные и связывает вас с номерами телефонов, шаблонами и аналитикой.
рабочие телефонные номера
Для отправки и получения сообщений в WhatsApp используются рабочие телефонные номера, реальные или виртуальные. Они могут иметь отображаемые имена и статус официального бизнес-аккаунта.
Шаблоны сообщений
Шаблоны — это настраиваемые сообщения, которые вы можете составить заранее перед отправкой. Как правило, перед отправкой шаблонные сообщения требуют подтверждения.
Шаблоны полезны для массовой рассылки сообщений. Кроме того, это единственный тип сообщений, который можно отправлять пользователям WhatsApp вне окна обслуживания клиентов .
Шаблоны имеют оценки качества и подлежат различным ограничениям по объему сообщений.
Тестовые ресурсы
При начале работы с Cloud API для вас автоматически создаются тестовый WABA-адрес и тестовый номер телефона компании. Тестовые WABA-адреса и номера телефонов полезны для тестирования, поскольку они имеют более мягкие ограничения на количество сообщений и не требуют указания способа оплаты для отправки шаблонных сообщений.
Вы можете удалить свой бизнес-портфолио и тестовые ресурсы, если:
Чтобы удалить бизнес-портфолио и его тестовые ресурсы:
Мы рекомендуем использовать нашу площадку для тестирования API Playground. Вы можете найти эту площадку в разделе «Справочник по API» на левой боковой панели этой страницы. В каждом разделе справочника есть кнопка «Попробовать», которая открывает площадку.
полезна наша коллекция Postman .
Инструменты и интеграции
Менеджер WhatsApp
WhatsApp Manager — это веб-приложение для управления учетными записями WABA, номерами телефонов, шаблонами и анализа статистики.
Сторонние SDK
Некоторые SDK, такие как PyWa ( обертка для Python), доступны, но не поддерживаются и не одобрены компанией Meta.
Безопасность и производительность
Пропускная способность
По умолчанию корпоративные телефонные номера позволяют отправлять до 80 сообщений в секунду, при этом доступны варианты с увеличенной пропускной способностью.
Шифрование
Благодаря облачному API каждое сообщение WhatsApp по-прежнему защищено шифрованием протокола Signal, которое обеспечивает безопасность сообщений до того, как они покинут устройство. Это означает, что сообщения с WABA безопасно доставляются в пункт назначения, выбранный каждой компанией.
Облачный API использует стандартные методы шифрования для защиты данных при передаче и хранении. API использует Graph API для отправки сообщений и веб-хуки для получения событий, и оба работают по стандартному протоколу HTTPS, защищенному протоколом TLS. Дополнительные сведения см. в нашем документе «Обзор шифрования».
Дополнительные сведения см. в официальном документе «Обзор шифрования WhatsApp» .
Масштабирование
Облачный API автоматически масштабирует использование в пределах установленных вами лимитов скорости.
Ограничения скорости
Запросы, отправленные вашим приложением в ваш аккаунт WhatsApp Business (WABA), учитываются в общем количестве запросов вашего приложения. Общее количество запросов приложения — это число запросов, которые оно может отправить за один час.
Для следующих конечных точек ваше приложение по умолчанию может выполнять 200 запросов в час на одно приложение на один WABA. Для активных WABA, имеющих хотя бы один зарегистрированный номер телефона, ваше приложение может выполнять 5000 запросов в час на одно приложение на один активный WABA.
| Тип запроса | Конечная точка |
|---|---|
ПОЛУЧАТЬ |
/<WHATSAPP_BUSINESS_ACCOUNT_ID> |
GET , POST и DELETE |
/<WHATSAPP_BUSINESS_ACCOUNT_ID> /assigned_users |
ПОЛУЧАТЬ |
/<WHATSAPP_BUSINESS_ACCOUNT_ID> /номера_телефона |
GET , POST и DELETE |
/<WHATSAPP_BUSINESS_ACCOUNT_ID> /message_templates |
GET , POST и DELETE |
/<WHATSAPP_BUSINESS_ACCOUNT_ID> /subscribed_apps |
ПОЛУЧАТЬ |
/<WHATSAPP_BUSINESS_ACCOUNT_TO_NUMBER_CURRENT_STATUS_ID> |
Для следующих запросов к API кредитных линий
| Тип запроса | Конечная точка |
|---|---|
ПОЛУЧАТЬ |
/<BUSINESS_ID> /расширенные кредиты |
ПОЧТА |
/<EXTENDED_CREDIT_ID> /whatsapp_credit_sharing_and_attach |
Получить и удалить |
/<ALLOCATION_CONFIG_ID> |
ПОЛУЧАТЬ |
/<EXTENDED_CREDIT_ID> /owning_credit_allocation_configs |
Для получения более подробной информации о том, как узнать текущий объем потребления трафика, см. раздел «Заголовки» .
Кроме того, платформа применяет несколько ограничений на скорость передачи сообщений:
Ограничения на количество пар
С корпоративных телефонных номеров можно отправлять 1 сообщение каждые 6 секунд одному и тому же пользователю WhatsApp (0,17 сообщений в секунду), что составляет примерно 10 сообщений в минуту или 600 в час. Превышение этого лимита приводит к ошибке с кодом 131056, пока вы не вернетесь в допустимые рамки.
Вы можете отправить до 45 сообщений за 6-секундный отрезок, но это «заимствует» из вашей будущей квоты. После такого отрезка вам необходимо подождать время, эквивалентное тому, которое потребовалось бы для отправки этих сообщений с обычной скоростью (например, для отрезка из 20 сообщений потребуется около 2 минут ожидания, прежде чем отправить пользователю еще).
Для управления регулированием после обработки большого количества запросов, если запрос на отправку не удается, повторите попытку через 4^X секунд (начиная с X=0 и увеличивая X на 1 после каждой неудачи) до тех пор, пока запрос не будет успешно обработан.
Условия и положения
Согласие пользователя
необходимо получить согласие . В согласии пользователя должно быть указано название вашей компании и ее цели.
Условия и положения
Использование любой платформы должно соответствовать условиям и политике WhatsApp. Использование несанкционированных сторонних инструментов запрещено.
Следующие шаги
Узнать больше
Комментарии отсутствуют
Комментарии отсутствуют