Skip to main content
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 :
1

Ouvrez Intégrations

Dans Setteo, ouvrez Intégrations, puis l’onglet Automatisations.
2

Créez un token

Dans Clés API, cliquez sur Créer une clé.
3

Copiez le token

Copiez le token affiché dans la modale. Il n’est affiché qu’une seule fois.
Choisissez une expiration de 30 jours, 90 jours ou 180 jours : un token n’est jamais illimité. 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.
1

Créez un token API

Créez un token depuis Intégrations > Automatisations > Clés API.
2

Ouvrez votre scénario Make

Dans Make.com, ouvrez le scénario que vous voulez connecter à Setteo.
3

Installez l'app Setteo

Depuis Connecter Make, ouvrez le lien d’invitation de l’app Setteo.
4

Créez la connexion

Collez votre token API lorsque Make.com vous le demande.
5

Configurez le webhook

Choisissez le trigger webhook et les événements Setteo à écouter.
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.
1

Ajoutez un webhook

Dans Intégrations > Automatisations, cliquez sur Ajouter un webhook.
2

Nommez-le et collez l'URL

Donnez-lui un nom, puis collez l’URL fournie par votre outil d’automatisation.
3

Choisissez les événements

Sélectionnez au moins un événement Setteo à envoyer. Pour prospect.tag_added, vous pouvez limiter l’envoi à certains tags avec Seulement pour ces tags. Laissez le champ vide pour tous les tags.
4

Testez la livraison

Utilisez Envoyer un test pour envoyer un événement webhook.test.
Setteo détecte le provider à partir du domaine de l’URL. Les providers reconnus sont make, zapier, n8n et custom.

​
Événements disponibles

​
Format des événements

Setteo envoie chaque événement en POST, avec un corps JSON :
Chaque requête est signée selon Standard Webhooks : en-têtes webhook-id, webhook-timestamp et webhook-signature (v1, + HMAC-SHA256 en base64 de id.timestamp.corps), avec le secret whsec_… du webhook. Voir Vérifier que la requête vient de Setteo. Le contenu de data dépend de l’événement : prospect suit le schéma Prospect, avec deux listes en plus :
  • tags : les tags du prospect, y compris celui qui vient d’être ajouté pour prospect.tag_added.
  • bookings : les rendez-vous du prospect, triés par date de début. Chaque rendez-vous contient notamment starts_at, ends_at, join_url, reschedule_url, closer_name et is_upcoming.
Le lead de conversation.inactive contient aussi ses tags. message contient id, conversation_id, direction, message, has_link, is_ai_generated et timestamp. new_tag est le libellé du tag ajouté. changed_fields ne contient que les champs modifiés, avec leur nouvelle valeur, parmi first_name, last_name, email, phone, warmth, pipeline_stage, source et optout. Une modification d’un autre champ n’envoie pas de prospect.updated.

​
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. Une réponse 401, 403 ou 410 désactive le webhook. Pour les autres codes de réponse, les nouvelles tentatives et la mise en pause automatique, consultez Webhooks sortants.