Vue d’ensemble
| Type | Description | Champ principal requis |
|---|
text | Message texte simple | text |
image | Image avec légende optionnelle | mediaUrl |
video | Vidéo avec légende optionnelle | mediaUrl |
audio | Fichier audio standard | mediaUrl |
voice_note | Note vocale WhatsApp | mediaUrl |
document | Fichier ou document | mediaUrl |
location | Localisation GPS | latitude, longitude |
contact | Partage d’un contact du répertoire | contactId |
instanceIdtotype ou templateId
Les endpoints POST /api/v1/messages/send et POST /api/v1/messages/schedule supportent deux modes :
- mode libre avec
type
- mode template avec
templateId
Envoi libre vs envoi via template
Mode libre
Vous fournissez directement type et les champs associés.
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "text",
"text": "Bonjour Awa"
}
Mode template
Vous fournissez templateId et, si nécessaire, des variables custom.*.
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"contactId": "cnt_uuid",
"templateId": "tmpl_uuid",
"variables": {
"code": "PROMO10"
}
}
type effectif est celui du template.
text
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "text",
"text": "Bonjour Jean,\n\nVotre commande #1234 est prête."
}
| Champ | Type | Requis | Contraintes |
|---|
text | string | ✓ | 1 à 4096 caractères |
image
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "image",
"mediaUrl": "https://cdn.example.com/produit.jpg",
"text": "Nouvelle collection disponible"
}
| Champ | Type | Requis | Contraintes |
|---|
mediaUrl | URL | ✓ | URL publique |
text | string | non | Légende optionnelle |
video
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "video",
"mediaUrl": "https://cdn.example.com/demo.mp4",
"text": "Découvrez notre nouveau produit"
}
| Champ | Type | Requis | Contraintes |
|---|
mediaUrl | URL | ✓ | URL publique |
text | string | non | Légende optionnelle |
audio
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "audio",
"mediaUrl": "https://cdn.example.com/message.mp3"
}
voice_note
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "voice_note",
"mediaUrl": "https://cdn.example.com/note.ogg"
}
La différence entre audio et voice_note est surtout le mode d’affichage côté WhatsApp.
document
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "document",
"mediaUrl": "https://cdn.example.com/facture.pdf",
"text": "Facture avril 2026"
}
| Champ | Type | Requis | Contraintes |
|---|
mediaUrl | URL | ✓ | URL publique |
text | string | non | Libellé ou légende |
location
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "location",
"latitude": 6.3654,
"longitude": 2.4183,
"locationName": "Boutique Cotonou Centre",
"locationAddress": "Avenue de la Marina, Cotonou"
}
| Champ | Type | Requis | Contraintes |
|---|
latitude | number | ✓ | Latitude décimale |
longitude | number | ✓ | Longitude décimale |
locationName | string | non | Nom du lieu |
locationAddress | string | non | Adresse |
{
"instanceId": "inst_uuid",
"to": "+22912345678",
"type": "contact",
"contactId": "cnt_uuid"
}
contactId doit appartenir à votre compte MsgFlash.
Champs communs
| Champ | Type | Requis | Description |
|---|
instanceId | UUID | ✓ | Instance WhatsApp à utiliser |
to | string | ✓ | Numéro E.164 |
type | enum | ✓ si pas de templateId | Type du message libre |
templateId | UUID | ✓ si pas de type | Template MsgFlash à utiliser |
contactId | UUID | non | Contact source ou contexte template |
variables | object | non | Valeurs pour custom.* |
scheduledAt | ISO 8601 | non | Utilisé uniquement sur /messages/schedule |
Un template peut être de type :
textimagevideoaudiodocument
Pour un template media, mediaUrl est obligatoire sur le template lui-même.
Exemple :
{
"name": "Brochure PDF",
"type": "document",
"body": "Bonjour {{contact.firstName}}, voici votre brochure.",
"mediaUrl": "https://cdn.example.com/brochure.pdf"
}
