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.