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 por meio de 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 HTTP padrão: GET, POST, PUT, DELETE, PATCH e HEAD.
URL: Endereço do endpoint ao qual se realiza a solicitação.
Botão de testar solicitação: Permite verificar se a conexão é bem-sucedida ou negada antes de publicar o fluxo.
Corpo da solicitação (Body): Permite enviar dados apenas 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 aparecem 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 preencherá 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 retorna:
{ "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 caminhos lógicos no fluxo de acordo com o resultado da solicitação:
Sucesso: (Códigos 200, 201). Continua o fluxo positivo.
Erro: (Códigos 400, 500). Desvia para uma mensagem de desculpas ou para um agente.
Tentativa novamente: Para erros temporários (como o 429 ou timeouts). Permite configurar até 5 tentativas automáticas antes de considerar a solicitação como falhada.
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.
✅ 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 Solicitação HTTP, você pode conectar Atom com qualquer plataforma e consultar dados instantaneamente. Automatize processos avançados, elimine tarefas manuais e forneça respostas precisas aos seus clientes. ✅