Заказ, корзина, оплата, доставка, отмена или регистрация происходят в исходной системе.
Events API
Отправляйте события из вашего магазина или ERP, чтобы запускать автоматизации в WhatsApp.
Используйте Events API, когда вашей системе нужно передавать в WPP Marketing данные о корзине, заказе, платеже, доставке, отмене или создании клиента.
Events API получает коммерческое событие и использует настроенные автоматизации. Чтобы отправить сообщение напрямую, используйте Messaging API. Чтобы отслеживать доставку, чтения и ошибки, используйте вебхуки статуса.
Поток
Ваша система сообщает о событии. WPP Marketing решает, какую автоматизацию применить.
Events API идеально подходит для кастомных магазинов, ERP, бэкофисов и интеграций, у которых нет plug-and-play коннектора.
Ваш бэкенд отправляет событие с токеном, идентификатором, клиентом, значениями и доступными ссылками.
WPP Marketing проверяет, существует ли активная автоматизация для этого события и клиента.
Клиент получает WhatsApp-сообщения для восстановления, оплаты, заказа, доставки, кампании или послепродажного обслуживания.
Поддерживаемые коммерческие события.
Окончательная номенклатура и обязательные поля должны соответствовать документации Events API.
POST
cart.created
Фиксирует намерение покупки и позволяет автоматизировать начальные этапы сопровождения.
Carrinho
POST
cart.abandoned
Запускает восстановление корзины с напоминанием и ссылкой для возврата, когда доступно.
Recuperação
POST
order.created
Уведомляет о созданном заказе или ожидающем оплату для транзакционных сообщений.
Pedido
POST
order.paid
Подтверждает оплату и позволяет отправить сообщение с подтверждением, инструкциями и следующими шагами.
Pagamento
POST
order.shipped
Отправляет обновления по отправке, трекеру или статусу логистики, чтобы сократить количество ручных обращений.
Envio
POST
order.cancelled
Регистрирует отмену заказа, чтобы запустить коммуникацию, настроенную для этого события.
Cancelamento
POST
customer.created
Наполняет базу контактов для приветствий, управления взаимоотношениями, меток и кампаний.
Cliente
Рекомендуемые данные
Чем лучше событие, тем лучше автоматизация.
Events API должна получать достаточно данных для идентификации клиента, покупки, суммы, статуса и полезных ссылок для сообщения.
Номер телефона, имя, e‑mail, страна и внешний идентификатор помогают при дедупликации и сегментации.
Номер, внешний ID, сумма, валюта, статус, способ оплаты и позиции делают сообщение более полезным.
Страницы оформления заказа (checkout), оплаты, отслеживания или страницы заказа могут использоваться в автоматических сообщениях.
Укажите external_id или order.id и сохраняйте стабильный источник. Дедупликация учитывает аккаунт, нормализованный источник, тип события и внешний идентификатор. Повторные события возвращают HTTP 200 с пометкой Duplicate event ignored. Этот endpoint не использует заголовок Idempotency-Key Messaging API.
HTTP 200 подтверждает обработку события, но не доставку сообщения. Для отправки требуется активная автоматизация для события, корректные данные клиента и настроенное подключение. Отслеживайте сообщение через отчёты и status-webhook’и.
Создайте учетные данные (credential) с правом events:write и отправляйте события с сервера. Храните токен вне фронтенда и публичных репозиториев. Используйте customer.phone для номера телефона и объекты customer и order как в примере и в OpenAPI-контракте.
Хотите подключить кастомный магазин или ERP?
Откройте документацию Events API, чтобы проверить payload, аутентификацию и примеры перед отправкой событий в продакшен.