# Trame

> Trame est un client mail collaboratif : une boîte de réception d’équipe où chaque fil se
> partage, s’assigne, se commente et s’automatise, avec une API publique (REST, webhooks,
> MCP) pour les intégrations et les agents.

Documentation rédigée en français. Les liens ci-dessous sont relatifs à la racine de cette
documentation et pointent vers des pages Markdown consommables telles quelles.

## Documentation

- [Accueil](README.md): Trame est le client mail collaboratif — une boîte mail où une équipe peut assigner, commenter, taguer, automatiser et partager des fils sans jamais quitter la messagerie.

## Using Trame

- [Démarrer avec Trame](using-trame/get-started.md): Trame est une boîte mail collaborative : chaque fil de discussion peut être assigné, commenté, étiqueté et suivi par une équipe entière, sans jamais quitter la messagerie ni utiliser un outil séparé pour se coordonner.
- [Collaboration dans la boîte de réception](using-trame/inbox-collaboration.md): Dans Trame, un fil de discussion ne se lit pas seul : il s'assigne, se commente en interne, se partage et s'étiquette, pour que toute l'équipe sache qui traite quoi.
- [Dicter un brouillon (Smart Dictate)](using-trame/dictee-vocale.md): Parlez, Trame écrit.
- [Boîtes partagées](using-trame/boites-partagees.md): Une boîte partagée regroupe une équipe autour d'une même adresse mail (par exemple contact@ ou support@) : plusieurs personnes reçoivent, traitent et se coordonnent sur les mêmes fils.
- [Règles et automatisations](using-trame/regles-automations.md): Trame peut appliquer des règles automatiques à l'arrivée d'un nouveau mail, selon des conditions que vous définissez, depuis Réglages → Règles & Confidentialité.
- [Contacts, agenda et tâches](using-trame/contacts-agenda-taches.md): Au-delà du mail, Trame gère un carnet de contacts, un agenda et des tâches liées aux fils — accessibles depuis leurs propres pages, et croisés avec vos mails au bon endroit.
- [Centre de demandes et canaux](using-trame/helpdesk-canaux.md): Trame propose un écran Centre de demandes pour traiter des sollicitations sous forme de tickets, au-delà du simple fil de mail : files d'attente, priorité, SLA (le délai maximum de réponse promis à un demandeur — une demande « à risque SLA » est sur le point de dépasser ce délai), et une base de connaissances pour répondre plus vite.
- [Clés d'API, webhooks et approbations](using-trame/cles-api-webhooks.md): Trame peut être relié à un service externe — un outil no-code, un script maison, un agent IA.
- [FAQ](using-trame/faq.md): Questions fréquentes des utilisateurs de Trame.

## Developers

- [Vue d'ensemble](developers/overview.md): L'API Developers de Trame permet de brancher un espace Trame (tenant) à des outils externes : scripts internes, no-code (Zapier/Make/n8n), CRM, ou agents IA.
- [Authentification et scopes](developers/auth-scopes.md): L'API publique s'authentifie par clé API, envoyée dans l'en-tête X-Api-Key (un préfixe Authorization: Bearer <clé> est aussi accepté).
- [Endpoints REST](developers/rest-endpoints.md): <!-- ⚠️ GÉNÉRÉ par scripts/_gen-api-docs.mjs — ne pas éditer à la main.
- [Webhooks](developers/webhooks.md): Trame peut notifier une URL HTTPS externe à chaque événement métier, avec une requête POST signée en HMAC-SHA256.
- [MCP](developers/mcp.md): Trame expose un serveur MCP sur POST /mcp (JSON-RPC 2.0, protocolVersion: 2025-06-18) permettant à un agent IA d'agir sur un tenant avec exactement les mêmes scopes qu'une clé API classique — jamais plus.
- [SDK](developers/sdk.md): Un SDK JS existe : sdk/trame.js, classe Trame.
- [Intégrations Zapier / Make / n8n](developers/integrations-zapier-make-n8n.md): Objectif : brancher Trame à l'écosystème no-code (3000+ apps) via les webhooks sortants (déclencheurs) et l'API REST (actions), sans coder de connecteur dédié par outil — les briques techniques existent déjà (voir Webhooks et Endpoints REST), il manque la couche déclarative propre à chaque plateforme no-code.
- [Description machine (OpenAPI 3.1)](developers/openapi.json): { "openapi": "3.1.0", "info": { "title": "API Trame v1", "version": "1.0.0", "description": "⚠️ GÉNÉRÉ par scripts/_gen-api-docs.mjs — ne pas éditer à la main.
- [llms.txt](developers/llms-txt.md): Trame publie un fichier llms.txt à la racine de cette documentation, au format proposé par la communauté llms.txt : le nom du produit, une description courte, puis la liste des pages disponibles avec un lien relatif et une description d'une phrase.

## Description machine de l’API

- [Description OpenAPI 3.1](developers/openapi.json): définition machine des 37 routes REST publiques — URL de base (préfixe de montage compris), paramètres, statuts de réponse et scope requis par route.
- [Base de l’API](developers/overview.md): toutes les routes s’appellent sous `https://<base-api>/public` — une URL qui omet le segment de montage ne joint pas l’API.