> ## Documentation Index
> Fetch the complete documentation index at: https://docs.setteo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks entrants

> Envoyez des prospects à Setteo depuis votre tunnel, Make, n8n ou tout autre outil, pour les créer, les taguer ou les inscrire dans un scénario.

Un webhook entrant est une adresse que votre outil appelle pour envoyer un prospect à Setteo. Selon l'adresse, Setteo crée ou met à jour le prospect, lui ajoute un tag, ou l'inscrit dans un scénario.

Utilisez-le pour réagir à un événement de votre tunnel : un formulaire rempli, une inscription à un webinaire, un achat.

## Où trouver l'adresse

Chaque tag et chaque scénario a sa propre adresse. Elle commence par `https://webhooks.setteo.io/`.

> [tab] Inscrire dans un scénario
>
> **1. Ouvrez le scénario**
>
> Dans **Scénarios**, ouvrez un scénario WhatsApp, onglet **Parcours**.
>
> **2. Ouvrez le début du scénario**
>
> Cliquez sur le nœud **Début du scénario**. L'adresse s'affiche sous **Par webhook**.
>
> **3. Copiez-la dans votre outil**
>
> Collez-la dans votre outil comme adresse de webhook, en méthode `POST`.
>
> Le scénario doit être **actif** : un scénario en pause refuse l'appel. Voir [Comment fonctionne un scénario](https://docs.setteo.io/scenarios/comment-ca-marche.md).

> [tab] Ajouter un tag
>
> **1. Ouvrez le tag**
>
> Dans **Tags**, ouvrez le tag à poser.
>
> **2. Copiez l'adresse**
>
> Copiez le champ **Webhook url**, section **Webhook**.
>
> **3. Collez-la dans votre outil**
>
> Votre outil l'appelle en méthode `POST` à chaque prospect.
>
> Poser un tag déclenche tout ce qu'il porte : changement d'étape, notification, inscription dans les scénarios actifs qui suivent ce tag. Voir [Tags](https://docs.setteo.io/gerer/tags.md).

![Le nœud Début du scénario avec l'adresse Par webhook](https://mintcdn.com/setteo-397937b0/HWCbcrkIIE1ompbN/images/integrations/webhook-debut-scenario.png?fit=max\&auto=format\&n=HWCbcrkIIE1ompbN\&q=85\&s=1e47e3b213741b50fd52df88c40bf4e6)

> [!WARNING]
>
> L'adresse est le seul secret du webhook : il n'y a pas de clé à ajouter. Traitez-la comme un mot de passe. Si vous dupliquez un scénario, la copie reçoit une nouvelle adresse.

## Ce que votre outil envoie

Votre outil envoie un corps JSON avec au moins un `email`, un `phone` ou un `lead_id`. Vous pouvez y ajouter `first_name`, `last_name`, des `variables` et des `tags`.

```json theme={null}
{
  "first_name": "Jean",
  "email": "jean.dupont@example.com",
  "phone": "+33612345678",
  "variables": { "source_campagne": "webinaire" },
  "tags": ["Webinaire"]
}
```

Setteo lit aussi directement les formats envoyés par ActiveCampaign, GoHighLevel, systeme.io, ClickFunnels, Circle, iClosed et Kajabi.

Le détail des champs, des réponses et des limites est dans la [référence des webhooks entrants](https://docs.setteo.io/api-reference/inbound-webhooks.md).

## Comment Setteo traite le prospect

* **Pas de doublon** : un prospect reçu avec le même téléphone ou le même e-mail qu'un prospect existant met à jour ce prospect. Setteo n'en crée pas un second.
* **E-mail seul** : le téléphone n'est pas obligatoire. Le prospect est retrouvé par e-mail, ou créé.
* **Variables** : celles que vous envoyez remplacent celles de même nom. Les autres restent.
* **Tags** : un tag envoyé qui n'existe pas encore est créé.
* **Numéros** : un numéro sans indicatif est lu avec le pays de votre espace. Envoyez de préférence le numéro complet, au format `+33612345678`.
* **Déjà dans le scénario** : un prospect qui est déjà passé dans ce scénario n'y entre pas une seconde fois.

Pour une campagne WhatsApp, envoyez un numéro de téléphone : sans lui, le prospect ne peut pas recevoir de template.

## Tester l'adresse

Ouvrez l'adresse dans votre navigateur, ou appelez-la en `GET` : elle répond `ready` si elle existe. Cet appel ne crée rien.

Ensuite, envoyez un prospect de test avec votre propre numéro et vérifiez qu'il apparaît dans **Prospects** avec le bon tag, ou dans l'onglet **Prospects** du scénario.

## Ça ne marche pas

> [accordion] Rien n'arrive dans Setteo
>
> * Vérifiez que l'adresse collée dans votre outil est complète et qu'elle correspond au bon tag ou au bon scénario.
> * Vérifiez le déclencheur côté outil : le bon formulaire, le bon quiz, le bon événement.
> * Testez avec un e-mail jamais utilisé : certains outils n'envoient pas deux fois le même contact.

> [accordion] Réponse 404
>
> L'adresse est inconnue, ou le `lead_id` envoyé ne correspond à aucun prospect. Recopiez l'adresse depuis Setteo. N'envoyez `lead_id` que pour un prospect qui existe dans Setteo.

> [accordion] Réponse 422
>
> * **Scénario inactif** : activez le scénario.
> * **Numéro refusé** : le numéro est trop court, sans indicatif alors que le pays de votre espace ne correspond pas, ou avec un indicatif doublé (par exemple `33336…` quand votre outil ajoute `33` à un numéro qui l'a déjà). Envoyez le numéro au format international.
> * **Champ manquant** : il faut au moins un `email`, un `phone` ou un `lead_id`.

> [accordion] Le prospect arrive sans nom ni e-mail
>
> Votre outil envoie peut-être ses valeurs ailleurs que dans les champs attendus. Par exemple, Kajabi place les valeurs de ses formulaires dans `payload`. Dans Make ou n8n, associez ces valeurs aux champs `first_name`, `email` et `phone`.

> [accordion] Le prospect est bien créé mais ne reçoit rien
>
> * Vérifiez que le scénario est actif et que son premier message part d'un template approuvé.
> * Regardez l'onglet **Exécutions** du scénario. Voir [Suivre les exécutions](https://docs.setteo.io/scenarios/suivre-les-executions.md).

Toujours bloqué ? Voir [Prospects en échec dans un scénario](https://docs.setteo.io/depannage/scenario-prospects-en-echec.md), ou contactez le support.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.