O que você será capaz de fazer
- Você criará integrações idempotentes que não duplicam efeitos em caso de repetição.
- Localizar a função em Plugins → Webhooks ou Integração API.
- Reconhecer erros comuns antes de afetar clientes.
- Aplicar uma rotina de teste e conferência.
Entenda antes de clicar
Webhook
Notifica um endereço externo quando um evento ocorre. O destino deve ser HTTPS e responder dentro do tempo esperado.
Autenticação
Use segredo ou token no local apropriado. Nunca inclua credencial em URL pública, captura de tela ou mensagem.
Repetição segura
Filas podem tentar novamente. O sistema receptor deve reconhecer identificadores e não cobrar ou criar duas vezes.
Passo a passo no ChatVox
Siga a sequência no ambiente da sua empresa. Se a tela mostrar uma situação diferente, pare e confira conexão, permissão e plano antes de repetir a ação.
- Defina o evento necessário.
- Prepare endpoint HTTPS de teste.
- Configure autenticação sem expor segredo.
- Envie teste e registre o identificador.
- Repita o mesmo evento para validar idempotência.
Dicas e erros que você deve evitar
- Responda rápido e processe depois.
- Registre falhas sem dados sensíveis.
- Use ambiente de teste.
- Não confie apenas no IP.
- Não execute cobrança duas vezes.
- Não retorne segredo em mensagens de erro.
Antes de usar a função com clientes reais, repita o processo com um contato ou fluxo de teste. Uma configuração tecnicamente salva ainda precisa ser validada no caminho completo: entrada, processamento, registro e resultado visível.
Dúvidas frequentes
Webhook pode repetir?
Sim. O receptor deve ser idempotente.
Posso usar HTTP?
Não em produção; use HTTPS válido.
O que é estado incerto?
Quando não é possível saber se o sistema externo concluiu, evite repetir um efeito não idempotente.
Marque como concluída. O progresso fica salvo somente neste navegador.