Idempotência

Repetir uma requisição (porque a rede caiu, por exemplo) não pode duplicar contatos, negócios nem mensagens.

Todo POST aceita o cabeçalho Idempotency-Key (1 a 255 caracteres). Use-o sempre ao enviar mensagens (POST /v1/conversations/{id}/messages) e é recomendado em todos os POSTs.
A mesma chave com o mesmo corpo, em até 24 horas, devolve o mesmo resultado sem repetir a ação.
A mesma chave com outro corpo, ou enquanto a primeira ainda está em andamento: 409 idempotency_conflict.
PUT /v1/contacts/by_identifier/{identifier} e PUT /v1/crm/deals/by_external_id/{external_id} são idempotentes por natureza: não precisam do cabeçalho.
No MCP, send_message aceita o argumento idempotency_key.

curl -X POST "https://atende.suporteja.com.br/v1/conversations/1543/messages" \
  -H "Authorization: Bearer $ATENDLLY_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-98765-confirmacao" \
  -d '{"content": "Seu pedido 98765 foi enviado."}'