Iscrizioni webhook — WhatsApp Meta

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

Iscrive (POST) un altro indirizzo agli stessi eventi del webhook di stato: messaggi in arrivo, stati di Meta e «message_sent». Serve agli strumenti che si collegano da soli, come il nodo SendApp Trigger di n8n, senza togliere l'indirizzo registrato con set_webhook. GET elenca le iscrizioni, DELETE /api/whatsapp-meta/webhooks/{id} ne toglie una.

Fino a 10 iscrizioni per numero WhatsApp. Lo stesso indirizzo iscritto di nuovo restituisce la stessa iscrizione.

Parametri

4 · 3 obbligatori

apikey obbligatorio

La tua API Key.

token obbligatorio

Token dell'account.

url obbligatorio

L'indirizzo che riceve gli eventi (https o http). Solo per la POST.

label opzionale

Un nome per riconoscere l'iscrizione, per esempio «n8n». Solo per la POST.

Serve aiuto con l'integrazione? info@sendapp.live

Richiesta

# Iscrivi un indirizzo
curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/webhooks' \
  -H 'X-API-Key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{ "token": "YOUR_ACCOUNT_TOKEN", "url": "https://your-server.com/webhook", "label": "n8n" }'

# Elenco delle iscrizioni
curl 'https://app.sendapp.ai/api/whatsapp-meta/webhooks?token=YOUR_ACCOUNT_TOKEN' -H 'X-API-Key: YOUR_API_KEY'

# Togli l'iscrizione
curl -X DELETE 'https://app.sendapp.ai/api/whatsapp-meta/webhooks/wh_xxxxxxxxxxxxxxxxxxxx?token=YOUR_ACCOUNT_TOKEN' -H 'X-API-Key: YOUR_API_KEY'

<?php
// Iscrivi un indirizzo
$ch = curl_init('https://app.sendapp.ai/api/whatsapp-meta/webhooks');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'token' => 'YOUR_ACCOUNT_TOKEN',
        'url'   => 'https://your-server.com/webhook',
        'label' => 'n8n',
    ]),
]);
echo curl_exec($ch);
curl_close($ch);

// Iscrivi un indirizzo
const res = await fetch('https://app.sendapp.ai/api/whatsapp-meta/webhooks', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ token: 'YOUR_ACCOUNT_TOKEN', url: 'https://your-server.com/webhook', label: 'n8n' })
});
console.log(await res.json());

Risposta

{
  "status": "success",
  "webhook": {
    "id": "wh_k2m9x0q7c1v8b3n6z5a4",
    "url": "https://your-server.com/webhook",
    "label": "n8n",
    "created_at": "2026-10-28T12:30:18+00:00"
  }
}

{
  "status": "error",
  "message": "This WhatsApp number already has 10 webhook subscriptions: remove one first."
}