Votre système appelle Whatsplaid pour valider les comptes, gérer les contacts, les étiquettes, les champs, les conversations, le panier, les messages et l’assistance humaine.
API publique et documentation
Connectez vos systèmes à Whatsplaid avec des API, des connecteurs et des webhooks.
Utilisez l’API publique lorsqu’un autre système doit déclencher Whatsplaid. Utilisez le connecteur externe lorsque l’assistant doit interroger des produits, des commandes ou des données de votre système pendant la conversation. Utilisez des webhooks pour recevoir les événements capturés sur WhatsApp.
Trois contrats
Choisissez le sens correct de l’intégration.
La documentation Swagger sépare les flux afin d'éviter toute confusion entre les appels à Whatsplaid, les requêtes effectuées par l'assistant et les événements envoyés à votre système.
Whatsplaid appelle votre système pour interroger des produits, commandes, clients ou la disponibilité en temps réel lors d’une conversation.
Whatsplaid envoie des événements vers une URL que vous fournissez. L'événement affiché dans le tableau de bord est le lead capturé pendant la conversation.
Le Swagger à `api.whatsplaid.com/docs/` contient les schémas, exemples, réponses attendues et contrats techniques complets.
Référence rapide des principaux endpoints.
Cette vue résume les fonctionnalités apparaissant dans la documentation officielle. L’implémentation finale doit suivre le Swagger.
GET
/store
Renvoie les données du compte, le commerce électronique connecté et les modules actifs.
Account
GET
/modules
Liste des modules actifs, tels que leads, consultant commercial, après-vente, base de connaissances et panier.
Account
GET
/ecommerce/products/search
Recherchez des produits dans les intégrations natives connectées, telles que Nuvemshop, Wix ou Shopify.
Ecommerce
GET
/ecommerce/orders/search
Rechercher des commandes par numéro, e‑mail ou téléphone dans les intégrations natives connectées.
Ecommerce
POST
/contacts
Crée ou met à jour un contact en utilisant le téléphone comme clé principale.
Contacts
PATCH
/contacts/{contactId}/custom-fields
Met à jour les champs personnalisés pour le ciblage et le contexte opérationnel.
Fields
POST
/messages/send
Envoie un message texte dans la fenêtre de prise en charge de 24 heures de WhatsApp.
Messaging
POST
/handoffs
Demander une assistance humaine en utilisant la configuration actuelle de l’entreprise.
Handoff
Contrats techniques
La documentation couvre l’API, le connecteur externe et les webhooks.
Le menu des intégrations de l'ADMIN utilise la même séparation : API publique de Whatsplaid, connecteur externe pour les requêtes dans les systèmes internes et webhook sortant pour les leads capturés.
Valide le compte, les modules, les contacts, les tags, les champs personnalisés, les messages, les conversations, le panier et l'assistance humaine.
Votre système expose des endpoints tels que `/products/search` et `/orders/search` pour que Whatsplaid les interroge pendant la conversation.
Retour attendu avec `products`, incluant l’ID, le nom, la description, le prix, la disponibilité, le stock, l’URL et l’image.
Réponse attendue avec `orders`, incluant numéro, statut, paiement, livraison, total, client, suivi et articles.
L’événement `LEAD_CAPTURE` envoie les données du lead vers l’URL configurée. Le point de terminaison doit répondre avec HTTP 200 ou 204.
Utilisez `Authorization: Bearer` dans les appels. Les jetons ne doivent pas être exposés dans le frontend public.
Besoin d’implémenter ou de valider une intégration ?
Ouvrez la documentation interactive pour basculer entre `Whatsplaid Public API`, `Custom Data Connector Contract` et `Outgoing Webhooks`.