В разделе Разработчики > Учетные данные создайте токен для интеграции messages:write. Скопируйте его при создании, сохраните в бэкенде и настройте подключение WhatsApp в панели перед отправкой.
Разработчик API
API для подключения WhatsApp к вашим системам и приложениям.
Интегрируйте CRM, ERP, приложения и внутренние системы с WhatsApp через REST API WPP Marketing. Отправляйте текст и медиа, запрашивайте сообщения и отслеживайте доставку через webhooks. Также используйте MCP для интеграции ваших потоков с Official API. Узнать о MCP.
Когда использовать
Используйте Messaging API, когда вашей системе нужно отправлять сообщения в WhatsApp.
Используйте ваш CRM, чтобы инициировать контакт, ERP — чтобы отправить обновление, или приложение — чтобы уведомить клиента. Логика того, когда отправлять, остается в вашей системе; API выполняет отправку через подключение, настроенное в аккаунте. Для готовых коммерческих автоматизаций используйте Events API.
Используйте POST /send-text для текста или POST /send-media для медиа. При официальном подключении текст и изображение используют настроенные шаблоны; для аудио, видео и документов требуется сообщение от клиента, полученное в последние 24 часа.
HTTP 200 указывает на принятие, а не доставку. С правом messages:read выполните GET /messages и проверьте доступные статусы для канала.
Зарегистрируйте HTTPS-URL и включите события в панели. Используйте webhooks:read для запроса попыток через GET /webhooks; этот эндпоинт перечисляет доставки, он не регистрирует подписки.
От токена до первой включённой отправки.
На вашем сервере замените SEU_TOKEN на учетные данные, а номер — на авторизованного получателя для теста. Используйте уникальный ключ для каждой отправки и повторно используйте тот же ключ только при повторении того же запроса.
Проверьте HTTP‑статус и тело ответа. Для 401 — проверьте токен и его действительность; для 403 — проверьте права (scopes) и состояние аккаунта. Для 409 — проверьте, не использовался ли ключ ранее с другим контентом. Для 429 — соблюдайте Retry-After перед повторной попыткой.
Затем проверьте GET /messages с правом messages:read или отслеживайте настроенные webhook'и. Подтверждение доставки зависит от ответа канала.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'Текст, медиа, история и отслеживание отправок.
Используйте REST‑эндпоинты для интеграции WhatsApp в ваше приложение. API WPP Marketing использует подключение, настроенное в аккаунте; чтобы работать с официальным WhatsApp API, настройте это подключение в панели. Смотрите OpenAPI для форматов, областей (scopes), лимитов и ответов каждой операции.
POST
/send-text
Отправляет текстовое сообщение на номер WhatsApp.
Texto
POST
/send-media
Отправляйте изображение, аудио, видео или документ по публичному HTTPS URL в соответствии с форматом и условиями соединения. Аудио использует тот же endpoint.
Mídia
GET
/messages
Просмотр истории отправленных сообщений со статусами и постраничной навигацией.
Histórico
GET
/webhooks
Просмотрите доставки вебхуков по событию, HTTP-результату, попыткам и пагинации.
Webhooks
DOC
Swagger / OpenAPI
Интерактивная документация с контрактами, примерами, обязательными полями и ожидаемыми ответами.
Docs
Техническое разделение
Выберите подходящую функцию для каждого этапа интеграции.
Отправляйте сообщения через Messaging API, запускайте коммерческие автоматизации через Events API и получайте обратные вызовы через webhooks. Ваше приложение может комбинировать эти функции в соответствии с требуемым потоком.
Официальное подключение — это канал связи; API WPP Marketing — интерфейс, используемый вашей системой. См. требования на Официальный API WhatsApp и сосуществование.
Ваша система обращается к WPP Marketing для отправки текстовых или медиа‑сообщений, а также для запроса истории сообщений и доставок webhook.
Ваша система отправляет коммерческие события, такие как создание заказа, подтверждение оплаты, отправка или брошенная корзина.
Поймите доступные события и автоматизацииWPP Marketing отправляет стандартизированные события создания, доставки, прочтения и ошибок на указанный вами URL.
Просмотрите события возврата и отслеживание доставокИспользуйте интерактивную документацию для проверки payload, аутентификации и ответов перед выводом в продакшен.
Токены должны храниться на бэкенде. Не раскрывайте учетные данные на публичных страницах, в фронтенд-приложениях или репозиториях.
В /send-text и /send-media Idempotency-Key позволяет повторять один и тот же запрос с успешным ответом в течение 48 часов. Повторное использование ключа с другим содержимым возвращает 409. Без ключа повторный вызов может дублировать отправку. Соблюдайте заголовки RateLimit и Retry-After; лимиты запросов отличаются от квоты плана.
Одна учетная запись для каждой интеграции с необходимыми правами.
В панели назовите токен, выберите scope и при необходимости задайте срок действия. Полный токен отображается только один раз при создании. В списке можно проверить последнее использование, срок действия и при необходимости отозвать доступ.
При смене учётных данных обновите секрет на своём сервере и отозовите предыдущий. Никогда не используйте токен провайдера WhatsApp вместо учётных данных API.
Разрешает отправку текста и медиа. Предоставляйте только интеграциям, которым нужно инициировать отправку.
Они позволяют просматривать, соответственно, историю сообщений и доставки вебхуков. У полномочий для отправки эти разрешения не назначаются автоматически.
Позволяет передавать клиентов, корзины и заказы через Events API в автоматизации, настроенные в аккаунте.
Просматривает сохранённые настройки, автоматизации, подсчёты и недавние логи для диагностики. Может содержать персональные данные и содержание сообщений: предоставляйте доступ только авторизованным интеграциям и службе поддержки. Этот запрос не проверяет подключение к провайдеру в реальном времени.
MCP и официальное API WhatsApp.
Подключите инструменты ИИ к вашей работе в WhatsApp через MCP от WPP Marketing. Интегрируйте WhatsApp в рабочие процессы ваших ассистентов и агентов, используя Официальное API в качестве подключения для сообщений.
MCP подключает потоки ваших агентов к интеграции; messaging API выполняет отправки, а официальное соединение следует правилам WhatsApp. Это не превращает MCP в нативного чат‑бота и не заменяет настройку аккаунта. Команда консультирует по действиям и требованиям интеграции для вашего сценария использования.
Используйте MCP в качестве пути интеграции между инструментами ИИ и WhatsApp, дополняя потоки ваших систем и команды.
Обсудите с нашей командой инструмент ИИ, который вы используете, и действия, которые вы хотите подключить к WhatsApp. Ознакомьтесь с требованиями и соответствующим объемом работ для вашей операции.
Расскажите про интеграцию MCPГотовы интегрировать вашу систему с WPP Marketing?
Откройте Swagger, чтобы просмотреть endpoints Messaging API, примеры payload, аутентификацию по bearer token и ожидаемые ответы. Для событий магазина и отчетов о доставке смотрите также Events API и Webhooks de status.