API REST
Webhooks
Reçois les événements Settyn en temps réel sur ton propre endpoint.
Configurer un webhook
Ajoute l'URL HTTPS de ton endpoint depuis tes paramètres API. Settyn y enverra une requête POST à chaque événement.
Événements
lead.createdeventoptionnelUn nouveau lead est créé.
lead.qualifiedeventoptionnelUn lead atteint le statut qualifié.
appointment.bookedeventoptionnelUn rendez-vous est pris.
conversation.messageeventoptionnelUn message est envoyé ou reçu.
Format du payload
Exemple — appointment.booked
{
"event": "appointment.booked",
"data": {
"leadId": "lead_abc123",
"channel": "instagram",
"scheduledAt": "2026-04-12T15:00:00Z"
},
"sentAt": "2026-04-07T14:30:00Z"
}Vérifier la signature
Chaque requête inclut un header X-Settyn-Signature (HMAC SHA-256 du corps, avec ton secret). Vérifie-le pour t'assurer que la requête vient bien de Settyn.
Réponds en 2xx
Ton endpoint doit répondre rapidement avec un statut 2xx. En cas d'échec, Settyn réessaie avec un backoff.Cette page a-t-elle été utile ?