API REST · messages

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Votre commande est prête à être retirée en boutique."
}

Message créé · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

L’API WhatsApp pour votre système

Votre système informe.Votre équipe garde le fil.

Lorsqu’une commande est prête, votre système peut créer le message. Votre équipe poursuit la conversation dans Pulpo.

Commencer gratuitement Voir en action

Données fictives. Utilisez un compte autorisé, un numéro opérationnel et les conditions d’envoi applicables.

Requête, événement et modèle.

Exemples d’opérations documentées. Consultez le schéma complet et testez avec votre compte avant l’intégration.

La commande est prête

Créer un message

Informer que la commande est prête à être retirée.

Votre serveur utilise l’en-tête Token et le corps de la requête. Le destinataire et le texte de cet exemple sont fictifs.

PulpoChatAPI REST · messages

Exemple de requête

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Votre commande est prête à être retirée en boutique."
}

Message créé · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

Le code 201 confirme la création du message. Consultez son évolution avant de considérer qu’il est arrivé au destinataire.

Vérifiez l’accès au numéro, l’accord du destinataire et les règles d’envoi. Si vous avez plusieurs numéros, consultez le champ device dans la documentation.

Une nouvelle conversation arrive

Recevoir un événement

Informer votre système d’un message entrant.

Vous configurez l’URL de votre webhook et les événements nécessaires. Cet extrait présente certains champs d’un événement, pas son schéma complet.

PulpoChatWebhook · message entrant

POST vers votre serveur · exemple

POST https://tu-servidor.example/webhooks/pulpo
Content-Type: application/json
X-Idempotency-Key: ID_EVENTO_DE_EJEMPLO

{
  "id": "ID_MENSAJE_DE_EJEMPLO",
  "object": "message",
  "event": "message:in:new"
}

Réponse de votre serveur · exemple

HTTP/1.1 200 OK

Votre serveur traite l’événement et décide de la suite. Prévoyez la gestion des nouvelles tentatives pour éviter de traiter plusieurs fois le même événement.

Utilisez HTTPS en production et validez le schéma complet. La réception d’un webhook n’envoie pas à elle seule une réponse WhatsApp.

Vous préparez une notification proactive

Consulter les modèles

Trouver un modèle approuvé pour la notification.

Consultez les modèles du compte et vérifiez leur nom, leur langue et leur contenu avant de préparer l’envoi.

PulpoChatAPI REST · modèles

Exemple de consultation

GET https://api.pulpo.chat/v1/waba/templates?status=approved
Token: TU_CLAVE_DE_API

Extrait de réponse · exemple

{"data":[{"name":"PLANTILLA_DE_EJEMPLO",
"status":"approved","language":"es"}],
"total":1,"page":0,"size":1}

La requête renvoie les modèles que vous pouvez examiner. Pour l’envoi, suivez le format et les prérequis de la documentation.

Les modèles approuvés sont nécessaires lorsque les règles de WhatsApp l’exigent. Cette requête ne crée ni n’envoie de message.

De l’exemple à l’intégration.

Testez la requête, préparez le récepteur d’événements ou consultez le schéma des modèles.

Créer le message depuis votre système

Consultez le schéma des messages et testez la requête avec un compte préparé dans l’outil de test de l’API.

Ouvrez le testeur API

Recevoir les événements de WhatsApp

Préparez votre récepteur HTTPS, sélectionnez les événements et gérez les nouvelles tentatives avant le passage en production.

Consulter le guide des webhooks

Examiner les modèles du compte

Consultez les modèles approuvés et les formats d’envoi avec leur langue et leurs variables.

Ouvrir la documentation de l’API

Préférez-vous préparer un workflow visuel ?

Flows réunit des étapes et des connexions à configurer et à tester. Le serveur MCP permet de demander des tâches depuis un client autorisé comme ChatGPT ou Claude.

Voir les flux Voir le serveur MCP

Une clé. Un numéro. Un test.

Gardez les identifiants sur votre serveur et vérifiez l’opération avant de l’utiliser dans votre activité réelle.

Créez et protégez votre clé
Utilisez une clé autorisée pour votre compte. Conservez-la sur le serveur et vérifiez ses accès avant de partager une intégration.
Vérifiez le numéro
Vérifiez que le numéro est opérationnel et que votre compte dispose de l’accès et des capacités nécessaires à l’opération.
Testez la requête et les événements
Consultez le schéma, faites une requête de test et validez la réponse. Si vous utilisez des webhooks, préparez le récepteur et la gestion des nouvelles tentatives.

Avant de commencer

Un compte autorisé et un numéro opérationnel.
Des identifiants protégés sur votre serveur ; les exemples ne contiennent aucune clé réelle.
Le consentement du destinataire et des modèles approuvés lorsque l’envoi l’exige.
Un récepteur HTTPS et une gestion des nouvelles tentatives si vous utilisez des webhooks.

Commencer gratuitement Voir les forfaits et les conditions

Avant de connecter votre système.

Un code 201 signifie-t-il que le message est arrivé ?

Le code 201 confirme que le message a été créé. Consultez son statut et les événements disponibles pour suivre son évolution ; ne l’utilisez pas comme preuve de livraison ou de lecture.

Puis-je mettre ma clé dans la page web ?

Conservez la clé sur votre serveur. Évitez de l’exposer dans le navigateur, des dépôts publics ou des exemples partagés.

Quand ai-je besoin d’un modèle approuvé ?

Lorsque les règles de WhatsApp l’exigent, par exemple pour les messages proactifs en dehors de la fenêtre de service client. Consultez les prérequis et le format d’envoi dans la documentation.

Préparez la notification dont votre système a besoin.

Commencer gratuitement

Créez votre compte, vérifiez l’accès et consultez la documentation pour tester l’opération.