Este componente permite realizar solicitações a APIs externas, facilitando a comunicação em tempo real entre Atom e outros sistemas (CRMs, bases de dados ou serviços em nuvem).
🎯 Propósito e utilidade
Conectar Atom com plataformas externas mediante protocolos padrão.
Enviar e receber dados durante a conversa (ex. consultar um saldo ou registrar um lead).
Integração total: Automatizar processos consultando fontes de dados próprias da empresa.
⚙️ Configuração básica
Métodos disponíveis: Suporta os verbos padrão HTTP: GET, POST, PUT, DELETE, PATCH e HEAD.
URL: Endereço do endpoint ao qual se realiza a petição.
Botão de testar petição: Permite verificar se a conexão é bem-sucedida ou negada antes de publicar o fluxo.
Corpo da petição (Body): Permite enviar dados unicamente em formato JSON. O editor integrado indica se existem erros de sintaxe no código e permite inserir parâmetros dinâmicos facilmente.
Cabeçalhos (Headers): Seção com presets prontos para usar (como Authorization, Content-Type ou Accept). Por segurança, os valores sensíveis como tokens são mostrados ofuscados.
🛠️ Configurações Avançadas
Autorização
Permite configurar o tipo de credenciais que a API requer, com suporte nativo para OAuth 2.0 ou Basic Auth.
Salvar Resposta
Após realizar um teste bem-sucedido, o JSON de resposta aparece pré-carregado. Basta clicar no dado que você precisa e Atom completará o caminho (path) automaticamente. Você pode salvar valores específicos ou a resposta completa em:
Campos de informação (perfil do cliente).
Variáveis de fluxo (uso temporário durante a sessão).
📌 Exemplo de uso: Se a API retornar:
{ "data": { "estado": "Em caminho" } }
Você pode vincular "data.estado" à variável "ESTADO_ORDEM" para armazená-la e usá-la em uma mensagem posterior: "Seu pedido está atualmente: {{ESTADO_ORDEM}}"
Tratamento de códigos de resposta
Você pode definir rotas lógicas no fluxo conforme o resultado da petição:
Sucesso: (Códigos 200, 201). Continua o fluxo positivo.
Erro: (Códigos 400, 500). Encaminha para uma mensagem de desculpas ou para um agente.
Reintentar: Para erros temporários (como o 429 ou timeouts). Permite configurar até 5 tentativas automáticas antes de dar a petição como falha.
Tempo de espera (Timeout)
Define o tempo máximo em segundos que Atom aguardará a resposta do seu servidor. O limite máximo permitido é de 60 segundos.
🕵️♂️ Monitoramento na Simulação (Logs)
Quer garantir que sua conexão seja perfeita antes de lançá-la para seus clientes?
Ao usar a ferramenta de Simulação (para testar seu bot como se fosse um cliente), você pode acessar o console de "Logs" (o registro de atividade).
Lá você poderá ver uma radiografia exata de sua Petição HTTP: verá exatamente quais dados o bot enviou e qual resposta recebeu do seu sistema. Isso torna encontrar e resolver qualquer detalhe super fácil, rápido e transparente.
✅ Checklist de integração
A URL é acessível pela internet?
Os cabeçalhos de autorização estão vigentes?
O formato do corpo (JSON) é válido?
Você configurou uma saída para os códigos de erro (400/500)?
Seus bots agora são mais inteligentes! 🚀
Ao dominar a Petição HTTP, você pode conectar Atom com qualquer plataforma e consultar dados ao instante. Automatize processos avançados, elimine tarefas manuais e forneça respostas precisas aos seus clientes. ✅