Enviar texto WhatsApp (Meta)

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

Envie uma mensagem de texto livre através da WhatsApp Cloud API da Meta (type=freetext). Também pode anexar um ficheiro de media ou adicionar botões interativos.

Janela de 24 horas: as mensagens de texto livre só podem ser enviadas dentro de 24 horas após a última mensagem do cliente. Fora desta janela, deve usar um template aprovado.

Parâmetros

apikey obrigatório

A tua API Key.

token obrigatório

Token da conta.

number obrigatório

Número do destinatário em formato internacional sem + (ex. 1234567890).

type obrigatório

Deve ser freetext.

message opcional

Texto da mensagem (ou legenda se anexar um ficheiro de media). Obrigatório se não enviar um ficheiro de media.

media_url opcional

URL pública do ficheiro a anexar.

media_type opcional

Tipo de media: image, video, audio ou document. Obrigatório se enviar media_url.

file_name opcional

Nome do ficheiro (apenas para documentos).

header opcional

Texto do cabeçalho (para mensagens com botões).

footer opcional

Texto do rodapé (para mensagens com botões).

buttons opcional

Array de botões de resposta rápida, máximo 3. Cada botão tem id e title.

Pedido

# Texto simples
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": "Olá! Obrigado por nos ter contactado."
  }'

# Texto + imagem
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": "Aqui está o seu cupão!",
    "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' => 'Olá! Obrigado por nos ter contactado.',
    ]),
]);
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: 'Olá! Obrigado por nos ter contactado.'
  })
});
console.log(await res.json());

Resposta (200 OK)

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

Erro

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