API do DoneTalk

A API deixa o seu sistema (ERP, CRM, site, automação) fazer no DoneTalk o que se faz na tela: criar e disparar campanhas de WhatsApp, cadastrar e atualizar contatos, mandar mensagens, acompanhar e concluir atendimentos, marcar horários e receber avisos de tudo o que acontece.

Endereço: https://api.donetalk.com/v1/c/{empresa}, onde {empresa} é o identificador da sua empresa no DoneTalk.
Formato: JSON, datas em ISO 8601 (UTC), ids em UUID, valores em dinheiro em micros (1.000.000 = 1 unidade da moeda).
Especificação completa: OpenAPI, para gerar código ou importar no Postman.

Primeiros passos

Um administrador cria a chave em Configurações › API no DoneTalk e marca o que ela pode fazer. Para começar sem risco, escolha Teste: ela simula tudo e não envia nada.
Confira a chave:

curl https://api.donetalk.com/v1/c/{empresa}/me \
  -H "Authorization: Bearer $DONETALK_KEY"

Crie uma campanha com a lista de contatos na própria chamada, revise o custo e dispare. O guia Campanhas, do começo ao fim mostra cada passo.
Cadastre um endereço do seu sistema para receber os avisos: entregue, lida, respondida, atendimento concluído com o desfecho.

Experimente agora, sem conta

A empresa de demonstração demo aceita a chave de teste pública abaixo. Tudo é simulado: as respostas têm o formato real, com dados de exemplo, e nada é gravado ou enviado.

export DONETALK_KEY=dt_test_demo_zRZ6twAhj4u9dZT0hEBrNFzr
curl -X POST https://api.donetalk.com/v1/c/demo/campaigns \
  -H "Authorization: Bearer $DONETALK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Primeira campanha", "audience": {"kind": "contacts", "people": [{"phone": "+5548999990001", "name": "Ana"}]}}'

O que a API cobre

Área	O que dá para fazer
Campanhas	criar, revisar custo e regras, testar, disparar ou agendar, pausar, retomar, cancelar, reenviar falhas, ver cada destinatário e os resultados
Segmentos	grupos de contatos por condições, contar e buscar
Contatos	criar, atualizar ou importar até 1.000 por vez, etiquetas, consentimento, fichas de contexto, apagar a pedido do titular
Campos	ver e criar os campos dos contatos
Modelos	os modelos aprovados pela Meta, com variáveis e botões
Mensagens e atendimentos	mandar um modelo para um telefone, texto e arquivos na janela de 24 h, concluir com desfecho
Números, equipes e etiquetas	para escolher o número que envia e a equipe que recebe as respostas
Agenda	horários livres, marcar, remarcar e cancelar
Avisos	criar e acompanhar os endereços que recebem os eventos

Antes de ir para produção

Use uma chave por sistema, só com os escopos de que ele precisa (Chaves e escopos).
Mande Idempotency-Key em criações e envios e respeite o limite de 600 chamadas por minuto (Erros e limites).
Confira a assinatura de cada aviso (Avisos).

Esta página em Markdown