Antes de começar
Separe estas coisas. Nas próximas telas você responde o que já tem, e o guia mostra só o que falta fazer.
Instagram profissional
Conta comercial ou de criador. Conta pessoal não aceita automação. Dá pra mudar no app do Instagram, em Configurações → Tipo de conta e ferramentas.
Conta no Facebook
Pra criar o app que liga o FlowMestre ao Instagram. Pode ser o seu Facebook pessoal.
Uma segunda conta do Instagram
Pra testar no final. A própria conta não dispara automação nela mesma. Pode ser o perfil de alguém da família ou uma conta de teste.
O e-mail da sua compra
É com ele que você ativa o FlowMestre.
Um computador e cerca de 2 horas
A instalação é feita no navegador do computador. Pelo celular fica bem mais difícil.
Você já tem um domínio?
Domínio é o endereço do seu negócio na internet, como seunegocio.com.br. A Meta só conversa com endereços seguros (https), e pra isso o FlowMestre precisa de um domínio.
Contrate o seu domínio em um destes sites
- Registro.br (registro.br): o registro oficial dos domínios
.com.br, cerca de R$ 40 por ano. - Hostinger: dá pra comprar junto com a VPS e cuidar de tudo no mesmo painel.
Prefira um nome curto, com o nome do seu negócio. Depois você usa um pedaço dele pro FlowMestre, como flowmestre.seunegocio.com.br, sem pagar nada a mais.
Não precisa de hospedagem de site. Só o domínio.
Você já tem onde rodar o FlowMestre?
O FlowMestre roda numa VPS: um computador ligado 24 horas na internet, só seu, que responde as mensagens a qualquer hora.
Hospedagem de site não roda o FlowMestre. Ela serve pra sites (como WordPress), não pra sistemas que ficam ligados respondendo mensagens. Mantenha ela pro seu site e contrate uma VPS à parte. Seu domínio pode continuar onde está.
Contrate a VPS na Hostinger
- Entre pelo link hostinger.com.br/luciana e escolha um plano de VPS.
- Na hora de configurar o servidor, escolha o modelo Ubuntu com Easypanel. Assim a VPS já vem com o EasyPanel instalado.
- Crie a senha do servidor (root) e guarde num lugar seguro.
- Finalize a compra e espere a VPS ficar pronta. Leva alguns minutos.
- No painel da Hostinger (hPanel), abra a sua VPS e anote o endereço IP. São quatro números separados por ponto, tipo
123.45.67.89.
A sua VPS já tem o EasyPanel?
O EasyPanel é o painel onde você liga, atualiza e configura o FlowMestre sem digitar comandos.
Abra no navegador http://SEU-IP:3000, trocando SEU-IP pelo IP da sua VPS. Se aparecer a tela do EasyPanel, ela tem. Se não abrir nada, escolha Não tem.
A sua VPS é da Hostinger?
Troque o sistema pelo modelo com EasyPanel
- No hPanel, abra a sua VPS e vá na opção de trocar o sistema operacional.
- Escolha o modelo Ubuntu com Easypanel e confirme.
- Crie a nova senha do servidor (root) e espere terminar. Leva alguns minutos.
Instale o EasyPanel com o comando oficial
A VPS precisa ter:
- sistema Ubuntu, sem nada instalado (sem sites nem outros sistemas rodando);
- pelo menos 2 GB de memória;
- acesso com o usuário root e a senha do servidor.
- No seu computador, abra o Terminal (no Mac) ou o PowerShell (no Windows).
- Entre na VPS digitando o comando abaixo, trocando
SEU-IPpelo IP dela. Ele pede a senha do servidor (enquanto você digita, nada aparece na tela; é normal).ssh root@SEU-IP - Já dentro da VPS, cole este comando e aperte Enter:
curl -sSL https://get.easypanel.io | sh - Espere terminar. Ele instala tudo sozinho.
Abra o EasyPanel
- No navegador, abra
http://SEU-IP:3000trocandoSEU-IPpelo IP da sua VPS. Tem que serhttpe terminar em:3000. - Na primeira vez ele pede pra criar uma conta. Use seu e-mail e uma senha forte. Essa é a senha do painel, diferente da senha do servidor.
- Depois de criar, você já entra no painel.
http:// (sem o “s”) e o :3000 no final.Escolha o endereço do seu FlowMestre
É por ele que você vai abrir o FlowMestre. O mais simples é usar um pedaço do seu domínio, como flowmestre. antes dele. Todos os endereços deste guia se ajustam ao que você digitar.
https://.
Onde você administra o seu domínio?
Agora você avisa a internet que flowmestre.seunegocio.com.br fica no IP da sua VPS. Isso se faz na parte de DNS do lugar onde o domínio é administrado.
Procure o e-mail da compra do domínio: normalmente é lá mesmo. Pra domínios .br, a busca em registro.br mostra quem cuida dele. Depois volte e escolha a opção certa.
- Abra o DNS do seu domínio e clique pra adicionar um registro.
- Tipo: A.
- Nome: a parte antes do domínio. Pra
flowmestre.seunegocio.com.br, o nome éflowmestre. - Valor (ou “aponta para”): o IP da sua VPS. São quatro números separados por ponto, por exemplo
123.45.67.89. Use o IP que você anotou da sua VPS, não esse. - Salve. Pode levar de alguns minutos a algumas horas pra valer.
Instale o FlowMestre no EasyPanel
- No EasyPanel, crie um projeto. Pode chamar de
flowmestre. - Dentro do projeto, adicione um serviço do tipo App e chame de
flowmestre. - No serviço, abra a aba Fonte (Source), escolha Imagem Docker (Docker Image), cole o endereço abaixo e salve.
ghcr.io/luciana-papini/flowmestre:latest - Abra a aba Ambiente (Environment). Digite seu e-mail de contato aqui embaixo, clique em Copiar tudo e cole no campo de variáveis, do jeito que está. Depois salve.
- Na aba Armazenamento, clique em Adicionar Montagem de Volume. Na janela Criar Montagem de Volume, preencha:
- Nome:
dados - Caminho de Montagem:
/data
Clique em Criar. É ali que ficam seus contatos e automações. Sem isso, tudo some a cada atualização.
- Nome:
- Na aba Domínios, adicione um domínio e preencha:
- Host:
flowmestre.seunegocio.com.br - HTTPS: ligado
- Porta:
80
- Host:
- Clique em Implantar (Deploy) e espere terminar.
IG_APP_ID e IG_APP_SECRET ficam vazias por enquanto. Você completa depois de criar o app na Meta: é só colar o valor de cada uma depois do = e clicar em Implantar. O passo a passo dentro do FlowMestre avisa a hora.Crie o seu acesso e ative o FlowMestre
- Abra https://flowmestre.seunegocio.com.br. Na primeira vez aparece a tela pra criar o administrador: seu nome, e-mail e senha. É com eles que você vai entrar no FlowMestre.
- Em seguida ele pede a ativação. Digite o e-mail que você usou na compra e clique em Receber código.
- Digite o código de 6 dígitos que chega nesse e-mail. Cada compra ativa um FlowMestre.
Agora o FlowMestre te guia na parte do Instagram
Falta ligar o FlowMestre ao seu Instagram. Pra isso você cria um app na Meta, que dá ao FlowMestre permissão de responder no seu Instagram. O passo a passo completo fica dentro do FlowMestre, com os endereços da sua instalação prontos pra copiar.
- Entre no FlowMestre. A tela de Início mostra os dois passos: Criar o seu app na Meta e Conectar o seu Instagram.
- Clique em Ver passo a passo e siga. Cada passo fica marcado sozinho quando está pronto.
- No fim, mande uma mensagem de outra conta do Instagram pra testar.
Tire dúvidas com o Claude: skill de suporte
Travou em alguma etapa? Instale a skill de suporte do FlowMestre no seu Claude. Ela conhece cada tela deste guia e te mostra o próximo clique, um passo de cada vez.
- Baixe o arquivo
suporte-flowmestre.zipno botão abaixo. Não precisa abrir. - No Claude, abra as Configurações, vá na parte de Skills e envie o arquivo.
- Confira se a skill suporte-flowmestre ficou ligada.
- Numa conversa nova, escreva sua dúvida normalmente ou mande o print da tela. A skill entra sozinha.
SESSION_SECRET, o IG_VERIFY_TOKEN e o código de ativação.Como atualizar o seu FlowMestre
Quando sair uma versão nova do FlowMestre, você não precisa refazer a instalação.
- Entre no EasyPanel e abra o projeto e o serviço do FlowMestre.
- Clique em Implantar.
- Espere terminar. Ele baixa a versão mais recente sozinho.
/data, que a atualização não apaga.Se algo der errado
O endereço do FlowMestre não abre ou aparece “não seguro”
O registro A do DNS pode ainda não ter valido. Espere um pouco. Se usa Cloudflare, a nuvem desse registro precisa estar cinza (somente DNS). No EasyPanel, confira se o domínio está com HTTPS ligado e porta 80.
Atualizei o FlowMestre e sumiram meus dados
Faltou o volume em /data (etapa Instalar o FlowMestre, passo 5). Com ele configurado, as atualizações não apagam nada.
Mandei mensagem e nada aconteceu
Confira, nesta ordem: o app da Meta está publicado; o webhook foi verificado; você testou de outra conta, já que a própria conta é ignorada; a automação está publicada, não em rascunho. Depois olhe em Configurações → Registros: lá aparece o que aconteceu e como resolver.
Comentei no post e não veio a resposta
Veja em Registros se aparece “não disparou”. Dois motivos comuns: a pessoa está em atendimento humano no Live Chat (as automações ficam pausadas pra ela), ou comentou de novo antes do intervalo de 30 minutos (dá pra mudar em Configurações → Geral).
“Verificar e salvar” do webhook dá erro
O FlowMestre precisa estar no ar no endereço com https, e o token tem que ser idêntico ao IG_VERIFY_TOKEN. Se mudou alguma variável, clique em Implantar antes de verificar de novo.