Status webhook — WhatsApp Meta

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

Register (POST) a URL on your server to receive Meta message status events (sent, delivered, read, failed) and inbound events in real time. Each Meta webhook event is forwarded as-is to your URL via HTTP POST. Use DELETE to remove the registered webhook.

Your server must respond with HTTP 200 within 5 seconds. Errors on your endpoint are silently ignored.

SendApp also sends a «message_sent» event for every message sent in the conversation (AI reply, operator, automation, campaign, API), including the text: recognise it by "object": "sendapp". Fields: token, conversation_id, to and message (text, media, sent_by, operator, agents, wamid, status, timestamp). The wamid, when present, links the message to the statuses sent by Meta.

Parameters

3 · 2 required

apikey required

Your API Key.

token required

Account token.

url optional

Your server URL (HTTPS). Not needed for DELETE.

Need help with the integration? info@sendapp.live

Request

# Register the webhook
curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/set_webhook' \
  -H 'Content-Type: application/json' \
  -d '{ "apikey": "YOUR_API_KEY", "token": "YOUR_ACCOUNT_TOKEN", "url": "https://your-server.com/webhook" }'

# Remove the webhook
curl -X DELETE 'https://app.sendapp.ai/api/whatsapp-meta/set_webhook' \
  -H 'Content-Type: application/json' \
  -d '{ "apikey": "YOUR_API_KEY", "token": "YOUR_ACCOUNT_TOKEN" }'

<?php
// Register the webhook
$ch = curl_init('https://app.sendapp.ai/api/whatsapp-meta/set_webhook');
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',
        'url'    => 'https://your-server.com/webhook',
    ]),
]);
echo curl_exec($ch);
curl_close($ch);

// Register the webhook
const res = await fetch('https://app.sendapp.ai/api/whatsapp-meta/set_webhook', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'YOUR_API_KEY',
    token: 'YOUR_ACCOUNT_TOKEN',
    url: 'https://your-server.com/webhook'
  })
});
console.log(await res.json());

Response

{
  "status": "success",
  "message": "Webhook URL saved successfully."
}

{
  "status": "error",
  "message": "Instance not found"
}