Enviar texto de WhatsApp (Meta)

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

Envía un mensaje de texto libre a través de la WhatsApp Cloud API de Meta (type=freetext). También puedes adjuntar un archivo multimedia o añadir botones interactivos.

Ventana de 24 horas: los mensajes de texto libre solo se pueden enviar dentro de las 24 horas posteriores al último mensaje del cliente. Fuera de esta ventana debes usar una plantilla aprobada.

Parámetros

apikey obligatorio

Tu API Key.

token obligatorio

Token de la cuenta.

number obligatorio

Número del destinatario en formato internacional sin + (p. ej. 1234567890).

type obligatorio

Debe ser freetext.

message opcional

Texto del mensaje (o pie de foto si adjuntas un archivo multimedia). Obligatorio si no envías un archivo multimedia.

media_url opcional

URL pública del archivo que se va a adjuntar.

media_type opcional

Tipo de multimedia: image, video, audio o document. Obligatorio si envías media_url.

file_name opcional

Nombre del archivo (solo para documentos).

header opcional

Texto del encabezado (para mensajes con botones).

footer opcional

Texto del pie de página (para mensajes con botones).

buttons opcional

Array de botones de respuesta rápida, máximo 3. Cada botón tiene id y title.

Solicitud

# Texto 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": "¡Hola! Gracias por contactarnos."
  }'

# Texto + imagen
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": "¡Aquí tienes tu cupón!",
    "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' => '¡Hola! Gracias por contactarnos.',
    ]),
]);
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: '¡Hola! Gracias por contactarnos.'
  })
});
console.log(await res.json());

Respuesta (200 OK)

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

Error

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