Votre système appelle Whatsplaid pour valider un compte, gérer des contacts, des tags, des champs, des conversations, le panier, les messages et le support humain.
API publique et documentation
Connectez vos propres systèmes à Whatsplaid avec API, connecteurs et webhooks.
Utilisez l'API publique lorsque un autre système doit déclencher Whatsplaid. Utilisez le connecteur externe lorsque l'assistant doit consulter des produits, des commandes ou des données de votre système pendant la conversation. Utilisez les webhooks pour recevoir des événements capturés sur WhatsApp.
Trois contrats
Choisissez le sens correct de l'intégration.
La documentation Swagger sépare les flux pour éviter la confusion entre les appels à Whatsplaid, les requêtes faites par l'assistant et les événements envoyés à votre système.
Whatsplaid appelle votre système pour consulter des produits, des commandes, des clients ou la disponibilité en temps réel pendant une conversation.
Whatsplaid envoie des événements à une URL de votre choix. L'événement disponible sur le tableau de bord est le lead capturé pendant la conversation.
Swagger à `api.whatsplaid.com/docs/` contient les schémas, exemples, réponses attendues et contrats techniques complets.
Référence rapide des principaux points de terminaison.
Cette vue résume les ressources qui apparaissent dans la documentation officielle. La mise en œuvre finale doit suivre 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, conseiller commercial, post-vente, base de connaissances et panier.
Account
GET
/ecommerce/products/search
Recherche de produits dans les intégrations natives connectées, telles que Nuvemshop, Wix ou Shopify.
Ecommerce
GET
/ecommerce/orders/search
Recherche de 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 la segmentation et le contexte opérationnel.
Fields
POST
/messages/send
Envoie un message texte dans la fenêtre de support de 24 heures de WhatsApp.
Messaging
POST
/handoffs
Demande 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 d'intégration 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 de sortie pour les leads capturés.
Valide le compte, modules, contacts, tags, champs personnalisés, messages, conversations, panier et support humain.
Votre système expose des endpoints comme `/products/search` et `/orders/search` pour que Whatsplaid puisse consulter pendant la conversation.
Retour attendu avec `products`, incluant ID, nom, description, prix, disponibilité, stock, URL et image.
Retour attendu avec `orders`, incluant numéro, statut, paiement, livraison, total, client, suivi et articles.
L'événement `LEAD_CAPTURE` envoie les données du lead à l'URL configurée. Le endpoint doit répondre HTTP 200 ou 204.
Utilisez `Authorization: Bearer` dans les appels. Les tokens ne doivent pas être exposés dans le frontend public.
Besoin de mettre en œuvre ou de valider une intégration ?
Ouvrez la documentation interactive pour basculer entre `Whatsplaid Public API`, `Contrat du connecteur de données personnalisé` et `Webhooks sortants`.