Aller au contenu

Utiliser ces docs avec des assistants IA

Ces docs sont écrites pour les humains et pour les assistants IA. Chaque page existe en Markdown, tout le site tient dans un seul fichier, et un assistant peut agir sur ton compte via le serveur MCP.

Ressource Où À quoi ça sert
Index de toutes les pages https://docs.whatsetter.com/llms.txt Donner à un assistant la carte des docs en une requête.
Tout dans un seul fichier https://docs.whatsetter.com/llms-full.txt Coller toute la documentation dans un modèle à grand contexte.
N’importe quelle page en Markdown Ajoute .md au chemin de la page, ou envoie Accept: text/markdown Fournir une page sans le bruit du HTML.
Spec OpenAPI brute https://docs.whatsetter.com/openapi.yaml Générer un client, valider des requêtes, laisser un assistant lire chaque schéma.
Ask AI Le bouton Ask AI dans l’en-tête Poser une question en anglais, français ou espagnol. Il répond à partir de ces docs uniquement, avec ses sources.
Actions de page Copy page, Open in Claude, Open in ChatGPT dans l’en-tête de la page Copier le Markdown, ou ouvrir la page dans ton assistant en un clic.
Serveur MCP https://mcp.whatsetter.com/mcp Laisser l’assistant agir sur ton compte : leads, campagnes, contacts bloqués. Voir Serveur MCP.

Les URL Markdown suivent la structure du site, dans chaque langue :

https://docs.whatsetter.com/developers/quickstart.md
https://docs.whatsetter.com/developers/errors.md
https://docs.whatsetter.com/fr/dashboard/leads.md
https://docs.whatsetter.com/es/developers/webhooks.md
Terminal window
curl -H "Accept: text/markdown" https://docs.whatsetter.com/fr/developers/authentication/

Mets ce bloc dans le fichier que ton assistant lit au début de chaque session : CLAUDE.md pour Claude Code, un fichier de règles pour Cursor, AGENTS.md pour Codex.

## WhatSetter API
Before using the WhatSetter API, read https://docs.whatsetter.com/llms.txt
and the guide of the resource you need
(for example https://docs.whatsetter.com/developers/guides/leads.md).
- Base URL: https://app.whatsetter.com/api/v1
- The API key is in the WHATSETTER_API_KEY environment variable.
Never write it in code, in a config file or in a commit.
- Every error is { "error": { "code", "message" } }.
The codes are listed at https://docs.whatsetter.com/developers/errors.md
- Always send an Idempotency-Key header on POST /messages.
- Never send a WhatsApp message or add a lead to a campaign without asking me first.

L’assistant va alors chercher la page exacte dont il a besoin au lieu de deviner les noms de champs.

Trois façons, de la plus rapide à la plus complète :

  1. Clique sur Open in Claude ou Open in ChatGPT dans l’en-tête de la page que tu lis.
  2. Clique sur Copy page et colle le Markdown dans la conversation.
  3. Donne à l’assistant l’URL .md de la page, par exemple https://docs.whatsetter.com/developers/webhooks.md, et laisse-le la récupérer.

Pour une question qui couvre plusieurs pages, donne https://docs.whatsetter.com/llms-full.txt une fois pour toutes.

Laisser Claude Code construire une intégration de bout en bout

Section intitulée « Laisser Claude Code construire une intégration de bout en bout »
  1. Crée une clé dans Paramètres, puis API & MCP, avec les scopes dont l’intégration a besoin. Exporte-la : export WHATSETTER_API_KEY="ws_live_…".
  2. Ajoute le bloc ci-dessus au CLAUDE.md de ton projet.
  3. Si tu veux, connecte le serveur MCP pour que Claude Code vérifie le résultat sur ton vrai espace : claude mcp add --transport http whatsetter https://mcp.whatsetter.com/mcp.
  4. Décris l’intégration. Par exemple : « Synchronise chaque lead qualifié par WhatSetter dans notre CRM HubSpot. Abonne-toi au webhook contact.qualified, vérifie la signature et fais la correspondance sur external_reference. »
  5. Demande à Claude Code de tester d’abord avec GET /me, puis avec des lectures, avant tout appel qui envoie un message.