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é puedes entregarle al asistente
Sección titulada «Qué puedes entregarle al asistente»| 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.
Cada página en Markdown
Sección titulada «Cada página en Markdown»Añade .md al final de la dirección de cualquier página:
https://docs.messajo.com/start/quickstart.mdhttps://docs.messajo.com/en/start/quickstart.mdhttps://docs.messajo.com/es/start/quickstart.mdJunto 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.
OpenAPI
Sección titulada «OpenAPI»El contrato de la API está en JSON, un archivo por idioma:
/openapi.json: en inglés./openapi.pt-BR.json: en portugués./openapi.es.json: en español.
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.
Apuntar el asistente a la documentación
Sección titulada «Apuntar el asistente a la documentación»El camino es el mismo en Claude Code, Cursor y otros asistentes de código:
- En la conversación. Pega la dirección de
llms.txto del.mdde la página y pídele que la lea antes de escribir código. - 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.mdo las reglas del proyecto), y cada sesión empieza con la documentación a mano. - Para formatos exactos. Dale el
openapi.json, o el.mdde 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.Qué ayuda al asistente a depurar
Sección titulada «Qué ayuda al asistente a depurar»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 alcodeen Errores, con su significado y qué hacer.request_id: el mismo valor del encabezadoX-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.
Primera tarea
Sección titulada «Primera tarea»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.