Webhooks sortants

Un webhook sortant prévient votre outil à chaque événement choisi. Setteo envoie une requête POST avec un corps JSON à l’adresse que vous indiquez. Utilisez-le pour pousser vos prospects dans un CRM, prévenir votre équipe, ou lancer une automatisation quand un prospect reçoit un tag.

Ajouter un webhook

Ouvrez les automatisations

Dans Configuration > Intégrations, ouvrez l’onglet Automatisations. Seul le Propriétaire y a accès.

Ajoutez un webhook

Dans Webhooks, cliquez sur Ajouter un webhook.

Nommez-le et collez l'adresse

Donnez un Nom pour le retrouver, par exemple « Nouveaux prospects vers Zapier ». Dans URL du webhook, collez l’adresse de réception fournie par votre outil.

Choisissez les événements

Cochez les Événements à envoyer.

Testez

Cliquez sur Envoyer un test. Votre outil reçoit un événement de test, qui ne compte pas dans les statistiques du webhook.

La fenêtre Ajouter un webhook avec le nom, l'URL et les événements

Les Propriétaires reçoivent un e-mail de sécurité à chaque webhook ajouté.

Vous utilisez Make ? L’application Setteo crée son webhook toute seule. Voir Make, Zapier et n8n.

Les événements

Événement	Envoyé quand…
Prospect créé (`prospect.created`)	un prospect arrive dans Setteo, quelle que soit sa source
Prospect mis à jour (`prospect.updated`)	son nom, son e-mail, son téléphone, sa chaleur, son étape, sa source ou son désabonnement change
Tag ajouté au prospect (`prospect.tag_added`)	un tag est posé sur le prospect
Message WhatsApp non délivrable (`prospect.wa_undeliverable`)	un message WhatsApp n’a pas pu être remis
Message envoyé (`message.sent`)	un message part vers le prospect
Message reçu (`message.received`)	le prospect écrit
Conversation inactive (`conversation.inactive`)	une conversation s’arrête, avec ses 25 premiers messages

Filtrer par tag

Pour Tag ajouté au prospect, le champ Seulement pour ces tags limite l’envoi à certains tags. Laissez-le vide pour envoyer l’événement quel que soit le tag ajouté.

Un clic sur un lien court n’a pas d’événement propre. Posez un Tag au clic sur le lien court, puis écoutez Tag ajouté au prospect pour ce tag. Voir Liens courts.

Ce que contient un événement

Chaque requête a la même forme :

{
  "event_type": "prospect.tag_added",
  "timestamp": "2026-10-20T10:00:00.000000Z",
  "data": {
    "prospect": {
      "id": 123,
      "first_name": "Jean",
      "variables": { "source_campagne": "webinaire" },
      "tags": ["Webinaire", "Appel réservé"],
      "bookings": [
        { "event_name": "Appel découverte", "starts_at": "2026-10-22T14:00:00+02:00", "closer_name": "Camille" }
      ]
    },
    "new_tag": "Appel réservé"
  }
}

Pour un événement prospect, data.prospect contient ses champs, ses variables, ses tags et ses rendez-vous.
Les rendez-vous sont dans bookings, pas dans variables.
Les champs issus de l’analyse des conversations (profil, maturité, motif de perte…) sont vides si votre formule n’inclut pas l’analyse.

Le format complet de chaque événement est dans la référence des webhooks sortants.

Vérifier que la requête vient de Setteo

Chaque requête est signée selon la norme Standard Webhooks. Votre outil peut ainsi refuser une requête que Setteo n’a pas envoyée. Elle porte trois en-têtes :

En-tête	Contenu
`webhook-id`	L’identifiant de l’envoi. Il reste le même quand Setteo réessaie un envoi : utilisez-le pour écarter un doublon.
`webhook-timestamp`	L’heure de l’envoi, en secondes Unix.
`webhook-signature`	`v1,` suivi de la signature HMAC-SHA256, en base64, de `webhook-id.webhook-timestamp.corps`.

Le secret de signature est propre à chaque webhook. Pour le copier, ouvrez le webhook et dépliez Secret de signature, sous l’URL. Il commence par whsec_. Les bibliothèques Standard Webhooks vérifient la signature pour vous et prennent le secret tel quel :

import { Webhook } from "standardwebhooks";

const webhook = new Webhook(process.env.SETTEO_WEBHOOK_SECRET);

// Passez le corps brut, avant tout JSON.parse : la signature porte sur ces octets exacts.
const event = webhook.verify(rawBody, request.headers);

use StandardWebhooks\Webhook;

$webhook = new Webhook(getenv('SETTEO_WEBHOOK_SECRET'));

// Passez le corps brut, avant tout json_decode : la signature porte sur ces octets exacts.
$event = $webhook->verify(file_get_contents('php://input'), getallheaders());

Si votre outil répond 401 ou 403, Setteo désactive le webhook aussitôt : renvoyer la même requête ne changerait rien. Vérifiez votre code de vérification avec Envoyer un test, qui ne désactive jamais le webhook, puis réactivez-le avec Actif.

Suivre l’état d’un webhook

Chaque webhook affiche son État, son Taux de réussite, ses Envois et son Dernier envoi.

État	Ce que ça veut dire
Fonctionne	Les envois arrivent.
Échecs fréquents	Votre outil répond souvent en erreur. Vérifiez qu’il accepte la requête.
En pause après des échecs	Après une série d’échecs, Setteo arrête d’envoyer pendant environ une heure, puis reprend seul.
Désactivé	Le webhook n’envoie plus rien : vous l’avez coupé, ou votre outil a refusé un envoi (`401`, `403` ou `410`). Réactivez-le avec Actif.
Jamais déclenché	Aucun événement choisi ne s’est encore produit.

Si votre outil répond 401, 403 ou 410 Gone, Setteo désactive le webhook. Il reste désactivé jusqu’à ce que vous le réactiviez.

Modifier ou supprimer

Cliquez sur Modifier pour changer le nom, l’adresse, les événements ou les tags. Supprimer arrête immédiatement l’envoi. C’est irréversible.

Webhook ou API ?

Le webhook prévient en temps réel. Pour lire ou modifier des données à la demande, utilisez l’API.

Bien démarrer

Connecter vos canaux

Créer votre agent

Automatiser avec les scénarios

Passer en live

Gérer et mesurer

Intégrations

Dépannage

Webhooks sortants

Ajouter un webhook

Les événements

Filtrer par tag

Ce que contient un événement

Vérifier que la requête vient de Setteo

Suivre l’état d’un webhook

Modifier ou supprimer

Webhook ou API ?

​Ajouter un webhook

​Les événements

​Filtrer par tag

​Ce que contient un événement

​Vérifier que la requête vient de Setteo

​Suivre l’état d’un webhook

​Modifier ou supprimer

​Webhook ou API ?

Ajouter un webhook

Les événements

Filtrer par tag

Ce que contient un événement

Vérifier que la requête vient de Setteo

Suivre l’état d’un webhook

Modifier ou supprimer

Webhook ou API ?