Documentação v2.5.22

WP Flow — Documentação

Tudo que você precisa para instalar, configurar e tirar o máximo do WP Flow.

Introdução

O WP Flow é um plugin WordPress para criar chatbots conversacionais, automação via WhatsApp e atendentes com IA — sem escrever código. Tudo é configurado por um builder visual drag-and-drop diretamente no painel do WordPress.

Builder Visual

Drag-and-drop, 18+ blocos

IA Integrada

Groq, OpenAI, Gemini

WhatsApp

Evolution API nativa

Requisitos mínimos:

  • WordPress 5.8 ou superior
  • PHP 7.4 ou superior
  • MySQL 5.7+ / MariaDB 10.3+
  • HTTPS habilitado no site

Instalação

1

Baixe o plugin

Acesse seu painel em wpflow.com.br com sua conta, vá em Minha conta → Downloads e baixe o arquivo wp-flow.zip.
2

Instale no WordPress

No painel WordPress, vá em Plugins → Adicionar novo → Enviar plugin, selecione o arquivo wp-flow.zip e clique em Instalar agora.
3

Ative o plugin

Após a instalação, clique em Ativar plugin. O menu WP Flow aparecerá na barra lateral do WordPress.
4

Insira sua licença

Acesse WP Flow → Painel → Licença, cole sua chave de licença e clique em Ativar. O plugin validará automaticamente com o servidor.
Em ambientes de desenvolvimento (localhost, .local, .test, .dev.cc) o plugin funciona sem licença para você testar à vontade.
5

Execute as migrações

Na primeira ativação, o WP Flow cria automaticamente as tabelas no banco de dados. Se alguma tabela faltar, vá em WP Flow → Painel e clique em Executar migrações.

Criando seu primeiro fluxo

1

Acesse "Meus Fluxos"

Vá em WP Flow → Fluxos e clique em Novo Fluxo.
2

Escolha o tipo de fluxo

  • Chat Widget — aparece como widget flutuante no site
  • Agente IA — responde perguntas com inteligência artificial
  • WhatsApp — executado quando uma mensagem WhatsApp chega
3

Monte o fluxo no editor

O editor visual abre com uma tela em branco. Arraste blocos do painel esquerdo para a tela, conecte-os pelos pontos de saída e configure cada bloco no painel direito.
4

Use variáveis coletadas

Dados coletados por blocos de entrada ficam disponíveis como variáveis em qualquer bloco de mensagem:
texto
Olá, {{nome}}! Vamos enviar a confirmação para {{email}}.
5

Ative e publique

Clique em Salvar e depois ative o toggle do fluxo na lista. O widget de chat aparecerá automaticamente no seu site (ou use o shortcode para posicionamento manual).
Use o botão Visualizar no editor para testar o fluxo antes de publicar.

Blocos disponíveis

Cada bloco tem entradas (conexões de chegada) e saídas (conexões de saída). Conecte-os para definir o caminho do fluxo.

Conteúdo3 blocos

Mensagem

Envia um texto para o visitante.

Imagem

Exibe uma imagem no chat.

Botões

Mostra opções clicáveis para o visitante escolher.

Entrada7 blocos

Pergunta

Solicita uma resposta livre do visitante.

Nome

Coleta o nome e salva em {{nome}}.

E-mail

Coleta e valida o e-mail do visitante.

Telefone

Coleta o número de telefone.

WhatsApp

Coleta o WhatsApp e permite enviar mensagens.

Localização

Pede a cidade ou coordenadas do visitante.

Texto Livre

Qualquer resposta de texto sem validação.

Lógica1 blocos

Condição

Bifurca o fluxo em verdadeiro/falso por expressão.

Ação5 blocos

Delay

Aguarda N segundos antes de continuar.

Link

Redireciona o visitante para uma URL.

Suporte

Notifica o agente para assumir a conversa.

Tag

Aplica uma tag ao contato para segmentação.

Criar Post

Cria um post/CPT no WordPress com os dados coletados.

Integração2 blocos

Resposta IA

Gera uma resposta com o provedor de IA configurado.

API

Faz uma requisição HTTP e salva a resposta em variável.

Configurar IA

Vá em WP Flow → Painel → Configurações de IA e configure o provedor desejado.

GroqGratuito

Modelos: Llama 3.3 70B

↗ console.groq.com
OpenAI

Modelos: GPT-4o, GPT-4o Mini, GPT-3.5

↗ platform.openai.com
GeminiGratuito

Modelos: 1.5 Flash, Pro, 2.0 Flash

↗ aistudio.google.com
Configure múltiplos provedores. O WP Flow usa o principal e cai automaticamente para o próximo em caso de erro ou rate limit — seu chatbot nunca fica offline.

Usando o bloco "Resposta IA"

Adicione o bloco Resposta IA ao seu fluxo. No painel de configuração você pode:

  • Definir um prompt do sistema específico para esse bloco
  • Escolher o provedor/modelo (ou usar o padrão global)
  • Ajustar temperatura e máximo de tokens
  • Usar variáveis coletadas no prompt: {{nome}}, {{email}}

WhatsApp

O WP Flow usa a Evolution API para integração com WhatsApp. Você precisa de uma instância Evolution API própria ou contratada.
1

Configure a Evolution API

No arquivo wp-config.php ou nas configurações do plugin, informe a URL da sua instância Evolution API e a chave de autenticação.
2

Crie uma instância WhatsApp

Vá em WP Flow → WhatsApp → Instâncias e clique em Nova instância. Dê um nome e clique em Criar.
3

Conecte pelo QR Code

Clique em Conectar na instância criada. Um QR Code aparecerá — escaneie com seu WhatsApp em Configurações → Dispositivos vinculados.
4

Configure o webhook

O WP Flow configura o webhook automaticamente. A URL do webhook é:
url
https://seusite.com.br/?rest_route=/wp-flow/v1/whatsapp/webhook
5

Crie um fluxo do tipo WhatsApp

No builder, crie um novo fluxo com tipo WhatsApp. Esse fluxo será executado quando uma mensagem chegar na instância conectada.

Shortcodes

Use shortcodes para incorporar o chat em páginas ou posts específicos.

Chat com fluxo específico

Incorpora o widget de chat de um fluxo específico pelo ID.

shortcode
[wpflow_chat flow_id="123"]

Chat automático

Se nenhum flow_id for informado, o WP Flow usa o primeiro fluxo de chat ativo publicado.

shortcode
[wpflow_chat]

Widget flutuante global

O widget flutuante é ativado automaticamente em todo o site quando você publica um fluxo do tipo Chat Widget. Para desabilitar em uma página específica, adicione a classe no-wpflow ao body.

Licença

Starter

R$ 197

1 site · Vitalício

Pro

R$ 297

Ilimitado · Vitalício

Agência

R$ 497

Ilimitado + VIP · Vitalício

Ativar licença

1

Acesse as configurações de licença

Vá em WP Flow → Painel → Licença.
2

Cole a chave

Insira sua chave de licença (formato: XXXX000000XXXXX) e clique em Ativar.
3

Verificação automática

O plugin verifica a licença diariamente via cron. Se a licença for revogada ou expirar, o plugin exibirá um aviso no painel.
Cada domínio de produção consome uma ativação do seu plano. Ambientes locais não consomem ativações.

Desativar licença

Para mover a licença para outro domínio, vá em WP Flow → Painel → Licença e clique em Desativar. A ativação será liberada e você poderá usar em outro site.

Ainda tem dúvidas?

Nossa equipe responde em até 24 horas úteis.