# 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

| Qué | Dónde | Para qué |
| --- | --- | --- |
| Índice de la documentación | [`https://docs.messajo.com/llms.txt`](/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`](/llms-full.txt) | Todo en un solo archivo, para un contexto grande |
| Documentación resumida | [`https://docs.messajo.com/llms-small.txt`](/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`](/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

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

```text
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.

## OpenAPI

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

- [`/openapi.json`](/openapi.json): en inglés.
- [`/openapi.pt-BR.json`](/openapi.pt-BR.json): en portugués.
- [`/openapi.es.json`](/openapi.es.json): en español.

La [referencia interactiva](/es/reference) se genera del mismo archivo, y los tipos del [SDK de TypeScript](/es/sdk/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

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:

```text
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

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

- `code`: identificador estable, seguro para tratar en el código.
- `docs_url`: enlace al `code` en [Errores](/es/errors/), con su significado y qué hacer.
- `request_id`: el mismo valor del encabezado `X-Request-Id` (consulta [X-Request-Id para soporte](/es/api/authentication/#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

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

```text
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](/es/send/text/) y [Verificar la firma](/es/webhooks/verify-signature/).
