Requisitos Prévios
Antes de configurar tuas requisições HTTP, certifique-se de ter o seguinte pronto em seu ambiente:
Permissões de Administrador para criar e editar fluxos no Flowbuilder.
Campos personalizados do tipo seletor já criados, com suas opções devidamente configuradas (tanto o Label visível quanto sua Chave interna).
Conhecimento da estrutura da requisição necessária pelo serviço externo (Endpoint, Headers e o corpo da requisição em formato JSON).
📤 Enviar Dados de um Seletor para uma API Externa
Quando você coleta informações de um cliente por meio de um campo tipo seletor e precisa enviá-las para seu CRM ou outro sistema através do Componente HTTP, é vital escolher qual formato de dado você deseja transmitir.
Todo campo seletor é composto por duas propriedades:
Propriedade | Definição para o Usuário | Nomenclatura no Flowbuilder | Exemplo Prático |
Label (Rótulo) | O texto amigável que o cliente ou o consultor lê na interface de chat. |
| "Suzuki Swift" |
Chave (Valor Interno) | O identificador único do dado, projetado para ser lido por bancos de dados. |
|
|
Para definir qual propriedade enviar no corpo (Body) de sua requisição JSON, simplesmente adicione um ponto (.) seguido da propriedade ao final da variável de seu campo.
Observe este exemplo de configuração JSON:
JSON
{
"modelo_enviando_label": "{{client.custom_modelos_suzuki.label}}",
"modelo_enviando_key": "{{client.custom_modelos_suzuki.key}}",
"modelo_comportamento_padrao": "{{client.custom_modelos_suzuki}}"
}
💡 Dica: Preste atenção à terceira linha do exemplo. Se você colocar a variável sem especificar nenhuma terminação, o sistema do Atom enviará sempre a Chave (Valor Interno) por padrão.
📥 Salvar a Resposta de uma API em um Seletor
Se seu caso de uso é consultar um sistema de terceiros (por exemplo, validar o status de um cliente no HubSpot) e você deseja armazenar essa resposta automaticamente dentro de um seletor no Atom, siga esta rota:
Acesse o nó de seu Componente HTTP no Flowbuilder.
Navegue até a seção de mapeamento de respostas ou salvamento de variáveis.
Defina a rota exata do JSON de resposta que você deseja capturar (ex.
data.status_cliente).Selecione o campo personalizado tipo seletor do Atom onde este dado será armazenado.
⚠️ Importante: Para que o salvamento seja bem-sucedido, o Atom executa uma validação rigorosa. Primeiro tentará corresponder a resposta da API com a Chave de alguma opção. Se não houver sucesso, procurará uma correspondência de 100% com o Label (respeitando maiúsculas e espaços). Se a resposta não corresponder nem à Chave nem ao Label, o campo não salvará nada para proteger a integridade de seus dados.
🧪 Auditoria e Verificação
Para confirmar que sua estratégia de envio e salvamento de dados está funcionando perfeitamente, execute o seguinte protocolo de teste:
Inicie uma conversa a partir de um canal de teste conectado ao seu Flowbuilder e avance até passar pelo nó do Componente HTTP.
Dirija-se ao console de seu serviço de terceiros e verifique que o sistema recebeu corretamente o Label ou a Chave, conforme você configurou.
Para validar o recebimento de volta, abra o Painel Lateral de sua conversa de teste no Atom. Revise a aba de informações do cliente e confirme que o campo seletor foi atualizado com a nova opção.
E é isso! Agora você tem o conhecimento técnico para orquestrar a comunicação de dados estruturados entre o Atom e qualquer ecossistema tecnológico. Ao dominar o uso de Labels, Chaves e as regras de validação, você garante integrações robustas e mantém o banco de dados de sua plataforma totalmente impecável. ✅