Recevoir des messages

Récupérez les messages que vos clients envoient à votre numéro — par lecture (GET /v1/messages/inbound), par webhook temps réel, ou via l'outil MCP.

Deux façons de recevoir

Quand un client écrit à votre numéro WhatsApp, le message vous est (1) livré en temps réel via le webhook message.inbound si vous en avez configuré un, et (2) stocké pour que vous puissiez le relire à la demande. Recevoir est gratuit — aucun crédit n'est débité (seuls les envois de templates le sont).

Lire les messages reçus

GET /v1/messages/inbound — scope messages:read

Paramètres : number (un phone_number_id pour filtrer sur l'un de vos numéros), from (un expéditeur précis), since (timestamp ISO — renvoie les messages reçus APRÈS, du plus ancien au plus récent), limit (défaut 50, max 200). Pour du polling : mémorisez le received_at du dernier message traité et repassez-le en since pour ne récupérer que les nouveaux.

Réponse

[
  {
    "id": "a1b2…",
    "from": "+237699000111",
    "type": "text",
    "text": "Bonjour, ma commande est-elle prête ?",
    "media_id": null,
    "media_mime": null,
    "wa_message_id": "wamid…",
    "number": "1234567890",
    "timestamp": "2026-08-19T14:05:00Z",
    "received_at": "2026-08-19T14:05:01Z"
  }
]

Média (image, audio, document) : nous ne réhébergeons pas les octets pour les numéros API — vous recevez le type et le media_id Meta ; le texte et les légendes passent intégralement.

Temps réel : webhook message.inbound

Enregistrez une URL de webhook (dans la console → Webhook). À chaque message reçu, nous y POSTons un événement message.inbound signé. C'est le canal temps réel ; l'endpoint ci-dessus reste le filet de rattrapage.

Charge utile message.inbound

{
  "from": "+237699000111",
  "number": "1234567890",
  "wa_message_id": "wamid…",
  "type": "text",
  "text": "Bonjour…",
  "media_id": null,
  "media_url": null,
  "timestamp": "2026-08-19T14:05:00Z"
}

Via Claude (MCP)

L'outil MCP whatsapp_list_inbound expose les mêmes messages reçus à Claude (paramètres number, limit) — utile pour « montre-moi les derniers messages clients ».