Envoyer un texte WhatsApp (Meta)

POSThttps://app.sendapp.ai/api/whatsapp-meta/send

Envoyez un message en texte libre via la WhatsApp Cloud API de Meta (type=freetext). Vous pouvez aussi joindre un média ou ajouter des boutons interactifs.

Fenêtre de 24 heures : les messages en texte libre ne peuvent être envoyés que dans les 24 heures suivant le dernier message du client. En dehors de cette fenêtre, vous devez utiliser un modèle approuvé.

Paramètres

apikey obligatoire

Votre API Key.

token obligatoire

Token du compte.

number obligatoire

Numéro du destinataire au format international sans + (ex. 1234567890).

type obligatoire

Doit être freetext.

message facultatif

Texte du message (ou légende si vous joignez un média). Obligatoire si vous ne transmettez pas de média.

media_url facultatif

URL publique du fichier à joindre.

media_type facultatif

Type de média : image, video, audio ou document. Obligatoire si vous transmettez media_url.

file_name facultatif

Nom du fichier (uniquement pour les documents).

header facultatif

Texte de l'en-tête (pour les messages avec boutons).

footer facultatif

Texte du pied de page (pour les messages avec boutons).

buttons facultatif

Tableau de boutons de réponse rapide, 3 maximum. Chaque bouton possède id et title.

Requête

# Texte simple
curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/send' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "number": "1234567890",
    "type": "freetext",
    "message": "Bonjour ! Merci de nous avoir contactés."
  }'

# Texte + image
curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/send' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "number": "1234567890",
    "type": "freetext",
    "message": "Voici votre coupon !",
    "media_url": "https://esempio.com/coupon.jpg",
    "media_type": "image"
  }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/whatsapp-meta/send');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'apikey'  => 'YOUR_API_KEY',
        'token'   => 'YOUR_ACCOUNT_TOKEN',
        'number'  => '1234567890',
        'type'    => 'freetext',
        'message' => 'Bonjour ! Merci de nous avoir contactés.',
    ]),
]);
echo curl_exec($ch);

const res = await fetch('https://app.sendapp.ai/api/whatsapp-meta/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'YOUR_API_KEY',
    token: 'YOUR_ACCOUNT_TOKEN',
    number: '1234567890',
    type: 'freetext',
    message: 'Bonjour ! Merci de nous avoir contactés.'
  })
});
console.log(await res.json());

Réponse (200 OK)

{
  "status": "success",
  "message": "Message sent successfully",
  "message_id": "wamid.HBgLMzkxMjM0NTY3ODkwFQIAERgSN0EwMjBBQkZDRDEyMzQ1Njc4"
}

Erreur

{
  "status": "error",
  "message": "No active WhatsApp Meta instance found"
}