Pedido, carrinho, pagamento, envio, cancelamento ou cadastro acontece no sistema de origem.
Events API
Envie eventos da sua loja ou ERP para acionar automações no WhatsApp.
Use a Events API quando seu sistema próprio precisa informar carrinho, pedido, pagamento, envio, cancelamento ou cliente criado ao WPP Marketing.
A Events API recebe o evento comercial e usa as automações configuradas. Para enviar uma mensagem diretamente, use a Messaging API. Para acompanhar entrega, leitura e erro, use os webhooks de status.
Fluxo
Seu sistema informa o evento. O WPP Marketing decide a automação.
A Events API é ideal para lojas customizadas, ERPs, backoffices e integrações que não têm conector plug and play.
Seu backend envia o evento com token, identificador, cliente, valores e links disponíveis.
O WPP Marketing verifica se existe automação ativa para aquele evento e cliente.
O cliente recebe WhatsApp de recuperação, pagamento, pedido, envio, campanha ou pós-venda.
Eventos comerciais suportados.
A nomenclatura final e campos obrigatórios devem seguir a documentação da Events API.
POST
cart.created
Registra intenção de compra e permite automações de acompanhamento inicial.
Carrinho
POST
cart.abandoned
Aciona recuperação de carrinho com lembrete e link de retorno quando disponível.
Recuperação
POST
order.created
Informa pedido criado ou aguardando pagamento para mensagens transacionais.
Pedido
POST
order.paid
Confirma pagamento e permite mensagem de confirmação, instruções e próximos passos.
Pagamento
POST
order.shipped
Envia atualização de envio, rastreio ou status logístico para reduzir chamados manuais.
Envio
POST
order.cancelled
Registra o cancelamento do pedido para acionar a comunicação configurada para esse evento.
Cancelamento
POST
customer.created
Alimenta base de contatos para boas-vindas, relacionamento, etiquetas e campanhas.
Cliente
Dados recomendados
Quanto melhor o evento, melhor a automação.
A Events API deve receber dados suficientes para identificar cliente, compra, valor, status e links úteis para a mensagem.
Telefone, nome, e-mail, país e identificador externo ajudam na deduplicação e segmentação.
Número, ID externo, total, moeda, status, método de pagamento e itens deixam a mensagem mais útil.
Checkout, pagamento, rastreio ou página do pedido podem ser usados em mensagens automáticas.
Informe external_id ou order.id e mantenha a origem estável. A deduplicação considera conta, origem normalizada, tipo de evento e identificador externo. Eventos repetidos retornam HTTP 200 com a indicação Duplicate event ignored. Este endpoint não usa o cabeçalho Idempotency-Key da Messaging API.
HTTP 200 confirma o processamento do evento, não a entrega de uma mensagem. O envio exige automação ativa para o evento, dados válidos do cliente e conexão configurada. Acompanhe a mensagem pelos relatórios e webhooks de status.
Crie uma credencial com events:write e envie eventos pelo servidor. Mantenha o token fora do frontend e de repositórios públicos. Use customer.phone para o telefone e os objetos customer e order conforme o exemplo e o contrato OpenAPI.
Quer conectar uma loja customizada ou ERP?
Abra a documentação da Events API para validar payloads, autenticação e exemplos antes de enviar eventos de produção.