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: o índice, com um link para cada página em Markdown.
- 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: cada chamada, campo, escopo, erro e exemplo.
x-webhookstraz 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.
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).
Um pedido pronto para colar numa IA
Regras para agentes
- Use uma chave de Teste enquanto desenvolve; produção só depois.
- Mande
Idempotency-Keyem toda criação e envio. - Respeite
Retry-Afternum429. - Nunca mande mensagens para números reais sem o consentimento do contato: marketing pede opt-in.