# Boas praticas de integracao

Integre com a IAra de forma previsivel, segura e facil de diagnosticar.

## Token

- Use token de usuario com permissao adequada.
- Nao exponha token em frontend publico.
- Troque o token se houver suspeita de vazamento.
- Use variaveis de ambiente no backend.

## Idempotencia

Guarde IDs externos e IDs retornados pela IAra. Antes de criar contato, conversa ou mensagem, confira se o mesmo evento ja foi processado.

## Retries

Use retry com espera progressiva para falhas temporarias. Nao repita automaticamente erros 400, 401, 403 ou 422 sem corrigir a causa.

## Logs

Registre metodo, rota, status, horario, recurso afetado e `x-request-id`. Nao registre token nem conteudo sensivel de mensagens.

## Homologacao

Teste com poucos contatos e conversas antes de rodar importacoes ou automacoes em volume.

## Limites de escopo

Se a integracao depender de uma configuracao que nao aparece na sua conta, abra demanda com a Digi2B.