> ## 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.

# Automations and webhooks

> Connectez Setteo à Make.com, n8n, Zapier ou toute URL webhook personnalisée.

La page **Intégrations** de Setteo regroupe les tokens API et les webhooks sortants. Utilisez-la pour connecter vos outils d'automatisation.

## Tokens API

Les tokens API servent à authentifier vos requêtes REST et les connexions depuis le custom app Make.com.

Pour créer un token :

<Steps>
  <Step title="Ouvrez Intégrations">
    Dans Setteo, ouvrez **Intégrations**.
  </Step>

  <Step title="Créez un token">
    Dans **Jetons API**, cliquez sur **Créer un jeton**.
  </Step>

  <Step title="Copiez le token">
    Copiez le token affiché dans la modale. Il n'est affiché qu'une seule fois.
  </Step>
</Steps>

Vous pouvez choisir une expiration de **Jamais**, **30 jours** ou **90 jours**. Vous pouvez aussi révoquer un token à tout moment depuis la même section.

## Custom app Make.com

Setteo fournit une app Make.com dédiée. Elle utilise un token API Setteo pour créer la connexion.

<Steps>
  <Step title="Créez un token API">
    Créez un token depuis **Intégrations > Jetons API**.
  </Step>

  <Step title="Ouvrez votre scénario Make">
    Dans Make.com, ouvrez le scénario que vous voulez connecter à Setteo.
  </Step>

  <Step title="Installez l'app Setteo">
    Depuis **Connecter Make**, ouvrez le lien d'invitation de l'app Setteo.
  </Step>

  <Step title="Créez la connexion">
    Collez votre token API lorsque Make.com vous le demande.
  </Step>

  <Step title="Configurez le webhook">
    Choisissez le trigger webhook et les événements Setteo à écouter.
  </Step>
</Steps>

Les endpoints utilisés par l'app Make.com sont réservés à cette app et ne sont pas exposés dans la référence publique.

## URL webhook personnalisée

Vous pouvez aussi ajouter une URL webhook fournie par Make, n8n, Zapier ou n'importe quel autre outil.

<Steps>
  <Step title="Ajoutez un webhook">
    Dans **Intégrations > Automatisations**, cliquez sur **Ajouter un webhook**.
  </Step>

  <Step title="Collez l'URL">
    Collez l'URL fournie par votre outil d'automatisation.
  </Step>

  <Step title="Choisissez les événements">
    Sélectionnez au moins un événement Setteo à envoyer.
  </Step>

  <Step title="Testez la livraison">
    Utilisez **Tester** pour envoyer un événement `webhook.test`.
  </Step>
</Steps>

Setteo détecte le provider à partir du domaine de l'URL. Les providers reconnus sont `make`, `zapier`, `n8n` et `custom`.

## Événements disponibles

| Événement                   | Description                                  |
| --------------------------- | -------------------------------------------- |
| `prospect.created`          | Un prospect a été créé.                      |
| `prospect.updated`          | Un prospect a été mis à jour.                |
| `prospect.tag_added`        | Un tag a été ajouté à un prospect.           |
| `prospect.wa_undeliverable` | Un message WhatsApp n'a pas pu être délivré. |
| `message.sent`              | Un message a été envoyé.                     |
| `message.received`          | Un message a été reçu.                       |
| `conversation.inactive`     | Une conversation est devenue inactive.       |

## Gestion des webhooks

Depuis **Intégrations > Automatisations**, vous pouvez modifier, activer, désactiver, tester ou supprimer chaque webhook. La liste affiche aussi le statut, le taux de réussite et le nombre total de livraisons.