Webhooks sortants

L'intégration Webhooks sortants vous permet de suivre l'actualité de votre cercle depuis un outil configuré spécialement pour.

L'intégration des Webhooks sortants à holaSpirit vous permet de générer des appels pour les événements suivants : 

  • Création / Mise à jour d'un projet
  • Création / Mise à jour d'une action
  • Création / Mise à jour / Suppression d'un Rôle et Cercle
  • Création / Mise à jour / Suppression d'une politique
  • Élection dans un rôle : Facilitateur, secrétaire ou second lien

D'autres événements seront ajoutés progressivement. N'hésitez pas à nous suggérer vos idées dans le forum.

Il est par exemple possible d'utiliser les Webhooks sortants avec Zapier, afin d'envoyer les informations vers n'importe quel service supporté par zapier : https://zapier.com/zapbook/webhook/

L'intégration consiste à lier un Cercle sur holaSpirit avec une URL spécifique.

 

Lier un cercle à une URL de Webhook sortant

Pour lier les activités d'un cercle à un Webhook sortant, rendez vous dans les intégrations du cercle et cliquez sur le bouton "Créer un nouveau webhook sortant".

 

 
Entrez l'URL donnée par le service que vous souhaitez utiliser et le channel qui est le nom que vous voulez donner à votre Webhook puis validez.

 

Supprimer le lien entre un cercle et un Webhook sortant

Si vous souhaitez supprimer le lien entre un cercle et un Webhook sortant, il vous suffit de cliquer sur la corbeille à côté du Webhook concerné.

 

Format d'échange (technique)

Un appel en POST, sera effectué à chaque événement.

Les données sont encodées en JSON, avec les structures suivantes :

Projet (création/mise à jour) :

{
'object' : 'project',
'text' : 'Nom du projet',
'circle' : 'id du cercle',
'author_name' : 'Nom de la personne assignée au projet',
'role' : 'Nom du rôle',
'status' : 'current' ou 'waiting' ou 'future' ou 'done',
'url' : 'Lien vers le projet'
}

Action (création/mise à jour) :

{
'object' : 'action',
'text' : 'Nom du action',
'circle' : 'id du cercle',
'author_name' : 'Nom de la personne assignée à l'action',
'role' : 'Nom du rôle',
'status' : 'current' ou 'done'
}
Policy (création/mise à jour/suppression) :
{
'object' : 'policy',
'text' : 'description de l'événement',
'circle' : 'id du cercle',
'url' : 'Lien vers la politique sur holaSpirit'
}

Role/Circle (création/mise à jour/suppression) :

{
'object' : 'role',
'text' : 'description de l'événement',
'purpose' : 'raison d'être',
'circle' : 'id du cercle',
'url' : 'Lien vers le rôle/cercle sur holaSpirit',
* 'domains' : 'Domaines, séparés par des retours à la ligne',
* 'accountabilities' : 'Redevabilités, séparés par des retours à la ligne'
}

* Ces champs ne sont pas renseignés si leur valeur est vide

Election

{
'object' : 'corerole',
'text' : 'description courte de l'événement',
'circle' : 'id du cercle',
'role' : 'nom du rôle',
'until' : 'date de fin au format: 2000-01-01',
'election' : 'description complète de l'événement',
'url' : 'Lien vers le rôle sur holaSpirit'
}

 

Vous avez d’autres questions ? Envoyer une demande
Réalisé par Zendesk