La commande, le panier, le paiement, l'expédition, l'annulation ou l'inscription se font dans le système d'origine.
API d'événements
Envoyez les événements de votre boutique ou ERP pour déclencher des automatisations sur WhatsApp.
Utilisez l’Events API lorsque votre propre système doit signaler un panier, une commande, un paiement, une expédition, une annulation ou la création d’un client à WPP Marketing.
L'Events API reçoit l'événement commercial et utilise les automatisations configurées. Pour envoyer un message directement, utilisez le Messaging API. Pour suivre la livraison, les accusés de lecture et les erreurs, utilisez le webhooks d'état.
Flux
Votre système signale l'événement. WPP Marketing décide de l'automatisation.
L'Events API est idéale pour les boutiques personnalisées, les ERP, les back-offices et les intégrations qui ne disposent pas d'un connecteur plug-and-play.
Votre backend envoie l'événement avec le token, l'identifiant, le client, les valeurs et les liens disponibles.
WPP Marketing vérifie s'il existe une automatisation active pour cet événement et ce client.
Le client reçoit des messages WhatsApp de relance, paiement, commande, expédition, campagne ou après-vente.
Événements commerciaux pris en charge.
La nomenclature finale et les champs obligatoires doivent respecter la documentation de l’Events API.
POST
cart.created
Enregistre l'intention d'achat et permet des automatisations de suivi initial.
Carrinho
POST
cart.abandoned
Déclenche la récupération de panier avec un rappel et un lien de retour lorsqu'il est disponible.
Recuperação
POST
order.created
Informe commande créée ou en attente de paiement pour les messages transactionnels.
Pedido
POST
order.paid
Confirme le paiement et permet un message de confirmation, des instructions et les prochaines étapes.
Pagamento
POST
order.shipped
Envoie des mises à jour d'expédition, de suivi ou de statut logistique pour réduire les tickets manuels.
Envio
POST
order.cancelled
Enregistre l'annulation de la commande pour déclencher la communication configurée pour cet événement.
Cancelamento
POST
customer.created
Alimente la base de contacts pour les messages de bienvenue, la gestion des relations, les étiquettes et les campagnes.
Cliente
Données recommandées
Plus l'événement est bon, meilleure est l'automatisation.
L'Events API doit recevoir des données suffisantes pour identifier le client, l'achat, le montant, le statut et des liens utiles pour le message.
Le numéro de téléphone, le nom, l'e-mail, le pays et l'identifiant externe aident à la déduplication et à la segmentation.
Numéro, ID externe, total, devise, statut, méthode de paiement et articles rendent le message plus utile.
La page de paiement, le checkout, le suivi ou la page de commande peuvent être utilisés dans des messages automatisés.
Fournissez external_id ou order.id et maintenez la source stable. La déduplication prend en compte le compte, la source normalisée, le type d’événement et l’identifiant externe. Les événements répétés retournent HTTP 200 avec l’indication Duplicate event ignored. Cet endpoint n’utilise pas l’en-tête Idempotency-Key de la Messaging API.
HTTP 200 confirme le traitement de l’événement, pas la livraison d’un message. L’envoi exige une automatisation active pour l’événement, des données client valides et une connexion configurée. Suivez le message via les rapports et les webhooks de statut.
Créez une clé d’accès avec events:write et envoyez les événements depuis le serveur. Gardez le token hors du frontend et des dépôts publics. Utilisez customer.phone pour le numéro de téléphone et les objets customer et order comme dans l'exemple et le contrat OpenAPI.
Vous souhaitez connecter une boutique personnalisée ou un ERP ?
Consultez la documentation de l’Events API pour valider les payloads, l’authentification et les exemples avant d’envoyer des événements en production.