Aller au contenu

API WaliChat + webhooks

Votre système envoie.Votre équipe garde la conversation.

Envoyez des messages, recevez des événements et attribuez des conversations avec l’API WaliChat. Le résultat apparaît là où travaille l’équipe.

Accès API dans WaliChat. Respectez les règles de messagerie et les limites du forfait.

REST API
POST /v1/messages
  1. Votre systèmePréparez le message
  2. REST APIPOST /v1/messages
  3. WaliChatVisible dans la conversation

Votre commande est prête à être retirée.

Requête acceptée · livraison suivie séparément

Un développeur indépendant examine une intégration dans le patio d'un café.

Votre équipe voit le message sortant.

Envoyez une mise à jour de commande

Recevez un événement entrant

Attribuez la conversation à Sara

De la requête à la boîte de l’équipe.

Trois tâches connectées : envoyer, recevoir et attribuer.

Faites défiler pour voir les exemples

Envoyez une mise à jour de commande

POST /v1/messages

Indiquez le dispositif connecté, le destinataire et le message. Utilisez un modèle approuvé lorsque l’API officielle l’exige.

REST API
POST /v1/messages
  1. Votre systèmePréparez le message

    device + phone + message

  2. REST APIPOST /v1/messages

    Authentifiez avec votre clé API.

  3. WaliChatVisible dans la conversation

    Votre équipe voit le message sortant.

Votre commande est prête à être retirée.

Requête acceptée · livraison suivie séparément

Une requête acceptée ne garantit pas la livraison. Consultez les événements d’état et gérez les erreurs dans votre système.

Recevez un événement entrant

Puis-je retirer ma commande demain ?

Configurez un webhook HTTPS et abonnez-vous à l’événement de message entrant.

Webhook

Puis-je retirer ma commande demain ?

  1. WhatsAppMessage reçu

    Le client écrit au numéro connecté.

  2. Webhookmessage:in:new

    L’événement arrive à votre point d’accès HTTPS.

  3. Votre systèmeChoisissez l’action suivante

    Lisez, traitez et décidez de la suite.

message:in:new

Webhook envoyé au point d’accès configuré

Votre système choisit l’action suivante. Recevoir un événement n’envoie pas automatiquement une réponse.

Attribuez la conversation à Sara

PATCH /v1/chat/{device}/chats/{chat}/owner

Indiquez une personne ou un service autorisé. Les services dépendent du forfait.

REST API
PATCH /v1/chat/{device}/chats/{chat}/owner
  1. Votre systèmeChoisissez le responsable

    agent / email / department

  2. REST APIPATCH …/owner

    Modifiez le responsable de la conversation.

  3. WaliChatPassez la conversation à Sara

    Sara reprend avec le contexte existant.

Conversation attribuée

Sara est responsable de la conversation

Les attributions et les notes organisent l’équipe ; elles n’envoient pas de message au client.

Choisissez l’interface pour la tâche.

Utilisez votre système, un flux ou un client IA compatible.

REST API

Consultez et modifiez via des points d’accès JSON documentés.

Webhooks

Recevez les événements choisis dans votre propre point d’accès HTTPS.

MCP

Votre IA, connectée à votre activité.

Les actions API utilisent les droits de la clé et les limites du forfait. Les règles et frais Meta s’appliquent toujours.

Consultez la référence API

Une clé. Un test. Votre premier événement.

Commencez dans la documentation avec un numéro de test connecté et vérifiez chaque réponse.

  1. Créez une clé API

    Utilisez un compte autorisé pour le numéro et conservez la clé dans votre système.

  2. Testez la requête

    Utilisez la documentation et le testeur API avec vos données de test.

  3. Gérez les événements et erreurs

    Configurez les webhooks et vérifiez les codes de réponse, limites et états de livraison.

Avant de commencer

  • Un compte WaliChat avec un numéro connecté et un accès API.
  • Un point d’accès HTTPS pour les webhooks choisis.
Deux développeurs travaillent sur un ordinateur portable dans un espace de coworking de quartier.
Sara · WaliChat

J’ai la conversation et la note. Je prends le relais.

Quand une personne est nécessaire, l’équipe a la conversation.

Préparez le relais pour les exceptions. Votre équipe voit ce qui s’est passé et poursuit avec le client.

Découvrez le travail de votre équipe

Une conversationAvec les messages envoyés

Une personne responsableAttribuée à la bonne personne

Vos règles d’accèsRôles et accès au numéro

Avant votre première requête API.

Une requête acceptée signifie-t-elle livraison ?

Non. Consultez les événements d’état et la réponse documentée. Votre système doit gérer échecs et nouvelles tentatives.

Que se passe-t-il hors de la fenêtre de service WhatsApp ?

L’API officielle WhatsApp conserve ses règles. Hors de la fenêtre de service, utilisez un modèle approuvé et respectez les règles et frais applicables aux messages.

Préparez le flux. Continuez votre activité.

Commencer gratuitement

Commencez avec WaliChat et choisissez un forfait avec Flows.