Send WhatsApp text (Meta)

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

Send a free-text message through Meta's WhatsApp Cloud API (type=freetext). You can attach a media file, add up to 3 quick-reply buttons, or add one button that opens a link.

24-hour window: free-text messages can only be sent within 24 hours of the customer's last message. Outside this window you must use an approved template.

A message can carry either up to 3 quick-reply buttons (buttons) or one link button (url_button): WhatsApp does not allow both together. With url_button, any media becomes the message header (image, video or document, not audio).

Parameters

12 · 4 required

apikey required

Your API Key.

token required

Account token.

number required

Recipient number in international format without + (e.g. 1234567890).

type required

Must be freetext.

message optional

Message text (or caption if you attach a media file). Required if you do not pass a media file.

media_url optional

Public URL of the file to attach.

media_type optional

Media type: image, video, audio or document. Required if you pass media_url.

file_name optional

File name (only for documents).

header optional

Header text, max 60 characters (for messages with buttons).

footer optional

Footer text, max 60 characters (for messages with buttons).

buttons optional

Array of quick-reply buttons, max 3. Each button has an id and a title (max 20 characters).

url_button optional

A button that opens a link: an object with display_text (button label, max 20 characters) and url (http or https only). Requires message; cannot be combined with buttons.

Need help with the integration? info@sendapp.live

Request

# Plain text
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": "Hi! Thanks for reaching out to us."
  }'

# Text + 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": "Here's your coupon!",
    "media_url": "https://esempio.com/coupon.jpg",
    "media_type": "image"
  }'

# Text + button that opens a link
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": "Here is our catalog",
    "url_button": {
      "display_text": "View catalog",
      "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' => 'Hi! Thanks for reaching out to us.',
    ]),
]);
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: 'Hi! Thanks for reaching out to us.'
  })
});
console.log(await res.json());

Response

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

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