Aprenda a criar fluxos incríveis no X1Bot 🚀

Bem-vindo à documentação oficial da plataforma mais versátil para automação de WhatsApp. Masterize os nodes, entenda os gatilhos e construa atendimentos imbatíveis.

Início Rápido

Configure sua primeira sessão e monte seu fluxo em 5 minutos.

Nodes do Fluxo

Entenda como funcionam as IAs, envios de mídia, aguardos e condições.

Tutoriais Reais

Passo a passo para criar funis de venda, Lançamentos em Grupo e mais.

Variáveis

Data, hora, sistema, respostas do lead e valores aninhados.

Inbox (CRM)

Busca, filtros, envio de mídia, respostas rápidas e gerenciamento de conversas.

Guia de Início Rápido

1Conectar seu WhatsApp

O X1Bot requer uma sessão de WhatsApp conectada para operar. Navegue até o menu de Sessões no painel lateral esquerdo, clique em "Nova Sessão" e faça o escaneamento do QR Code com o seu celular pelo WhatsApp Web.

Screenshot: QR Code Scan (Emulação)

2Criar seu primeiro fluxo

No menu Fluxos, clique em "Novo Fluxo". Você verá o Canvas principal. Todo fluxo começa com um "Gatilho" (Trigger). Arraste um "Trigger WhatsApp", defina uma palavra-chave como "Olá", e conecte ele a um node de "Enviar Mensagem" puxando a linha do ponto à direita.

3Uso de Variáveis Mágicas

Personalize as mensagens usando as chaves duplas {{ }}. O sistema substitui isso por dados reais no momento do envio.

Variável Mágica	Descrição do que injeta	Exemplo Visível
{{contact.phone}}	O telefone completo do lead	5511999999999
{{contact.name}}	Nome do contato (se salvo)	Júlia Almeida
{{variables.XPTO}}	Qualquer variável criada no node Definir Variável ou salva de um Wait	"Sim", "150.00"

Gatilhos (Triggers)

Triggers são a porta de entrada. Um fluxo sempre deve começar por pelo menos um Trigger ativo.

📱 Trigger WhatsApp

Gatilho

O que faz

Inicia o fluxo quando alguém envia mensagem no WhatsApp para a sessão configurada.

Configurações

Campo	Descrição
Sessão	Qual número do WhatsApp vai ouvir
Palavra-chave	Opcional — só dispara se mensagem contiver
Tipo de msg	Texto, imagem, qualquer

💡 Dicas de uso

Deixe sem palavra-chave para responder qualquer mensagem.
Use palavra-chave para criar menus (ex: "1", "comprar").
Combine com node Condição (If/Else) para fluxos complexos.

🖱️ Trigger Manual

Gatilho

O que faz

Permite disparar o fluxo manualmente via painel para um contato ou grupo específico, sem precisar de mensagem inicial.

Configurações

Campo	Descrição
Destino	Contato individual ou grupo
Número	Telefone do destinatário
Sessão	Qual WhatsApp usar para o envio ativo
Variáveis	Dados customizados para o fluxo injetar

💡 Dicas de uso

Ideal para disparos pontuais, testes A/B internos e reinício de funis quebrados.
Use variáveis dinâmicas ao disparar para preencher `{{variables.X}}`.

⏰ Trigger Agendamento

Gatilho

O que faz

Executa o fluxo automaticamente e em background em horários configurados — diário, semanal ou em data/hora específica.

Modos Disponíveis

📅 Data e hora específica (Disparo único)
🕐 Hora fixa diária (Disparo repetitivo, com filtro de dias da semana)
⏱️ Intervalo regular (Executar a cada X horas/minutos)

📝 Exemplo Prático

Enviar um resumo diário para você mesmo ou para sua lista VIP todos os dias às 09:00.

Ações do Fluxo

Com os triggers definidos, utilize os nodes de Ação para construir a inteligência e o envio do fluxo.

💬 Enviar Mensagem

Ação

O que faz

Envia uma mensagem de texto rica para o contato ou grupo que originou o engajamento no fluxo.

Configurações

Campo	Descrição	Exemplo
Mensagem	Texto a enviar	"Olá {{contact.name}}!"
Simular di...	Mostra "digitando..." antes	Ativado
Duração	Segundos digitando no celular	3

💡 Dicas de uso

Use {{contact.name}} para chamar pelo nome.
Ative "simular digitando" (pelo menos 2s a cada 3 linhas) para parecer mais humano.
Quebre textos gigantes em vários nodes conectados em sequência para leitura mais leve.

