Aller au contenu
FPlateformeStatut : En développement

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.

API · événement entrant03:47:28POST /v1/evenements{  "site": "0412",  "zone": "Z4",  "type": "intrusion",  "horodatage": "2026-09-26T03:47:12.418Z",  "source": "passerelle-video"}→ 202 Accepted · incident INC-0347
Illustration d’interface · données fictives

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

  1. Une application est déclarée. Avec ses identifiants et les droits dont elle a besoin.
  2. Elle interroge l’API. Pour lire ou écrire des sites, des contacts, des événements.
  3. Elle reçoit les webhooks. Dès qu’un événement la concernant se produit dans Vigyl.
  4. Les connecteurs prennent le relais. Pour les outils courants, sans développement spécifique.
  5. 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 ?
L’API permet d’échanger des données et de créer des événements. Les décisions sur un incident restent prises par un opérateur dans la console.
La documentation de l’API est-elle publique ?
[À COMPLÉTER : modalités d’accès à la documentation]
Peut-on migrer depuis notre logiciel actuel ?
Oui, par import des sites, contacts, consignes et historiques. Le périmètre et les correspondances sont établis avec le centre lors du projet.
Comment sont sécurisés les accès à l’API ?
Par des identifiants propres à chaque application, avec des droits limités à ce dont elle a besoin, et une journalisation des appels.

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.

Demander une démo