Envoyer un message WhatsApp (inbound) via l'API Kanal

Endpoint

POST https://api.getkanal.com/open-api/v1/messages/send

Authentification

Chaque requête doit inclure votre clé API dans le header Authorization :

Authorization: Bearer VOTRE_CLE_API

Votre clé API est liée à un numéro WhatsApp Business. Tous les messages seront envoyés depuis ce numéro.

Pré-requis

Le contact doit avoir envoyé un message dans les dernières 24 heures (fenêtre de conversation WhatsApp). Sans conversation active, utilisez l'endpoint /v1/templates pour envoyer un template approuvé.

Types de messages supportés

Texte

{
  "to": "33612345678",
  "type": "text",
  "text": {
    "body": "Bonjour, voici votre projection !"
  }
}

Image

{
  "to": "33612345678",
  "type": "image",
  "image": {
    "link": "https://example.com/photo.jpg",
    "caption": "Retrouvez ce produit ici 👉 https://example.com/produit"
  }
}

Video

{
  "to": "33612345678",
  "type": "video",
  "video": {
    "link": "https://example.com/video.mp4",
    "caption": "Découvrez notre produit en vidéo"
  }
}

Audio

{
  "to": "33612345678",
  "type": "audio",
  "audio": {
    "link": "https://example.com/audio.mp3"
  }
}

Document

{
  "to": "33612345678",
  "type": "document",
  "document": {
    "link": "https://example.com/facture.pdf"
  }
}

Idempotence

Pour éviter les envois en double, ajoutez un header idempotency-key avec un identifiant unique :

idempotency-key: mon-id-unique-123

Si un message a déjà été envoyé avec cette clé, l'API retournera un 201 sans renvoyer le message.

Réponse

Succès (200) :

{
  "success": true,
  "message": "Message sent successfully",
  "message_id": 12345,
  "contact_id": 678,
  "phone_number": "33612345678"
}

Erreurs courantes :

Code

Raison

Exemples cURL

Texte

curl -X POST https://api.getkanal.com/open-api/v1/messages/send \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "33612345678",
    "type": "text",
    "text": {
      "body": "Bonjour, voici votre projection !"
    }
  }'

Image

curl -X POST https://api.getkanal.com/open-api/v1/messages/send \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "33612345678",
    "type": "image",
    "image": {
      "link": "https://example.com/projection.jpg",
      "caption": "Retrouvez ce produit ici 👉 https://example.com/produit"
    }
  }'

Video

curl -X POST https://api.getkanal.com/open-api/v1/messages/send \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "33612345678",
    "type": "video",
    "video": {
      "link": "https://example.com/video.mp4",
      "caption": "Découvrez notre produit en vidéo"
    }
  }'

Audio

curl -X POST https://api.getkanal.com/open-api/v1/messages/send \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "33612345678",
    "type": "audio",
    "audio": {
      "link": "https://example.com/audio.mp3"
    }
  }'

Document

curl -X POST https://api.getkanal.com/open-api/v1/messages/send \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "33612345678",
    "type": "document",
    "document": {
      "link": "https://example.com/facture.pdf"
    }
  }'