Pour les développeurs… et pour tout le mondeFor developers… and everyone elsePara desarrolladores… y para todos

API et connecteur IAAPI and AI connectorAPI y conector IA

Branchez Brilleo à votre assistant IA (Claude, ChatGPT ou toute IA compatible MCP) ou à vos logiciels. Chaque clé appartient à une seule entreprise et ne voit que ses données.Connect Brilleo to your AI assistant (Claude, ChatGPT or any MCP-compatible AI) or to your software. Each key belongs to one company and only sees its data.Conecte Brilleo a su asistente de IA (Claude, ChatGPT o cualquier IA compatible con MCP) o a su software. Cada clave pertenece a una sola empresa y solo ve sus datos.

1. Créer une clé1. Create a key1. Crear una clave

Dans l’app : Paramètres › API et assistant IA › Créer une clé (administrateurs). Deux niveaux : Lire et modifier ou Lecture seulement. La clé (bl_…) n’est affichée qu’une fois ; vous pouvez la révoquer en tout temps.In the app: Settings › API and AI assistant › Create a key (administrators). Two levels: Read and write or Read only. The key (bl_…) is shown only once; you can revoke it anytime.En la app: Configuración › API y asistente IA › Crear una clave (administradores). Dos niveles: Leer y modificar o Solo lectura. La clave (bl_…) se muestra una sola vez; puede revocarla en cualquier momento.

2. Brancher votre IA (MCP)2. Connect your AI (MCP)2. Conectar su IA (MCP)

Adresse du connecteur :Connector address:Dirección del conector:

https://brilleo.app/mcp/bl_VOTRE_CLÉ

Ou https://brilleo.app/mcp avec l’en-tête Authorization: Bearer bl_….Or https://brilleo.app/mcp with the header Authorization: Bearer bl_….O https://brilleo.app/mcp con el encabezado Authorization: Bearer bl_….

Ensuite, demandez simplement : « Quels passages sont en retard ce soir ? », « Montre-moi la preuve du passage d’hier à la Clinique Soleil », « Prévois un grand ménage samedi à la Tour Horizon ». L’IA confirme avec vous avant de modifier quoi que ce soit.Then just ask: “Which visits are late tonight?”, “Show me the proof of yesterday’s visit at the Sun Clinic”, “Book a deep clean Saturday at Horizon Tower”. The AI confirms with you before changing anything.Luego pregunte simplemente: «¿Qué visitas van atrasadas esta noche?», «Muéstrame la prueba de la visita de ayer en la Clínica Sol», «Programa una limpieza profunda el sábado en Torre Horizonte». La IA confirma con usted antes de modificar algo.

OutilToolHerramientaRôleWhat it doesFunción
whoamiEntreprise de la clé, date du jour, nombre de sites, de clients et d’équipes, passages du jour par statut, suivis et demandes ouverts.Company of the key, today’s date, number of sites, clients and teams, today’s visits by status, open follow-ups and requests.Empresa de la clave, fecha de hoy, número de sitios, clientes y equipos, visitas del día por estado, seguimientos y solicitudes abiertos.
list_visitsPassages d’une journée ou d’une période, filtrés par statut, site, client ou équipe, avec le résumé de la preuve.Visits for a day or a period, filtered by status, site, client or team, with the proof summary.Visitas de un día o de un período, filtradas por estado, sitio, cliente o equipo, con el resumen de la prueba.
get_visitPreuve complète d’un passage : GPS d’arrivée et de départ, zones, tâches, photos, problèmes d’accès, lien du rapport.Full proof of a visit: arrival and departure GPS, zones, tasks, photos, access problems, report link.Prueba completa de una visita: GPS de llegada y salida, zonas, tareas, fotos, problemas de acceso, enlace del informe.
list_sitesImmeubles avec client, équipe, horaire, zones, prochain et dernier passage.Buildings with client, team, schedule, zones, next and last visit.Edificios con cliente, equipo, horario, zonas, próxima y última visita.
list_clientsClients avec contact et nombre de sites.Clients with contact and number of sites.Clientes con contacto y número de sitios.
list_teamsÉquipes et sous-traitants : en service ou non, avancement du jour.Teams and subcontractors: on duty or not, today’s progress.Equipos y subcontratistas: en servicio o no, avance del día.
list_issuesSuivis à régler (ouverts, réglés ou tous).Follow-ups to fix (open, resolved or all).Seguimientos por resolver (abiertos, resueltos o todos).
list_requestsDemandes envoyées par les clients depuis leur portail.Requests sent by clients from their portal.Solicitudes enviadas por los clientes desde su portal.
summaryBilan d’une période : passages par statut, taux de preuve, retards, résultats par équipe.Period report: visits by status, proof rate, late arrivals, results by team.Balance de un período: visitas por estado, tasa de prueba, retrasos, resultados por equipo.
create_visitPrévoir un passage ponctuel, un grand ménage ou une inspection.Schedule a one-time visit, a deep clean or an inspection.Programar una visita puntual, una limpieza profunda o una inspección.
reschedule_visitDéplacer un passage prévu, changer l’équipe ou les notes.Move a planned visit, change the team or the notes.Mover una visita prevista, cambiar el equipo o las notas.
cancel_visitAnnuler un passage pas encore commencé.Cancel a visit that has not started.Cancelar una visita que no ha empezado.
create_issueOuvrir un suivi sur un site ou un passage.Open a follow-up on a site or a visit.Abrir un seguimiento en un sitio o una visita.
resolve_issueFermer un suivi, avec une note.Close a follow-up, with a note.Cerrar un seguimiento, con una nota.
send_reportEnvoyer le rapport photo d’un passage terminé au client.Email the photo report of a completed visit to the client.Enviar al cliente el informe con fotos de una visita terminada.

