Invia testo WhatsApp (Meta)

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

Invia un messaggio di testo libero tramite la WhatsApp Cloud API di Meta (type=freetext). Puoi anche allegare un media o aggiungere pulsanti interattivi.

Finestra di 24 ore: i messaggi freetext si possono inviare solo entro 24 ore dall'ultimo messaggio del cliente. Fuori da questa finestra devi usare un template approvato.

Parametri

apikey obbligatorio

La tua API Key.

token obbligatorio

Token dell'account.

number obbligatorio

Numero destinatario in formato internazionale senza + (es. 1234567890).

type obbligatorio

Deve essere freetext.

message opzionale

Testo del messaggio (o didascalia se alleghi un media). Obbligatorio se non passi un media.

media_url opzionale

URL pubblico del file da allegare.

media_type opzionale

Tipo di media: image, video, audio o document. Obbligatorio se passi media_url.

file_name opzionale

Nome del file (solo per i documenti).

header opzionale

Testo dell'header (per i messaggi con pulsanti).

footer opzionale

Testo del footer (per i messaggi con pulsanti).

buttons opzionale

Array di pulsanti di risposta rapida, massimo 3. Ogni pulsante ha id e title.

Richiesta

# Testo semplice
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": "Ciao! Grazie per averci contattato."
  }'

# Testo + immagine
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": "Ecco il tuo 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' => 'Ciao! Grazie per averci contattato.',
    ]),
]);
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: 'Ciao! Grazie per averci contattato.'
  })
});
console.log(await res.json());

Risposta (200 OK)

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

Errore

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