Vigilo et Open311

Vigilo est compatible Open311

À partir de la version 0.0.22 du back-end, une instance Vigilo peut transmettre automatiquement chaque observation publiée à l’outil de gestion des signalements d’une collectivité, dès lors que cet outil est compatible Open311. L’observation devient une demande d’intervention dans le logiciel du service concerné (voirie, propreté, police municipale…), sans ressaisie.

Open311, qu’est-ce que c’est ?

Open311 est un standard ouvert pour signaler les problèmes de l’espace public : nid-de-poule, éclairage en panne, dépôt sauvage, stationnement gênant… Son nom vient du « 311 », le numéro des services municipaux non urgents aux États-Unis.

Sa spécification, GeoReport v2, définit une API commune à tous les outils de signalement :

• les services (services) : les types de demandes que la collectivité accepte, chacun avec un code ;
• les demandes (requests) : un signalement, avec sa position, son adresse, sa description, une photo et un numéro de suivi ;
• le suivi : l’état de chaque demande (ouverte, fermée) et la réponse du service.

Une application compatible peut donc envoyer ses signalements à n’importe quelle collectivité compatible, sans développement spécifique. Open311 est utilisé par de nombreuses villes, en Amérique du Nord comme en Europe, et par des outils de signalement comme FixMyStreet.

Comment Vigilo l’utilise

1. Un citoyen ajoute une observation dans Vigilo.
2. Les modérateurs de l’association locale la valident ; visages et plaques d’immatriculation sont floutés.
3. À la publication, l’instance envoie une demande Open311 (POST requests) à l’outil de la collectivité, avec :
   • la position et l’adresse ;
   • la catégorie, le commentaire et l’explication ;
   • la photo (lien media_url) ;
   • l’identifiant de l’observation Vigilo.
4. La collectivité traite la demande dans son propre outil, avec son numéro de suivi.

L’envoi passe par les webhooks du panneau d’administration de l’instance. La configuration prête à l’emploi est dans la documentation des webhooks.

Mettre en place la transmission

Collectivité : fournir à l’association qui gère l’instance Vigilo de votre territoire :

• l’adresse de votre API Open311 ;
• une clé d’API (api_key) ;
• le code du service destinataire (service_code) de chaque type de signalement.

Association : dans le panneau d’administration de l’instance, menu Webhooks, ajouter un webhook Open311 avec ces informations, saisir dans Correspondance des catégories le code de service de chaque catégorie Vigilo, puis Enregistrer et tester.

Le contact de chaque association est sur la page Les villes. Votre territoire n’a pas encore d’instance Vigilo ? Voir Votre ville ici.

Bon à savoir

• La transmission va de Vigilo vers la collectivité. L’état d’avancement de la demande dans l’outil de la collectivité ne remonte pas automatiquement dans Vigilo : l’association ou les comptes « services municipaux » de l’instance le mettent à jour.
• Depuis la version 0.0.23, chaque catégorie Vigilo est envoyée au service de la collectivité qui lui correspond (service_code), et l’instance peut ne transmettre que les catégories qui ont un code (par exemple le seul stationnement gênant). La répartition par commune se fait côté collectivité, ou avec un outil d’automatisation.
• Seules les observations validées par les modérateurs sont transmises.
• Les observations restent par ailleurs disponibles en données ouvertes (API Vigilo, JSON, GeoJSON, CSV).