Clés d’API, webhooks et Zapier
Connectez d’autres outils avec des clés d’API et des webhooks
Avec l’édition Chain, un autre système peut travailler avec votre espace : une clé d’API pour les requêtes vers Setvos, et des webhooks pour les nouvelles qui en sortent. Il n’y a pas encore d’application Zapier ; la recette ci-dessous utilise les étapes webhook que Zapier et Make proposent déjà.
Créez une clé
Ouvrez Intégrations → API et webhooks et, sous Clés d’API, choisissez Nouvelle clé. Nommez-la d’après le système qui l’utilisera et cochez seulement ce dont il a besoin : une clé agit en votre nom et ne peut jamais faire plus que vous. Copiez-la tout de suite — elle n’est affichée qu’une fois et n’est pas conservée.
Envoyez des requêtes
Placez la clé dans l’en-tête Authorization sous la forme « Bearer stv_live_… » et envoyez les requêtes à l’adresse de l’API indiquée sur la même carte. Une clé fait jusqu’à 300 requêtes par minute, et une liste d’adresses sur la clé limite d’où elle peut être utilisée.
Remplacez une clé avant son expiration
Une clé cesse de fonctionner un an après son émission. Remplacez-la sur la carte : la nouvelle garde le nom, la portée et la liste d’adresses, et l’ancienne fonctionne jusqu’à ce que vous la révoquiez, ce qui permet de basculer d’abord l’autre système.
Abonnez-vous à des événements
Dans Webhooks, choisissez Nouveau webhook, collez l’adresse qui recevra les événements et cochez-les : un contact ajouté ou modifié, une affaire déplacée vers une autre étape ou gagnée, une facture payée, un rendez-vous pris ou annulé, une commande payée. Chaque envoi est un POST avec le nom de l’événement dans X-Setvos-Event et une signature dans X-Setvos-Signature : sha256= suivi du HMAC du corps, calculé avec le secret de signature affiché à la création du webhook.
Créez un scénario dans Zapier ou Make
Dans Zapier, démarrez un Zap avec Webhooks by Zapier → Catch Hook ; dans Make, un scénario avec Webhooks → Custom webhook. Collez l’adresse obtenue dans un nouveau webhook ici, cliquez sur Envoyer un test et associez les champs. Pour agir dans Setvos depuis un scénario, utilisez Webhooks by Zapier → Custom Request ou le module HTTP de Make, avec votre clé dans l’en-tête Authorization.
Questions fréquentes
- Quelle édition inclut les clés d’API ?
- Chain. Un espace qui quitte Chain garde ses clés, mais elles cessent de fonctionner le jour même.
- Que se passe-t-il quand un envoi échoue ?
- Il est retenté — six tentatives au total, réparties sur presque une journée. La carte du webhook liste les envois récents, et un webhook qui échoue vingt fois de suite est mis en pause jusqu’à ce que vous le relanciez.
- Existe-t-il une application Setvos dans l’annuaire Zapier ?
- Pas encore. Les étapes Catch Hook et Custom Request ci-dessus font la même chose aujourd’hui.
Où cela se trouve dans le produit
À lire ensuite
Espace de travail et profil : comment votre entreprise est configurée
Les paramètres qui façonnent tout l’espace de travail — informations sur l’entreprise, modules, champs personnalisés, IA et journal d’activité — et votre propre profil.
Contacts : vos clients et les entreprises pour lesquelles ils travaillent
Tenez une fiche par client avec son historique, ses notes, ses étiquettes et ses fichiers, retrouvez n’importe qui en quelques secondes et gardez la liste sans doublons.
Factures : facturez vos clients et voyez qui vous doit de l’argent
À quoi servent les écrans de facturation, comment une facture passe du brouillon au paiement, et ce qu’il faut configurer avant d’envoyer la première.
Sortez vos réservations du papier, de WhatsApp et de trois tableurs.
Importez votre fichier clientes, vos prestations et vos visites passées depuis un tableur ou l’export de votre ancien système, avec un aperçu avant que rien ne soit enregistré — et de l’aide par chat, en six langues, dès que vous le souhaitez. La plupart des studios tournent le jour même.