Module 22
API et intégrations
Une API REST documentée, des webhooks et des connecteurs pour relier Vigyl à vos outils, et des imports pour migrer depuis un autre logiciel de télésurveillance.
Le problème que ce module résout
Un logiciel de télésurveillance ne vit pas seul. Il doit échanger avec le standard téléphonique, l’outil de ticketing des techniciens, la comptabilité, le CRM commercial, et parfois avec les logiciels des clients eux-mêmes. Sans interfaces, ces échanges passent par des exports manuels et de la ressaisie.
Changer de logiciel pose un autre problème : reprendre des milliers de fiches, de contacts et de consignes sans erreur.
Le module API et intégrations ouvre Vigyl aux autres outils du centre et prépare la migration.
Comment ça marche
- Une application est déclarée. Avec ses identifiants et les droits dont elle a besoin.
- Elle interroge l’API. Pour lire ou écrire des sites, des contacts, des événements.
- Elle reçoit les webhooks. Dès qu’un événement la concernant se produit dans Vigyl.
- Les connecteurs prennent le relais. Pour les outils courants, sans développement spécifique.
- Chaque appel est journalisé. Pour la sécurité et le diagnostic.
Migrer depuis un autre logiciel
La migration est préparée avec le centre : inventaire des données à reprendre, table de correspondance des codes et des consignes, import de test, vérification, puis bascule. Les données importées sont contrôlées avant la mise en production.
Cas d’usage courants
- Standard téléphonique : remonter les appels entrants dans Vigyl pour ouvrir automatiquement la fiche du site, et journaliser les appels passés depuis un poste physique.
- Outil de ticketing : transmettre les défauts techniques détectés par la supervision à l’outil utilisé par les techniciens, et récupérer leur statut de résolution.
- Comptabilité : exporter les écritures préparées par le module Facturation vers le logiciel comptable.
- CRM commercial : créer un client et ses sites dans Vigyl à la signature du contrat, sans ressaisie.
- Logiciels métier des clients : pour de grands comptes, envoyer les événements de leurs sites vers leur propre outil de pilotage.
Bonnes pratiques d’intégration
Chaque application raccordée dispose de ses propres identifiants et de droits limités à ce dont elle a besoin : un outil de ticketing n’a pas accès aux mots de passe des interlocuteurs, un CRM ne lit pas les preuves vidéo. Les appels à l’API sont journalisés, et un identifiant peut être révoqué à tout moment sans affecter les autres intégrations.
Les webhooks sont signés, pour que l’outil destinataire puisse vérifier qu’ils proviennent bien de Vigyl, et ils sont renvoyés en cas d’échec temporaire du destinataire. [À COMPLÉTER : mécanisme de signature et politique de renvoi] L’environnement de test permet aux intégrateurs de développer et de valider leurs connecteurs sans toucher aux données de production.
Fonctionnalités
API REST
Accès documenté aux sites, événements, incidents, main courante et rapports, selon les droits de chaque application.
Webhooks sortants
Notification de vos outils lors de la création d’un incident, d’une décision, d’un ordre de mission ou d’une clôture.
Connecteurs
Standards téléphoniques, outils de ticketing, logiciels de comptabilité et CRM. [À COMPLÉTER : connecteurs disponibles]
Import et export
Import et export des sites, contacts, consignes et historiques en formats ouverts.
Migration
Reprise des données depuis un autre logiciel de télésurveillance, avec une table de correspondance établie avec le centre.
SDK et environnement de test
Kits de développement et environnement de test isolé pour les intégrateurs.
Ce que le module apporte
Vigyl s’insère dans votre système d’information
Téléphonie, ticketing, comptabilité et CRM échangent avec Vigyl sans double saisie.
Une migration préparée
Les données d’un autre logiciel de télésurveillance s’importent, pour reprendre un portefeuille sans tout ressaisir.
Des intégrateurs autonomes
Documentation, SDK et environnement de test permettent aux intégrateurs de développer leurs connecteurs.
Des événements poussés en temps réel
Les webhooks préviennent vos outils dès qu’un événement se produit dans Vigyl.
Questions fréquentes
L’API permet-elle de déclencher une action sur un incident ?
La documentation de l’API est-elle publique ?
Peut-on migrer depuis notre logiciel actuel ?
Comment sont sécurisés les accès à l’API ?
Modules liés
- Statut : En développement
Module 01
Réception multi-protocole
Toutes les alarmes de vos sites arrivent dans une seule file, quel que soit le transmetteur, le protocole ou le fabricant, normalisées et horodatées à la milliseconde.
- Statut : En développement
Module 07
Consignes et fiches sites
Une fiche complète par site et des consignes qui s’adaptent à l’heure, au jour, au type d’événement et à l’état du site, pour que chaque alarme soit traitée selon les règles du client.
- Statut : En développement
Module 18
Portail partenaires et installateurs
L’espace des installateurs et intégrateurs pour créer les sites, activer les licences, mettre en service les équipements et suivre leur parc.
Voir ce module en situation
Démonstration sur rendez-vous, sur vos propres scénarios. Tarif sur devis.