Enviar texto WhatsApp (Meta)

POST https://app.sendapp.ai/api/whatsapp-meta/send

Envia uma mensagem de texto livre através da WhatsApp Cloud API da Meta (type=freetext). Pode anexar um ficheiro, adicionar até 3 botões de resposta rápida ou um botão que abre uma ligação.

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.

Uma mensagem pode ter ou até 3 botões de resposta rápida (buttons) ou um botão de ligação (url_button): o WhatsApp não permite usá-los em conjunto. Com url_button, o ficheiro anexado passa a ser o cabeçalho da mensagem (imagem, vídeo ou documento, não áudio).

Parâmetros

12 · 4 obrigatórios

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, máximo 60 caracteres (para mensagens com botões).

footer opcional

Texto do rodapé, máximo 60 caracteres (para mensagens com botões).

buttons opcional

Lista de botões de resposta rápida, máximo 3. Cada botão tem um id e um title (máximo 20 caracteres).

url_button opcional

Um botão que abre uma ligação: objeto com display_text (texto do botão, máximo 20 caracteres) e url (apenas http ou https). Requer message; não se combina com buttons.

Precisa de ajuda com a integração? info@sendapp.live

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"
  }'

# Texto + botão que abre uma ligação
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 nosso catálogo",
    "url_button": {
      "display_text": "Ver catálogo",
      "url": "https://esempio.com/catalogo"
    }
  }'

<?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

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

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