🧠 Introdução

As requisições HTTP permitem conectar seu bot com serviços externos como CRMs, sistemas internos ou plataformas como Zapier. Porém, uma má configuração pode fazer com que esses dados nunca cheguem ao destino… e sem aviso!

Este artigo ajudará você a identificar e resolver os erros mais comuns ao usar este componente.

🧨 Erros frequentes ao usar o componente HTTP

🔗 Dupla inclusão de URLs: Ocorre quando se concatena duas vezes o endereço (ex. https://https://hooks.zapier.../). Como prevenir: Revise que a URL não tenha duplicações ao copiar/colar. Sempre deve começar com um único https://.
❌ URL inválida ou mal copiada: O fluxo não envia nada, nem sequer exibe erro. Como prevenir: Cole a URL em seu navegador para validar o formato ou use ferramentas como Postman.
🛑 O componente HTTP não é ativado: O usuário nunca chega àquela parte do fluxo porque as condições anteriores não são atendidas. Como prevenir: Revise a lógica do design do fluxo e simule uma conversa para garantir que a rota se ative.
🔇 Erro silencioso no Zapier: O Zapier não registra a entrada, mas também não exibe um erro visível no Atom. Como prevenir: Verifique se o webhook está bem configurado revisando os requests recebidos no histórico de tarefas do Zapier.

🧪 O que fazer se a informação não chegou ao Zapier?

Se você tiver dúvidas sobre por que a conexão falhou, siga estes passos:

📤 Revise a URL no Atom: Verifique que tenha apenas um endereço válido e evite concatenações acidentais.
🧪 Simule o fluxo: Do Atom, teste o fluxo garantindo que a condição que ativa a requisição HTTP realmente seja atendida.
🕵️ Verifique os logs da conversa: Acesse o chat no módulo de Relatórios ou Histórico e verifique se o passo do componente HTTP figura como executado.
🔁 Revise o histórico de tarefas no Zapier: Acesse Zapier > Zaps > Task History. Se não houver rastro do webhook, o problema está na configuração do Atom.

🔎 Campos do sistema vazios: Como detectar

Às vezes, mesmo que o componente HTTP seja executado corretamente, os sistemas externos não recebem valores-chave como número de telefone, nome ou e-mail. Isso geralmente se deve a uma falha silenciosa na captura de campos.

Como identificar se o campo não foi enviado?

Revise os logs: Se no histórico da conversa o campo aparece vazio (null ou ""), significa que não foi capturado anteriormente ou foi sobrescrito.
Confirme o salvamento: Se usa o componente Salvar campo, valide que o valor esteja preenchido antes do passo de integração. Evite sobrescrever campos do sistema como telefone.
Verifique o nome exato do campo: Você usou telefone, teléfone ou telefone_usuario no corpo do HTTP? Deve coincidir exatamente com a variável salva no Atom. Evite acentos, espaços ou maiúsculas desnecessárias.

✅ Checklist se o fluxo foi duplicado ou editado

Se você fez mudanças recentemente em seu fluxo, faça a si mesmo essas perguntas:

🔁 Os componentes que capturam ou salvam dados foram copiados corretamente?
🧩 Os nomes das variáveis no corpo do HTTP coincidem exatamente com os do fluxo?
🧠 A ordem lógica correta é mantida (Captura do dado → Requisição HTTP)?
🧪 Foram feitos testes reais após as mudanças?

⚠️ Erros por discrepância de tipos de dados

Em alguns casos, o bot pode receber da API um tipo de dado diferente do esperado, o que faz com que o valor não seja armazenado ou o fluxo não continue.

🎯 Cenário comum: Boolean vs. String Uma situação habitual é que o serviço retorne um valor tipo boolean (true ou false), mas o campo do fluxo no Atom esteja preparado para salvar uma cadeia de texto (string). Isso gera um erro silencioso.

🛠️ Como prevenir? Use a opção Gerenciar erros dentro do componente Requisição HTTP. Isso permite que você:

Verifique se a API retorna um erro ou um tipo diferente.
Redirecione para outra parte do fluxo em caso de falha.

📌 Exemplo prático de solução: Se o endpoint retorna true/false mas você precisa de texto, crie um componente Condicional ou Salvar campo após receber o dado:

Se a resposta é true ➡️ salvar "Sim".
Se a resposta é false ➡️ salvar "Não".

🧰 Recomendações finais antes de testar

✅ Sempre teste seu endpoint no Postman com os valores exatos antes de passá-lo para o Atom.
🔄 Compare o resultado da API com o que seu fluxo espera receber.
💬 Simule a conversa completa a partir do Atom para validar a captura de dados.
💡 Dica adicional: Se seu fluxo espera texto, certifique-se de que todas as respostas de sua API venham formatadas como strings (entre aspas) para evitar conflitos.

🔗 Artigo relacionado: [Como testar sua API no Postman]

Que nenhum dado fique pelo caminho! 🚀

Dominar a configuração e o diagnóstico de requisições HTTP garante fluxos robustos e integrações impecáveis. Siga essas boas práticas e conecte o Atom com suas ferramentas sem interrupções. ✅

Como detectar e resolver erros em requisições HTTP do seu bot