# Para IAs y agentes

Esta documentación está hecha para que una IA la lea y la pruebe, sin cuenta y sin riesgo.

## Dónde leer

- [llms.txt](/es/desarrolladores/llms.txt): el índice, con un enlace a cada página en Markdown.
- [llms-full.txt](/es/desarrolladores/llms-full.txt): toda la documentación en un solo archivo.
- Cada página también existe en Markdown: cambie la barra final de la dirección por `.md` (ej.: `/es/desarrolladores/campanas.md`).
- [OpenAPI](https://api.donetalk.com/v1/openapi.json?lang=es): cada llamada, campo, alcance, error y ejemplo. `x-webhooks` trae los eventos; `x-errors`, los errores; `x-test-mode`, el modo de prueba.

## Probar de verdad, sin riesgo

La empresa `demo` acepta la clave de prueba pública `dt_test_demo_zRZ6twAhj4u9dZT0hEBrNFzr`. Solo simula: verifica las solicitudes con las reglas reales y responde en el formato real, con datos de ejemplo, sin guardar ni enviar nada.

```bash
export DONETALK_KEY=dt_test_demo_zRZ6twAhj4u9dZT0hEBrNFzr
curl https://api.donetalk.com/v1/c/demo/me -H "Authorization: Bearer $DONETALK_KEY"
```

Para ver un error, pídalo con `DoneTalk-Simulate: <código>` ([Modo de prueba](/es/desarrolladores/modo-prueba/)).

## Una instrucción lista para pegar en una IA

> Lee https://donetalk.com/es/desarrolladores/llms-full.txt y, usando la empresa demo con la clave de prueba pública, crea una campaña para dos contactos con un cupón por persona, revísala y envíala. Después muestra cómo mi sistema sabría que un contacto respondió.

## Reglas para agentes

- Use una clave de **Prueba** mientras desarrolla; producción solo después.
- Envíe `Idempotency-Key` en cada creación y envío.
- Respete `Retry-After` en un `429`.
- Nunca envíe mensajes a números reales sin el consentimiento del contacto: el marketing pide opt-in.