# Para IAs e agentes

Esta documentação foi feita para ser lida e testada por uma IA, sem conta e sem risco.

## Onde ler

- [llms.txt](/desenvolvedores/llms.txt): o índice, com um link para cada página em Markdown.
- [llms-full.txt](/desenvolvedores/llms-full.txt): toda a documentação num arquivo só.
- Cada página também existe em Markdown: troque a barra final do endereço por `.md` (ex.: `/desenvolvedores/campanhas.md`).
- [OpenAPI](https://api.donetalk.com/v1/openapi.json?lang=pt): cada chamada, campo, escopo, erro e exemplo. `x-webhooks` traz os eventos; `x-errors`, os erros; `x-test-mode`, o modo teste.

## Testar de verdade, sem risco

A empresa `demo` aceita a chave de teste pública `dt_test_demo_zRZ6twAhj4u9dZT0hEBrNFzr`. Ela só simula: confere os pedidos com as regras reais e responde no formato real, com dados de exemplo, sem gravar nem 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 um erro, peça com `DoneTalk-Simulate: <código>` ([Modo teste](/desenvolvedores/modo-teste/)).

## Um pedido pronto para colar numa IA

> Leia https://donetalk.com/desenvolvedores/llms-full.txt e, usando a empresa demo com a chave de teste pública, crie uma campanha para dois contatos com um cupom por pessoa, revise e dispare. Depois mostre como meu sistema saberia que um contato respondeu.

## Regras para agentes

- Use uma chave de **Teste** enquanto desenvolve; produção só depois.
- Mande `Idempotency-Key` em toda criação e envio.
- Respeite `Retry-After` num `429`.
- Nunca mande mensagens para números reais sem o consentimento do contato: marketing pede opt-in.