Skip to main content
Un webhook entrant permet à un outil externe d’envoyer un prospect à Setteo par une simple requête POST. Selon l’URL appelée, Setteo crée ou met à jour le prospect, lui ajoute un tag ou l’inscrit dans un scénario. Pour recevoir les événements Setteo sur votre serveur, utilisez les webhooks sortants.

​
URLs

Les webhooks entrants sont servis par https://webhooks.setteo.io. Chaque URL accepte deux méthodes :
  • POST envoie un prospect.
  • GET vérifie que l’URL existe, sans rien modifier. La réponse est 200 avec le statut ready.

​
Authentification

Il n’y a pas d’en-tête Authorization : le {token} de l’URL est le seul secret. Traitez l’URL complète comme un mot de passe et ne la partagez pas. Chaque tag et chaque scénario a son propre token :
  • Tag : copiez le champ Webhook url depuis la page du tag.
  • Scénario : ouvrez le nœud Début du scénario. L’URL est affichée sous Par webhook une fois le scénario créé.
Un token inconnu renvoie toujours la même réponse 404, quelle que soit l’URL appelée.

​
Corps de la requête

Envoyez un corps JSON avec l’en-tête Content-Type: application/json. Il faut au moins un email, un phone ou un lead_id. Si vous n’avez qu’un champ de nom, vous pouvez l’envoyer dans name, full_name ou fullName.

​
Règles de traitement

  • Doublons : Setteo cherche d’abord le prospect par lead_id, puis par phone, puis par email. S’il existe, il est mis à jour au lieu d’être dupliqué. Un lead_id inconnu est refusé avec une erreur 404.
  • E-mail seul : le phone n’est pas obligatoire. Sans prospect existant, un nouveau prospect est créé avec l’e-mail.
  • Numéros : un numéro sans indicatif est lu avec la région de votre espace de travail. Un numéro invalide est refusé avec une erreur 422.
  • Variables : elles sont ajoutées à celles du prospect. Leurs clés sont converties en snake_case : les caractères qui ne sont ni des lettres ni des chiffres deviennent _.
  • Tags : un libellé qui n’existe pas encore est créé.

​
Formats d’outils reconnus

Setteo lit aussi directement les payloads envoyés par ces outils, sans mapping de votre part : ActiveCampaign, GoHighLevel, systeme.io, ClickFunnels, Circle, iClosed et Kajabi.

​
Réponses

Toutes les réponses sont en JSON.

​
Limites de taux

Les webhooks entrants sont limités, par défaut, à 480 requêtes par minute et par adresse IP. Au-delà, Setteo répond 429 Too Many Requests.

​
Anciennes URLs

Les anciennes URLs de webhooks entrants continuent de fonctionner, mais ne sont plus la référence. Pour tout nouveau branchement, utilisez les URLs de cette page.