SyncroCentral de Ajuda
No results found
Acessar Syncro

Criar fluxo de chatbot

Updated on April 30, 2026

Criar chatbot no Syncro é rápido: wizard de 6 passos guia você do zero até um fluxo publicado. Em ~5 minutos sai um bot que responde no WhatsApp/Instagram/site, dispara por palavra-chave, e captura dados pro CRM. Esse artigo cobre cada etapa do wizard + edição posterior do fluxo no builder visual.

Pré-requisitos

  • Permissão admin ou manager pra criar fluxos.
  • Pelo menos 1 canal conectado (WhatsApp via QR Code/Cloud OU Instagram OU Website widget).
  • Pra WhatsApp: veja Conectar número WhatsApp.
  • Pra Instagram: veja Conectar Instagram Business.
  • Plano com cota de fluxos disponível (verifique limite em /configuracoes/cobranca).

Acessar Chatbot Builder

  1. Menu lateral → Chatbot.
  2. Página /chatbot/fluxos abre com lista de fluxos cadastrados.
  3. Clique no botão Novo Chatbot no canto superior direito.
  4. Wizard /chatbot/fluxos/onboarding abre.
📸 PRINT necessário: tela "Chatbot Builder" com lista vazia + botão "Novo Chatbot"

Wizard de 6 passos

Passo 1 — Canal

