Os nós de Integrações conectam o fluxo a sistemas externos — APIs, planilhas, e-mail, WhatsApp, inteligência artificial e plataformas de pagamento — permitindo automações completas sem sair do construtor.
API Request
Realiza uma requisição HTTP para qualquer API externa durante a execução do fluxo, permitindo consultar ou enviar dados para sistemas de terceiros.
Como configurar
- Método HTTP — selecione entre GET, POST, PUT, PATCH ou DELETE.
- URL da requisição — informe o endereço completo da API. Variáveis do fluxo podem ser usadas na URL.
- Headers (JSON) — adicione os cabeçalhos necessários em formato JSON (ex: chaves de autenticação, Content-Type).
Extrair variáveis da resposta
Após a requisição, é possível extrair campos específicos da resposta e armazená-los como variáveis para uso nos próximos nós do fluxo.
- Path JSON — caminho no JSON da resposta (ex:
data.user.id). Se a API retornar{"data": {"user": {"id": 123}}}, usedata.user.idpara capturar o valor123. - Nome da variável — nome para acessar o valor extraído no fluxo (ex:
user_id, acessível como{{user_id}}). Use o botão + para adicionar mais de um campo. - Salvar resposta completa em variável — armazena toda a resposta da API em uma única variável, útil quando a estrutura da resposta é dinâmica ou desconhecida.
Use o botão Testar API para validar a requisição antes de salvar o nó. Isso garante que a URL, os headers e o método estão corretos antes de o fluxo entrar em produção.
TypeBot
Integra o fluxo com um bot criado no Typebot, delegando a conversa para o fluxo configurado na plataforma externa.
Como configurar
- Nome — identificação da integração no fluxo.
- URL — endereço da instância do Typebot.
- Typebot – Slug — identificador do bot específico dentro da instância.
- Tempo em minutos para expirar a conversa — tempo de inatividade antes de a sessão ser encerrada (padrão: 1 minuto).
- Intervalo (ms) entre mensagens — tempo entre o envio de cada mensagem do Typebot (padrão: 1000ms).
- Palavra para finalizar o ticket — quando o contato enviar essa palavra, o ticket é encerrado.
- Palavra para reiniciar o fluxo — reinicia o fluxo quando o contato enviar essa palavra.
- Mensagem de opção inválida — exibida quando o contato envia uma resposta não reconhecida pelo Typebot.
- Mensagem ao reiniciar a conversa — exibida quando a sessão é reiniciada.
Agente de IA Direto
Adiciona um agente de inteligência artificial diretamente no fluxo, com prompt, modelo e ferramentas configuráveis — sem precisar criar um Agente de IA separado no módulo de Agentes.
Aba 1 — Prompt de Sistema
Define o comportamento, tom, personalidade e limitações do agente. Aceita até 5000 caracteres. Seja específico para obter melhores resultados — quanto mais detalhado o prompt, mais consistente será a resposta da IA.
Aba 2 — Provider e Configurações
- Provider — selecione o provedor de IA (ex: Gemini, OpenAI).
- API Key — chave da API do provedor selecionado.
- Model — modelo a ser usado (ex: Gemini 2.0 Flash).
- Temperature — controla a criatividade das respostas. Escala de 0 a 2: valores baixos geram respostas mais precisas e consistentes; valores altos, mais criativas e variadas. O valor 0,7 é um bom equilíbrio para a maioria dos casos.
- Max Tokens — tamanho máximo da resposta gerada. Escala de 1 a 4000: 1000 tokens é suficiente para respostas médias; use 2000 ou mais para respostas longas.
O Gemini 2.0 Flash é rápido e gratuito, sendo indicado para a maioria dos fluxos. Para casos que exigem raciocínio mais complexo, avalie modelos mais robustos do mesmo provedor.
Aba 3 — Ferramentas Habilitadas
Selecione quais ações o agente poderá executar autonomamente durante a conversa. São 17 ferramentas disponíveis:
transferir_fila— transfere o atendimento para uma filaadicionar_tag— aplica uma tag ao contatotransferir_usuario— transfere para um atendente específicoenviar_produto— envia um produto do catálogoexecutar_ferramenta— executa uma ferramenta customizadacurtir_mensagem— curte a última mensagem do contatoenviar_arquivo_contato— envia um arquivo para o contatoenviar_emoji— envia um emoji na conversaver_horario_empresa— consulta o horário de funcionamentolistar_agendamentos— lista os agendamentos do contatocriar_agendamento— cria um novo agendamentoatualizar_agendamento— atualiza um agendamento existentever_info_contato— consulta informações do contatoatualizar_info_contato— atualiza dados do contatolistar_grupos— lista grupos disponíveisenviar_mensagem_grupo— envia mensagem em um grupotransferir_fluxo— transfere para outro fluxo
Ferramentas essenciais: transferir_fluxo para encadear automações, transferir_fila para escalar para atendimento humano e adicionar_tag para categorizar contatos automaticamente durante a conversa.
2ª Via de Boleto
Integração nativa com o Asaas para recuperação automática de boletos pendentes. O nó solicita o CPF do cliente, consulta o boleto mais recente em aberto e envia o PDF do boleto junto com o QR Code PIX para pagamento.
Como configurar
- Mensagem de solicitação do CPF — texto enviado ao cliente pedindo o CPF (ex: “Por favor, informe seu CPF para buscarmos seu boleto:”).
- Mensagem de sucesso — enviada antes de o boleto e o QR Code PIX serem enviados (ex: “Encontramos seu boleto! Enviando os dados…”).
- Mensagem de erro — enviada quando não há boleto pendente ou o CPF é inválido (ex: “Desculpe, não encontramos nenhum boleto pendente para este CPF.”).
Esta integração requer que a conta do Asaas esteja configurada nas integrações da plataforma. O nó busca apenas o boleto pendente mais recente associado ao CPF informado.
Enviar SMTP
Envia um e-mail via servidor SMTP configurado diretamente no nó, sem necessidade de integração externa adicional.
Conexão SMTP
- Nome da conexão — identificação interna da configuração.
- Remetente (from) — endereço de e-mail que aparecerá como remetente.
- Host SMTP — servidor de saída (ex: smtp.gmail.com).
- Porta — porta do servidor (padrão: 587).
- Usuário e Senha — credenciais de autenticação.
- Usar TLS/SSL — ative para conexões seguras (recomendado).
Todas as informações de conexão SMTP são salvas apenas dentro deste fluxo — não ficam disponíveis globalmente para outros fluxos.
Destinatários
- Para (To) — destinatário principal. Aceita variáveis do fluxo (ex:
{{email}}). - Resposta para (Reply-To) — endereço alternativo para respostas.
- Cc e Bcc — cópia e cópia oculta. Separe múltiplos endereços com vírgula.
Conteúdo
- Assunto — linha de assunto do e-mail.
- Conteúdo personalizado — ative para usar um template HTML próprio.
- Modo do conteúdo — HTML (text/html) por padrão.
- Corpo do e-mail — conteúdo da mensagem. Suporta tags HTML como
<b>para negrito e<br>para quebra de linha.
Enviar Mensagem WhatsApp
Envia uma mensagem WhatsApp para um número específico durante a execução do fluxo — diferente dos demais nós de conteúdo, este envia para um destinatário definido manualmente, não necessariamente o contato atual da conversa.
Como configurar
- Conexão WhatsApp (obrigatório) — selecione o número de origem cadastrado na plataforma.
- Número de Telefone (obrigatório) — número de destino no formato internacional (ex: +55 (85) 99999-9999). Aceita variáveis do fluxo.
- Fila (opcional) — fila associada ao envio.
- Mensagem (obrigatório) — texto da mensagem. Suporta variáveis como
{{name}},{{firstName}},{{ms}}e variáveis de perguntas/API.
Opções adicionais
- Assinar mensagem — inclui a assinatura do atendente na mensagem.
- Encerrar ticket após envio — finaliza automaticamente o ticket após o envio da mensagem.
Caso de uso típico: notificar um atendente ou um número interno sempre que um lead específico passar por determinado ponto do fluxo — como quando o contato solicita um orçamento ou confirma interesse em uma proposta.
Perguntas frequentes
Posso usar variáveis do fluxo na URL da requisição API? Sim. Basta inserir a variável no formato {{variavel}} diretamente na URL ou no corpo da requisição. Isso permite chamadas dinâmicas com dados coletados anteriormente no fluxo.
O Agente de IA Direto é diferente do nó Agente no Fluxo? Sim. O nó Agente no Fluxo usa um Agente de IA já criado no módulo de Agentes de IA. O Agente de IA Direto configura o agente inteiramente dentro do próprio nó, sem depender de um agente pré-configurado.
O Enviar Mensagem WhatsApp cria um novo ticket no destino? Não necessariamente. O nó envia a mensagem para o número informado, mas a criação de um ticket depende das configurações da fila selecionada e das regras de atendimento da conta.
A integração com o Asaas busca todos os boletos ou apenas o mais recente? Apenas o boleto pendente mais recente associado ao CPF informado. Se o cliente tiver múltiplos boletos em aberto, somente o último será retornado.
Os dados do SMTP ficam salvos para uso em outros fluxos? Não. As configurações de conexão SMTP são salvas exclusivamente dentro do fluxo onde foram configuradas. Para cada fluxo que precisar enviar e-mail, a conexão deverá ser configurada novamente.