🖼️ Enviar Mídia

Ação

O que faz

Envia um arquivo anexado (com ou sem legenda) direto no chat.

Tipos Suportados

🖼️ Imagem: JPG, PNG, WEBP (máx 5MB)
🎵 Áudio: MP3, OGG (máx 10MB)
🎤 Áudio de voz (PTT): O famoso "áudio gravado na hora"
🎬 Vídeo: MP4 (máx 50MB)
📄 Documento: PDF, DOCX (máx 20MB)

Origem da Mídia

URL externa (https://seusite.com/video.mp4)
Upload direto via painel da plataforma
Extraído de uma variável (ex: {{variables.imageUrl}})

⏳ Aguardar (Wait)

Ação

O que faz

Intencionalmente pausa e segura o fluxo. Essencial para criar delays humanizados, aguardar o cliente pensar ou suspender a automação até o dia seguinte.

Modos Diversos

Tempo fixo: Segundos, minutos ou horas fixas.
Aguardar Resposta: O fluxo para DEFINITIVAMENTE ali até que o usuário responda. O texto enviado por ele será sempre salvo em {{variables.userResponse}} ou numa variável de sua escolha.
Até data específica: Para envios baseados num calendário futuro.

💡

O "Aguardar Resposta" é a principal ferramenta para receber dados e enviar para a IA. Toda resposta que rompe um estágio de Wait fica acessível para o próximo node através da variável referenciada.

⚖️ Condição (If/Else)

Ação

O que faz

Bifurca o fluxo de automação. Cria um caminho para SIM (quando a condição é atingida) e um caminho para NÃO (quando falha).

Operadores Base

igual a / diferente de
contém / não contém
maior que / menor que (Para valores numéricos)
está vazio / não está vazio

// Exemplo de roteamento

SE {{variables.pagamento}} == "aprovado"

→ Caminho SIM: Node Enviar Acesso

→ Caminho NÃO: Node Aguardar 2h reengajamento

🤖 Agente de IA

Ação Efetiva

O que faz

Passa a batuta da operação para uma Inteligência Artificial generativa via API. A resposta gerada pela IA pode tanto ser enviada de imediato ao cliente, quanto ser salva para ser avaliada em condicionais.

Configuração	Explicação
Prompt do Sistema	As regras e as amarras em que a IA deve atuar.
Modelo	Qual tecnologia base usar (OpenAI, Claude, etc).
Temperatura	0=Focado/Preciso, 1=Super Criativo/Devaneio.
Memória	Relembrar contexto das últimas X mensagens daquele contato.

💡 Boas Práticas de Prompt

"Você é a Júlia, assistente virtual da Loja. Responda apenas e estritamente em português, de forma empática."
"Se não souber a resposta da tabela de preços fornecida a você, diga: 'Deixe-me conferir com o meu gerente.'"

🎲 Randomizador

Ação de Roteamento

O que faz

Distribui contatos (leads) de forma randômica ou ponderada entre diferentes caminhos de saída do nó. Essencial para A/B Testing e roteamento de atendentes.

📝 Casos de uso ideais:

Teste A/B de cópias: Saída A (50%) com texto longo, Saída B (50%) com texto curto.
Roleta de Vendedores: Mandar fluxos alternados para ramificações diferentes de atendentes do comercial.
Sorteios interativos dentro de engajamento do funil.

Nodes Específicos para Grupos

Ferramentas de alta conversão criadas especificamente para gerir engajamento em massa e lançamentos de grupos de WhatsApp.

📢 Mencionar Todos

Node de Grupo

Marca secretamente todos os participantes do grupo para forçar a notificação chegar (bypass de grupos silenciados). Possui sistema de Cooldown (Resfriamento) embutido para evitar banimentos do WhatsApp por spam de marcação em curto período de tempo.

🔥 Múltiplas Mensagens de Aquecimento

Lançamentos

Gera um schedule automático de mensagens baseadas no tempo de vida (ativação) de um grupo específico. Por exemplo:

- Enviar msg A de Boas Vindas no Dia 0 (Criação)
- Enviar msg B no Dia 1 (Gerando Autoridade)
- Enviar msg C no Dia 2 (Antecipação)

Ele calcula a diferença de dias automaticamente usando os metadados do grupo atrelado.

Variáveis e Templates

Em qualquer campo de texto use {{variável}} — o sistema substitui pelo valor real na hora do envio. Timezone: São Paulo (America/Sao_Paulo).

📅 Data e Hora

Disponíveis em qualquer mensagem — sem configuração, funcionam automaticamente.

Variável	Resultado	Descrição
{{hoje}}	23/03/2026	Data atual (DD/MM/AAAA)
{{data}}	23/03/2026	Alias de {{hoje}}
{{hora}}	14:30	Hora atual (HH:MM)
{{agora}}	23/03/2026 14:30	Data + hora atual
{{amanha}}	24/03/2026	Data de amanhã
{{semana}}	Seg, 30/03/2026	Data daqui 7 dias com dia abreviado
{{mes}}	Março	Nome do mês por extenso
{{ano}}	2026	Ano atual
{{dia_semana}}	Segunda-feira	Nome do dia da semana por extenso

Exemplos práticos:

⚠️ Válido até {{hoje}}
🎯 Garanta sua vaga antes de encerrar!

🔥 Preço especial válido somente até amanhã ({{amanha}}) às 23h59.

✅ Agendamento confirmado!
📅 Data: {{hoje}}
⏰ Horário: {{hora}}

⚙️ Variáveis do Sistema

Injetadas automaticamente pelo motor de execução em todas as execuções.

Variável	Descrição
{{_contactPhone}}	Telefone do contato (JID: 5511999999999@s.whatsapp.net)
{{_sessionId}}	ID da sessão WhatsApp que recebeu a mensagem
{{_tenantId}}	ID do tenant (conta)
{{triggerMessage}}	Texto da mensagem que acionou o fluxo
{{etapa}}	Etapa atual do contato no funil (node MARK_STAGE)
{{contactStage}}	Alias de {{etapa}}
{{contactTags}}	Tags do contato (array)

💬 Resposta do Lead

Definidas automaticamente quando o lead responde em nodes WAIT_REPLY.

Variável	Descrição
{{respostaHook}}	Texto da última resposta do lead
{{nome}}	Preenchida se você capturou o nome via WAIT_REPLY

🏷️ Definidas pelo Usuário

Criadas por nodes específicos com o campo "Salvar como" (saveAs).

WAIT_REPLY

Salva a resposta do lead em uma variável que você escolhe.

Config: Salvar resposta como: nome

Uso: Prazer, {{nome}}! Como posso te ajudar hoje?

HTTP Request

Salva o retorno da API em uma variável.

Config: Salvar resposta como: pedido

Uso: Pedido {{pedido.id}} está: {{pedido.status}}

CODE (JavaScript)

O resultado do código fica em codeOutput.

Config: —

Uso: Resultado: {{codeOutput}}

PIX

Gera variáveis automáticas de cobrança.

Config: —

Uso: {{_pixConfig}} / {{_pixExpiresAt}}

🔀 Em Condições e Switch

Nos nodes CONDITION e SWITCH, use expressões JavaScript com variables.nome (sem chaves duplas).

// Verificar resposta
variables.respostaHook === 'sim'

// Verificar etapa
variables.etapa === 'qualificado'

// Verificar valor numérico
Number(variables.quantidade) > 5

// Combinar com horário comercial
variables.respostaHook === 'sim' && isWithinBusinessHours(9, 0, 18, 0, [1,2,3,4,5])

🔗 Valores Aninhados

Quando a variável é um objeto (ex: retorno de API), use ponto para acessar campos internos.

JSON retornado pela API:

{
  "id": "123",
  "status": "aprovado",
  "cliente": {
    "nome": "João"
  }
}

Uso no texto da mensagem:

Pedido {{pedido.id}}
Status: {{pedido.status}}
Cliente: {{pedido.cliente.nome}}

💡 Boas Práticas

Sempre use {{variável}} com chaves duplas — simples não funciona.
Nomes são case-sensitive: {{nome}} ≠ {{Nome}}.
Se a variável não existir, o texto permanece como {{variavel}} — teste antes de ativar.
Variáveis de data não precisam de configuração — funcionam em qualquer mensagem.
Em condições, use variables.nome sem chaves.

Inbox (CRM de Conversas)

O Inbox centraliza todas as conversas recebidas via WhatsApp com ferramentas para gerenciar, responder e automatizar o atendimento.

🔍 Busca e Filtros

A busca acontece no banco de dados — não se limita às conversas carregadas na tela. Atualiza automaticamente após 400ms.

Filtro	Opções
Sessão	Filtra por conta WhatsApp específica
Status	Aberto / Pendente / Resolvido / Bot
Tipo	Individual / Grupo

📋 Lista de Conversas

Paginação

Carrega 30 conversas por vez, ordenadas pela mensagem mais recente. Clique em "Carregar mais conversas" no final da lista.

Tempo Real

Nova mensagem: conversa sobe para o topo automaticamente. Não recarrega a lista inteira — só atualiza a conversa afetada.

Indicadores em cada conversa:

Avatar do contato (ou inicial do nome)
Última mensagem e horário
Badge de não lidas (verde) — some ao abrir
Status: Aberto, Pendente, Resolvido, Bot
Nome da sessão (quando há múltiplas contas)

💬 Enviando Mensagens

Texto

Enter → Envia | Shift + Enter → Quebra de linha

📎 Envio de Mídia

Tipo	Formatos	Limite
Imagem	JPG, PNG, WebP	5 MB
Áudio	MP3, OGG, AAC, WAV	10 MB
Vídeo	MP4	50 MB
Documento	PDF, DOC, DOCX	20 MB

💬 Respostas Rápidas

Atalhos de texto pré-definidos para mensagens frequentes.

Clique em 💬 → selecione a resposta → texto inserido no campo
Para criar: 💬 → + → preencha Título e Texto → Salvar
Para excluir: hover sobre a resposta → ícone 🗑️
Salvas localmente no navegador (localStorage)

⚙️ Gerenciamento da Conversa

Status	Descrição	Cor
Aberto	Conversa ativa, aguardando atendimento	● Verde
Pendente	Em espera de informação ou ação	● Amarelo
Resolvido	Atendimento concluído	● Cinza
Bot	Automação em andamento	● Roxo

🟥 Parar Bot

Quando automação está rodando, aparece botão "Parar Bot" em vermelho no header. Interrompe imediatamente e volta para status Aberto.

⚡ Disparar Fluxo

Clique em "Fluxo" no header para disparar manualmente um workflow. Se houver automação rodando, ela é cancelada antes.

👤 Painel do Contato

Informações exibidas:

Sessão — qual conta WhatsApp recebeu a mensagem
Tipo — Individual ou Grupo
ID Chat — JID completo do contato
Etiquetas — labels do WhatsApp (somente leitura)
Automação Ativa — nome do fluxo em andamento

✏️ Editar Nome

Hover no nome → clique em ✏️ → digite → Enter ou Salvar. Atualizado em toda a interface imediatamente.

🔄 Sincronizar Foto

Clique no ícone 🔄 sobre o avatar para buscar a foto de perfil do WhatsApp.

Ação	Como fazer
Enviar mensagem	Enter
Quebrar linha	Shift + Enter
Inserir resposta rápida	Clique em 💬 → selecione o template
Enviar arquivo	Clique em 📎 → selecione o arquivo
Editar nome do contato	Hover no nome → clique em ✏️
Parar automação	Botão vermelho "Parar Bot" no header
Carregar mais conversas	Botão no final da lista
Carregar mensagens antigas	Botão "Carregar mais" no topo do chat

Guias Práticos e Tutoriais

Construindo um Funil de Vendas

Aprenda a conectar os nodes Enviar Mensagem, IF/ELSE e Botões para qualificar um lead até o fechamento com PIX.

Ler o guia

Automação de Lançamento em 50 Grupos

Como usar o Trigger de Agendamento junto com o "Sequência de Lançamento" para disparar o Carrinho Aberto.

Ler o guia

Perguntas Frequentes

Posso usar o bot em múltiplos celulares?

Sim, o limite de sessões de WhatsApp vinculadas dependerá do plano da sua licença. Depois de conectar os QRCodes, você escolhe no Trigger do fluxo qual número irá responder.

As mensagens são enviadas como um celular normal?

Sim. A tecnologia Baileys emula o WhatsApp Web perfeitamente. Se usar a opção de simular "digitando...", o delay é transmitido para os contatos assim como você faria escrevendo à mão livre.

As mídias de vídeo e imagem ficam pesadas pro bot disparar?

Depende inteiramente dos limites do seu servidor, que faz o proxy das mídias. Mídias como PTT de voz devem ser encodadas nativamente em Opus (codec para que seja reconhecido como "voz"). A plataforma já se encarrega disso via conversor embutido (exigindo FFmpeg instalado na VPS).