Escolha onde o chatbot vai rodar:

  • WhatsApp (card verde #25d366) — "Dispara por palavras-chave". Funciona com QR Code E Cloud API.
  • Instagram (card rosa #e1306c) — "DMs e respostas automáticas". Pode disparar por keyword em DM ou comentário em post.
  • Website (card azul #2563eb) — "Widget de chat no seu site". Cliente vê widget flutuante no canto.

Cada canal tem comportamento e capacidades diferentes — perguntas com botões viram lista interativa no WhatsApp, quick replies no Instagram, ou cards no website.

📸 PRINT necessário: Step 1 com 3 cards coloridos selecionáveis

💡 Dica: o canal escolhido não pode ser mudado depois. Crie fluxos separados se quer rodar em vários canais.

Passo 2 — Nome

  • Nome do fluxo (obrigatório): identificador interno. Ex: "Qualificação Inicial", "FAQ Suporte", "Agendamento Demo".
  • Descrição (opcional): contexto pra você lembrar do propósito. Ex: "Captura nome e e-mail antes de mandar pra Camila".

Passo 3 — Template

Escolha um template pré-configurado ou comece do zero:

  • Do zero — só o nó "Iniciar quando..." (start) — você desenha tudo no builder.
  • Templates disponíveis (varia por canal):
  • Qualificação básica — pergunta nome + e-mail + interesse, transfere pra humano.
  • FAQ — múltiplas opções (preço, horário, localização, etc).
  • Agendamento — pergunta data preferencial + horário + tipo de atendimento.
  • Pesquisa NPS — pergunta nota 0-10 + motivo.

Templates copiam nodes + edges prontos. Você ajusta texto/condições no builder.

💡 Dica: comece com template mesmo que vá personalizar — economiza tempo de desenhar fluxo do zero. Editar nó é rápido, criar do nada exige decisões.

Passo 4 — Widget Settings (só se canal = Website)

Configure aparência do widget de chat:

  • Nome do bot (bot_name) — aparece no header do chat. Ex: "Suporte", "Camila", "Atendimento".
  • Avatar — upload de imagem (PNG/JPG, max 1MB). Aparece no chat.
  • Mensagem de boas-vindas (welcome_message) — primeira frase quando cliente abre. Ex: "Olá! 👋 Como posso ajudar?".
  • Tipo de widget (widget_type):
  • Bubble (default) — botão flutuante no canto, abre em popup.
  • Inline — embedado fixo numa seção da página.
  • Cor (widget_color) — color picker pra cor primária do widget.
📸 PRINT necessário: Step 4 com inputs de bot_name + dropzone avatar + textarea welcome

Pra WhatsApp/Instagram, esse passo é pulado.

Passo 5 — Palavras-chave de disparo

Configure quando o chatbot deve acordar e responder:

  • Tipo de gatilho:
  • Keyword (default) — bate por palavra na mensagem.
  • Comentário Instagram (só Instagram) — dispara quando alguém comenta em post.
  • Palavras-chave (CSV): uma ou mais separadas por vírgula. Ex: oi, olá, bom dia, menu, preço.
  • Catch-all (toggle, opcional): marca esse fluxo como fallback — dispara em qualquer mensagem que não bata em outro fluxo. Apenas 1 catch-all por tenant (se ativar, outros são desativados).

Veja Gatilhos: keyword e comentário Instagram pra detalhes.

💡 Dica: comece com poucas keywords (3-5 frases comuns). Adicione conforme observa o que cliente realmente digita.

Passo 6 — Revisão

Tela de review final mostra:

  • Canal escolhido + ícone.
  • Nome + descrição.
  • Template selecionado (se houver).
  • Keywords configuradas.
  • Status inicial: Ativo ✅.

Clique em Criar fluxo pra finalizar.

📸 PRINT necessário: Step 6 com card de revisão + botão "Criar fluxo"

Após criar — Builder visual

Sistema redireciona pro builder (/chatbot/fluxos/{flow}/editar):

  • Sidebar esquerda — paleta de nodes (mensagem, pergunta, condição, ação, aguardar, cards, fim).
  • Canvas central — área de desenho com drag-and-drop (React Flow).
  • Painel direito (aparece ao clicar nó) — config do nó selecionado.

Você arrasta nós da sidebar pro canvas, conecta com setas, configura cada um. Veja Nós: mensagem, input, condição, ação pra detalhes de cada tipo.

📸 PRINT necessário: builder com sidebar de nodes + canvas com 3 nós conectados + painel de config à direita

Editar metadados do fluxo

Pra mudar nome, descrição, keywords ou status sem mexer no fluxo:

  1. Em /chatbot/fluxos, clique nos 3 pontinhos do flow.
  2. Editar fluxo.
  3. Drawer abre com:
  • Nome + descrição.
  • Trigger keywords (CSV).
  • Catch-all toggle.
  • Instância WhatsApp (só canal=whatsapp): dropdown pra escolher número específico ou "Todas".
  • Variáveis (opcional): lista de variáveis pré-declaradas pro fluxo.
  • Ativo (toggle): pausa execução sem deletar.
  1. Salve.
📸 PRINT necessário: drawer "Editar fluxo" com inputs e toggles

Multi-instância WhatsApp

Se você tem vários números de WhatsApp conectados, cada fluxo pode ser:

  • Geral (default): dispara em qualquer instância (whatsapp_instance_id = NULL).
  • Específico de instância: dispara só naquela instância.

Útil em cenários:

  • Número de vendas com fluxo de qualificação.
  • Número de suporte com FAQ.
  • Não quer keyword "preço" disparar fluxo errado em instância errada.

Configure em Editar fluxo → Instância WhatsApp (dropdown lista todas instâncias com badges de capability: QR Code / Cloud Oficial / suporta templates).

Toggle ativo/inativo

Pause execução sem perder configuração:

  1. Em /chatbot/fluxos, ao lado do nome → toggle.
  2. Ativo ✅: processa mensagens com keyword bater.
  3. Inativo ⛔: ignora — mensagens passam pra IA, humano ou ficam não atendidas.

Útil pra pausar fluxo durante manutenção ou trocar pro fluxo novo enquanto testa.

Excluir fluxo

  1. Em /chatbot/fluxos, clique nos 3 pontinhos.
  2. Excluir.
  3. Confirme.
  4. Fluxo + nodes + edges deletam em cascade.
  5. Conversas ativas usando o fluxo ficam órfãs (chatbot_flow_id apontando pra ID que não existe mais) — sistema limpa automaticamente na próxima mensagem.

⚠️ Atenção: ação irreversível. Conversas em andamento perdem o fluxo (cliente recebe próxima mensagem na visão humana ou IA, dependendo do setup).

Limites de plano

Cada plano tem limite de fluxos cadastrados (max_chatbot_flows):

Plano Limite
Trial 1
Starter 3
Growth 10
Scale 50+

Sistema bloqueia criação se atingiu limite. Pra aumentar, faça upgrade. Veja Planos.

Erros comuns

"Limite de fluxos atingido"

Você bateu o max_chatbot_flows do plano. Faça upgrade ou exclua fluxo antigo.

"Canal Instagram não disponível"

Você não conectou Instagram ainda. Vá em /configuracoes/integracoes → conecte.

"Catch-all desativou outros fluxos"

Comportamento esperado — apenas 1 catch-all por tenant. Sistema desativa os outros automaticamente.

Próximos passos

Artigos relacionados