Dans Développeurs > Identifiants, créez un jeton pour l’intégration messages:write. Copiez-le lors de la création, stockez-le dans votre backend et configurez la connexion WhatsApp dans le tableau de bord avant d’envoyer.
Développeur d’API
API pour connecter WhatsApp à vos systèmes et applications.
Intégrez CRM, ERP, applications et systèmes internes à WhatsApp via l’API REST de WPP Marketing. Envoyez du texte et des médias, consultez les messages et suivez les livraisons via des webhooks. Utilisez également MCP pour intégrer vos flux à l’API Officielle. Découvrir le MCP.
Quand utiliser
Utilisez l'API de messagerie lorsque votre système doit envoyer des messages WhatsApp.
Utilisez votre CRM pour initier un contact, votre ERP pour envoyer une mise à jour ou votre application pour prévenir un client. La logique de l'envoi reste dans votre système ; l'API effectue l'envoi via la connexion configurée sur le compte. Pour des automatisations commerciales prêtes à l'emploi, utilisez la Events API.
Utilisez POST /send-text pour du texte ou POST /send-media pour des médias. Sur la connexion officielle, le texte et l'image utilisent les modèles configurés ; l'audio, la vidéo et les documents nécessitent un message reçu du client dans les dernières 24 heures.
HTTP 200 indique acceptation, pas livraison. Avec messages:read, utilisez GET /messages et consultez les statuts disponibles pour le canal.
Enregistrez l'URL HTTPS et activez les événements dans le tableau de bord. Utilisez webhooks:read pour consulter les tentatives via GET /webhooks ; ce point de terminaison répertorie les livraisons, il n'enregistre pas d'abonnements.
Du jeton à la première expédition incluse.
Sur votre serveur, remplacez SEU_TOKEN par la crédential et le numéro par le destinataire autorisé pour le test. Utilisez une clé unique par envoi et réutilisez la même clé uniquement lors de la répétition de la même requête.
Vérifiez le statut HTTP et le corps de la réponse. Pour 401, vérifiez le jeton et sa validité ; pour 403, contrôlez les scopes et les conditions du compte. Pour 409, vérifiez si la clé a déjà été utilisée avec un autre contenu. Pour 429, respectez l’en-tête Retry-After avant de réessayer.
Ensuite, consultez GET /messages avec messages:read ou surveillez les webhooks configurés. La confirmation de livraison dépend de la réponse du canal.
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."}'Texte, médias, historique et suivi des envois.
Utilisez les endpoints REST pour intégrer WhatsApp à votre application. L’API WPP Marketing utilise la connexion configurée dans le compte ; pour fonctionner avec l’API officielle de WhatsApp, configurez cette connexion dans le tableau de bord. Consultez l’OpenAPI pour les formats, portées, limites et réponses de chaque opération.
POST
/send-text
Envoie un message texte à un numéro WhatsApp.
Texto
POST
/send-media
Envoyez une image, un audio, une vidéo ou un document via une URL publique HTTPS, selon le format et les conditions de connexion. L’audio utilise ce même endpoint.
Mídia
GET
/messages
Consultez l'historique des messages envoyés avec statut et pagination.
Histórico
GET
/webhooks
Consulte les livraisons de webhooks avec événement, résultat HTTP, tentatives et pagination.
Webhooks
DOC
Swagger / OpenAPI
Documentation interactive avec contrats, exemples, champs obligatoires et réponses attendues.
Docs
Séparation technique
Choisissez la fonctionnalité adaptée à chaque étape de l'intégration.
Envoyez des messages avec la Messaging API, déclenchez des automatisations commerciales avec la Events API et recevez des retours via des webhooks. Votre application peut combiner ces fonctionnalités selon le flux requis.
La connexion officielle est le canal de communication ; l'API WPP Marketing est l'interface utilisée par votre système. Consultez les exigences sur API officielle de WhatsApp et coexistence.
Votre système appelle WPP Marketing pour envoyer des messages texte ou média et pour consulter les historiques de messages et les livraisons de webhooks.
Votre système envoie des événements commerciaux tels que commande créée, paiement approuvé, expédition ou panier abandonné.
Comprenez les événements et les automatisations disponiblesWPP Marketing envoie des événements standardisés de création, livraison, lecture et d’erreur vers une URL que vous fournissez.
Consultez les événements de retour et le suivi des livraisonsUtilisez la documentation interactive pour valider les payloads, l'authentification et les réponses avant de déployer en production.
Les tokens doivent rester dans le backend. N'exposez pas les identifiants sur des pages publiques, des applications frontales ou des dépôts.
Dans /send-text et /send-media, Idempotency-Key vous permet de répéter la même requête avec une réponse réussie pendant jusqu'à 48 heures. Réutiliser la clé avec un contenu différent renvoie 409. Sans la clé, répéter l'appel peut dupliquer l'envoi. Respectez les en-têtes RateLimit et Retry-After ; les limites de requêtes diffèrent du quota du plan.
Une seule identification par intégration, avec les autorisations nécessaires.
Dans le tableau de bord, donnez un nom au jeton, sélectionnez les portées et définissez une expiration facultative. Le jeton complet apparaît une seule fois lors de la création. La liste permet de vérifier la dernière utilisation, l'expiration et de révoquer l'accès si nécessaire.
Lors de la rotation d'une crédential, mettez à jour le secret sur votre serveur et révoquez la précédente. N'utilisez jamais le jeton du fournisseur WhatsApp à la place de la crédential de l'API.
Permet d'envoyer du texte et des médias. Accordez uniquement aux intégrations qui doivent initier des envois.
Elles permettent de consulter, respectivement, l'historique des messages et les livraisons des webhooks. Une identité d'envoi ne reçoit pas ces autorisations automatiquement.
Permet de transmettre des clients, paniers et commandes via l'Events API aux automatisations configurées dans le compte.
Consulte les paramètres enregistrés, les automatisations, les comptes et les journaux récents pour le diagnostic. Peut inclure des données personnelles et le contenu des messages : n'accordez l'accès qu'aux intégrations et au support autorisés. Cette requête ne vérifie pas en temps réel la connexion au fournisseur.
MCP et API officielle de WhatsApp.
Connectez des outils d'IA à votre opération WhatsApp avec le MCP de WPP Marketing. Intégrez WhatsApp aux flux de vos assistants et agents, en utilisant l'API Officielle comme connexion de messagerie.
MCP connecte les flux de vos agents à l'intégration ; l'API de messagerie effectue les envois et la connexion officielle respecte les règles de WhatsApp. Cela ne transforme pas le MCP en chatbot natif ni ne remplace la configuration du compte. L'équipe guide les actions et les exigences d'intégration pour votre cas d'utilisation.
Utilisez MCP comme voie d'intégration entre les outils d'IA et WhatsApp, en complétant les flux de vos systèmes et de votre équipe.
Discutez avec notre équipe de l’outil d’IA que vous utilisez et des actions que vous souhaitez connecter à WhatsApp. Consultez les exigences et le périmètre adapté à votre opération.
Parler de l'intégration MCPPrêt à intégrer votre système à WPP Marketing ?
Ouvrez le Swagger pour consulter les endpoints de la Messaging API, des exemples de payload, l’authentification par bearer token et les réponses attendues. Pour les événements de la boutique et les retours de livraison, voyez aussi Events API et Webhooks de status.