Webhook de statut — SMS

POSThttps://app.sendapp.ai/api/sms/set_webhook

Enregistrez (POST) une URL sur votre serveur pour recevoir les événements SMS en temps réel (sms_received, device.disconnected, device.reconnected, device.deleted). Chaque événement est transféré à votre URL via HTTP POST. Utilisez DELETE pour supprimer le webhook.

Votre serveur doit répondre avec un HTTP 200 dans les 5 secondes. Les erreurs sur votre endpoint sont ignorées silencieusement.

Paramètres

apikey obligatoire

Votre API Key.

token obligatoire

Token du compte.

url facultatif

L'URL de votre serveur (HTTPS). Non nécessaire pour DELETE.

Requête

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

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

<?php
$ch = curl_init('https://app.sendapp.ai/api/sms/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/sms-webhook',
    ]),
]);
echo curl_exec($ch);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/sms/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/sms-webhook'
  })
});
console.log(await res.json());

Réponse (200 OK)

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

Erreur

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