Como conectar e usar o Fixei Connect
1. Antes de começar
Você vai precisar de quatro coisas:
- O app WhatsApp Business no celular, versão 2.24.17 ou mais nova. Não serve o WhatsApp comum (pessoal). Se o número da empresa está no WhatsApp comum, instale o WhatsApp Business pela loja do celular, abra e confirme o mesmo número: o próprio app oferece trazer as conversas.
- Uma conta no Facebook, que é usada para entrar na Meta durante a conexão.
- Um portfólio empresarial da Meta (o antigo Gerenciador de Negócios) em business.facebook.com. Para criar: entre com o seu Facebook, clique em criar conta/portfólio e informe o nome da empresa, o seu nome e um e-mail comercial. Criar antes deixa a conexão mais rápida.
- A assinatura do Fixei Connect: 7 dias grátis com cartão cadastrado, cobrança só no 8º dia.
2. Conectar o número
- Entre em fixei.io/connect, crie sua conta e assine o teste grátis.
- No painel, clique em Conectar com a Meta. Abre uma janela da Meta; se nada aparecer, permita pop-ups para fixei.io no navegador.
- Entre com o seu Facebook e escolha o portfólio empresarial (ou crie um ali mesmo).
- Quando a Meta perguntar, escolha conectar o app WhatsApp Business que você já usa e informe o número.
- No celular, abra o WhatsApp Business: aparece o pedido para conectar à plataforma empresarial. Confirme, escolha se quer compartilhar o histórico de conversas e siga as instruções na tela.
- Volte ao painel: o número aparece com "API oficial Meta". A partir daqui, as mensagens novas já chegam ao Connect.
- Abra o WhatsApp Business no celular pelo menos a cada 14 dias. Depois de 14 dias sem abrir, a Meta desfaz a ligação entre o app e a API.
- No app, a Meta desliga mensagens temporárias, visualização única, localização em tempo real e listas de transmissão.
- Grupos não aparecem no Connect: só conversas individuais.
3. Importar o histórico
Sem importar, o seu agente vê só as mensagens recebidas e enviadas a partir da conexão. Para trazer o passado:
- No painel, clique em Importar histórico do WhatsApp e confirme.
- A Meta envia as conversas dos últimos 180 dias aos poucos; elas aparecem em Conversas conforme chegam. O Connect guarda o texto; fotos, áudios e documentos aparecem como "[imagem]", "[áudio]" etc.
4. Conectar seu agente
Todos os agentes usam o mesmo endereço: https://fixei.io/mcp. Na primeira vez, o agente abre o navegador para você entrar no Fixei Connect e escolher as permissões.
Claude
Em Personalizar → Conectores, procure Fixei Connect no diretório, clique em Conectar e autorize. Também dá para adicionar um conector personalizado com a URL acima.
ChatGPT
Na área de conectores/apps, adicione um conector com a URL acima (dependendo do plano, a opção fica no modo desenvolvedor) e autorize.
Codex ou Claude Code no seu computador
codex mcp add fixei --url https://fixei.io/mcp
codex mcp login fixeiclaude mcp add --transport http fixei https://fixei.io/mcpNo Claude Code, depois rode /mcp e escolha autenticar.
Codex ou Claude Code em um servidor remoto
Se o agente roda em outro computador (um servidor, ou o VS Code conectado por SSH), o login pelo navegador não consegue voltar até ele. Use um token:
- No painel, em Visão geral → Conectar um agente, abra a aba "Servidor remoto (token)", clique em Gerar token e copie o token (ele aparece uma única vez; revogue em Conexões).
- No servidor:
ou, no Claude Code:codex mcp add fixei --url https://fixei.io/mcp --bearer-token-env-var FIXEI_CONNECT_TOKEN echo 'export FIXEI_CONNECT_TOKEN=fxc_...' >> ~/.bashrcclaude mcp add --transport http fixei https://fixei.io/mcp --header "Authorization: Bearer fxc_..." - Reinicie o agente (ou recarregue a janela do VS Code) para ele ler o token.
Permissões
- Ler conversas: sempre incluída.
- Permitir preparar e enviar texto após minha aprovação: o agente prepara a resposta e você aprova cada envio.
- Enviar sem minha aprovação: opcional, desligada por padrão. O agente envia direto, até 30 por hora, sempre dentro da janela de 24 horas. Use só com agentes em que você confia.
Não deixe o agente treinar com as conversas
Pelos termos da Meta, as conversas do WhatsApp Business não podem ser usadas para treinar ou melhorar modelos de IA. Antes de conectar, desligue essa opção no seu agente:
- ChatGPT: Configurações → Controles de dados → desligue Melhorar o modelo para todos (Improve the model for everyone). Nos planos Business e Enterprise isso já vem desligado.
- Claude: Configurações → Privacidade → desligue a opção de usar suas conversas para melhorar o Claude (aparece como Ajudar a melhorar o Claude, Help improve Claude ou nome parecido). Nos planos comerciais (Team e Enterprise) as conversas não são usadas para treino.
- Outros agentes: confira nas configurações de privacidade se as conversas são usadas para treinar o modelo e desligue.
5. Usar no dia a dia
- Conversas: no menu do painel, veja as conversas com nome e número, e se a janela de resposta está aberta.
- Peça ao agente: "Quem ainda não foi respondido hoje?", "Resuma a conversa com a Ana", "Prepare uma resposta para o João".
- Aprovar: quando o agente prepara uma mensagem, ela aparece em Aguardando sua aprovação na Visão geral e dentro da conversa, com o nome do agente e o prazo. Clique em Aprovar (ou Descartar); depois peça ao agente para enviar. A aprovação vale 10 minutos; se passar, peça para preparar de novo.
- Janela de 24 horas: pela regra da Meta, só dá para responder a quem mandou mensagem nas últimas 24 horas.
- Conexões: lista dos agentes e tokens com acesso, permissões, último uso e os revogados nos últimos 90 dias. "Revogar" (ou "Revogar todos") corta o acesso na hora e descarta os rascunhos não enviados.
- Desconectar (em Conexões, no número conectado): revoga todos os agentes e para de guardar mensagens novas. Não apaga o que já foi guardado nem cancela a assinatura.
- Gerenciar assinatura: troque o cartão ou cancele pelo portal da Stripe.
- Número e dados (no fim da Visão geral): importe o histórico nas primeiras 24h, exporte seus dados, use Apagar conversas para apagar conversas e envios guardados (a conexão e os agentes continuam) ou exclua a conta quando quiser.
6. Problemas comuns
O login do agente abre, eu autorizo e nada acontece
Quase sempre o agente roda em outro computador (servidor remoto). Use um token, como em Conectar seu agente.
As mensagens não aparecem
Confira se o número aparece como "API oficial Meta" no painel e mande uma mensagem de teste de outro celular. Se o WhatsApp Business ficou mais de 14 dias sem ser aberto, abra o app e conecte de novo.
"Aprovação expirada ou já utilizada"
A aprovação vale 10 minutos. Peça ao agente para preparar a mensagem de novo e aprove logo em seguida.
O agente diz que a janela está fechada
O cliente não mandou mensagem nas últimas 24 horas. Pela regra da Meta, só ele pode reabrir a conversa.
A janela da Meta não abre
Permita pop-ups para fixei.io e tente de novo.
Perguntas frequentes
Como conectar o ChatGPT ao meu WhatsApp?
Com o Fixei Connect: assine em fixei.io/connect, conecte o número do WhatsApp Business pela Meta e adicione o conector https://fixei.io/mcp no ChatGPT. O ChatGPT passa a ler suas conversas e preparar respostas, e você aprova cada envio.
Como usar o Claude com o WhatsApp Business?
No Claude, em Configurações → Conectores, adicione um conector personalizado com a URL https://fixei.io/mcp, entre com sua conta Fixei e escolha as permissões.
Existe um servidor MCP para WhatsApp?
Sim. O Fixei Connect é um servidor MCP remoto para o WhatsApp Business, em https://fixei.io/mcp, com login OAuth. Funciona com ChatGPT, Claude, Codex, Claude Code, Cursor, VS Code e outros clientes MCP.
Funciona com o WhatsApp pessoal?
Não. Só com o WhatsApp Business, pela API oficial da Meta.
Precisa de ajuda?
Fale com a gente pelo WhatsApp ou pelo e-mail contato@fixei.com.br. Para assistentes de IA, há um resumo em texto em llms.txt.
Suporte no WhatsApp · (11) 4097-8010