Skip to main content
Une clé API permet à un outil de lire et de modifier votre compte Setteo par l’API. Make l’utilise pour se connecter, et vos développeurs l’utilisent pour leurs propres intégrations.
Une clé lit tous les prospects et toutes les conversations du compte, et peut les modifier. Ne la partagez qu’avec les outils qui en ont besoin.

​
Créer une clé

1

Ouvrez les automatisations

Dans Configuration > Intégrations, ouvrez l’onglet Automatisations.
2

Créez la clé

Dans Clés API, cliquez sur Créer une clé. Donnez un Nom qui dit à quoi elle sert, par exemple « Automatisation des prospects ».
3

Choisissez son expiration

Dans Expire dans, choisissez 30, 90 ou 180 jours. Une clé n’est jamais illimitée.
4

Copiez-la tout de suite

Copiez la clé, puis cliquez sur J’ai copié la clé. Elle ne sera plus jamais affichée.
La fenêtre Votre clé API, avec la clé affichée une seule fois
Seul le Propriétaire peut créer une clé. Tous les Propriétaires du compte reçoivent un e-mail de sécurité à chaque création.

​
Suivre et révoquer vos clés

La liste Clés API montre pour chaque clé qui l’a créée, sa dernière utilisation et sa date d’expiration.
  • Révoquer coupe l’accès immédiatement pour tout outil qui utilise la clé. C’est irréversible.
  • Une clé Expirée ne fonctionne plus. Créez-en une nouvelle et remplacez-la dans vos outils.
Créez une clé par outil. Si vous arrêtez un outil, vous révoquez sa clé sans couper les autres.

​
Ce que la clé permet

L’API est à l’adresse https://api.setteo.io/v1. Chaque requête porte la clé dans l’en-tête Authorization: Bearer <clé>. Elle donne accès à :
  • les prospects et leurs tags ;
  • les tags ;
  • les scénarios et les prospects qui y sont inscrits ;
  • les liens courts et leurs statistiques ;
  • les conversations et leurs messages.
La liste des points d’accès, des champs et des erreurs est dans la référence de l’API. L’authentification est détaillée dans Authentification.

​
Webhook ou API ?

  • Pour réagir à un événement en temps réel, utilisez un webhook sortant.
  • Pour envoyer un prospect depuis un formulaire ou un tunnel, utilisez un webhook entrant : pas besoin de clé.
  • Pour lire ou modifier des données à la demande, utilisez l’API.

​
Je ne trouve pas Clés API

Intégrations est réservée au rôle Propriétaire. Si vous êtes Membre, demandez à un Propriétaire de changer votre rôle. Voir Compte et accès.