Ir al contenido

Empezar

Construir con IA

Cómo darle a Claude Code, Cursor o ChatGPT el contexto correcto de la documentación de Messajo, con llms.txt, Markdown por página y OpenAPI.

Un asistente de código acierta más cuando lee la documentación real en lugar de adivinar la API. Messajo publica la documentación en formatos pensados para eso.

Qué Dónde Para qué
Índice de la documentación https://docs.messajo.com/llms.txt Índice corto: descripción de la API y enlaces a la documentación completa, la resumida y OpenAPI. Para leer una sola página, usa su .md
Documentación completa https://docs.messajo.com/llms-full.txt Todo en un solo archivo, para un contexto grande
Documentación resumida https://docs.messajo.com/llms-small.txt Versión abreviada, para un contexto pequeño
Una página <url de la página>.md La página en Markdown puro
OpenAPI /openapi.es.json El contrato exacto de cada ruta, cuerpo y error

Los archivos llms*.txt se generan solo a partir de las páginas en portugués. Los .md por página existen en todos los idiomas.

Añade .md al final de la dirección de cualquier página:

https://docs.messajo.com/start/quickstart.md
https://docs.messajo.com/en/start/quickstart.md
https://docs.messajo.com/es/start/quickstart.md

Junto al título de cada página hay un control Copiar página. Copia el Markdown de la página al portapapeles y su menú ofrece Ver como Markdown, Abrir en ChatGPT y Abrir en Claude. Los dos últimos abren el asistente con la petición de leer esa página.

El contrato de la API está en JSON, un archivo por idioma:

La referencia interactiva se genera del mismo archivo, y los tipos del SDK de TypeScript también. Entrega el OpenAPI cuando el asistente necesite el formato exacto de un cuerpo de petición.

El camino es el mismo en Claude Code, Cursor y otros asistentes de código:

  1. En la conversación. Pega la dirección de llms.txt o del .md de la página y pídele que la lea antes de escribir código.
  2. En el archivo de instrucciones del proyecto. Escribe la dirección una vez en el archivo que tu asistente lee al inicio de cada sesión (como CLAUDE.md o las reglas del proyecto), y cada sesión empieza con la documentación a mano.
  3. Para formatos exactos. Dale el openapi.json, o el .md de la página de la ruta en cuestión, en lugar de pedirle al asistente que lo recuerde.

Ejemplo de fragmento para el archivo de instrucciones:

API de Messajo (WhatsApp, Instagram y Messenger oficiales):
- Índice de la documentación: https://docs.messajo.com/llms.txt
- Contrato de la API: https://docs.messajo.com/openapi.json
- Antes de escribir código que llame a la API, lee la página .md de la ruta.
- Usa el SDK @messajo/sdk; nunca inventes campos fuera del OpenAPI.

Todo error de la API tiene el mismo cuerpo, con tres campos útiles para quien depura (consulta Formato del error):

  • code: identificador estable, seguro para tratar en el código.
  • docs_url: enlace al code en Errores, con su significado y qué hacer.
  • request_id: el mismo valor del encabezado X-Request-Id (consulta X-Request-Id para soporte).

Pega el cuerpo completo del error en el asistente: el docs_url lleva a la explicación correcta.

Un buen primer pedido, con el llms.txt ya en la conversación:

Lee https://docs.messajo.com/es/send/text.md y https://docs.messajo.com/es/webhooks/verify-signature.md.
Luego, con @messajo/sdk:
1. envía un texto a 5511999999999 usando la clave de MESSAJO_API_KEY;
2. crea un endpoint que reciba webhooks y verifique el encabezado Messajo-Signature
antes de tratar el evento.
Si algún campo no está en la documentación, pregunta en lugar de inventarlo.

Páginas de apoyo: Enviar texto y Verificar la firma.