3. API REST3. REST API3. API REST

Base : https://brilleo.app/api/v1. En-tête obligatoire : Authorization: Bearer bl_…. Réponses en JSON, dates au format AAAA-MM-JJ, heure de Montréal.Base: https://brilleo.app/api/v1. Required header: Authorization: Bearer bl_…. JSON responses, dates as YYYY-MM-DD, Montréal time.Base: https://brilleo.app/api/v1. Encabezado obligatorio: Authorization: Bearer bl_…. Respuestas en JSON, fechas AAAA-MM-DD, hora de Montreal.

CheminPathRutaOutilToolHerramienta
GET/mewhoami
GET/visits?date=&from=&to=&status=&site=&client=&team=&limit=list_visits
GET/visits/{id}get_visit
POST/visitscreate_visit
PATCH/visits/{id}reschedule_visit
POST/visits/{id}/cancelcancel_visit
POST/visits/{id}/reportsend_report
GET/sites?q=&client=&include_inactive=list_sites
GET/clients?q=list_clients
GET/teamslist_teams
GET/issues?status=&site=list_issues
POST/issuescreate_issue
POST/issues/{id}/resolveresolve_issue
GET/requests?status=&site=&client=list_requests
GET/summary?from=&to=summary

Statuts des passagesVisit statusesEstados de las visitas : planned, in_progress, completed, missed, no_access, cancelled ; filtres pratiqueshandy filtersfiltros útiles open, done, all. Les sites, clients et équipes se donnent par leur id ou par leur nom (ou une partie).Sites, clients and teams can be given by id or by name (or part of it).Los sitios, clientes y equipos se indican por su id o por su nombre (o parte de él).

Passages d’aujourd’huiToday’s visitsVisitas de hoy

curl https://brilleo.app/api/v1/visits \
  -H "Authorization: Bearer bl_VOTRE_CLÉ"

Prévoir un grand ménageBook a deep cleanProgramar una limpieza profunda

curl -X POST https://brilleo.app/api/v1/visits \
  -H "Authorization: Bearer bl_VOTRE_CLÉ" -H "Content-Type: application/json" \
  -d '{"site": "Tour Horizon", "date": "2026-11-07", "kind": "deep_clean", "notes": "Vitres du hall et cirage"}'

Erreurs et limitesErrors and limitsErrores y límites

Gardez vos clés secrètes : quiconque a l’adresse du connecteur ou la clé voit les données de votre entreprise. Révoquez une clé qui a circulé.Keep your keys secret: anyone with the connector address or the key sees your company’s data. Revoke any key that has been shared.Mantenga sus claves en secreto: quien tenga la dirección del conector o la clave ve los datos de su empresa. Revoque una clave que haya circulado.

Besoin d’aide ?Need help?¿Necesita ayuda?

support@groupeochoainc.com