A Ana

Painel de controle da sua assistente

A Ana
ao vivo

WhatsApp

QR code
  1. Abra o WhatsApp do número da Ana
  2. Toque em Aparelhos conectados → Conectar um aparelho
  3. Aponte a câmera para este QR code
Conectado pela API oficial da Meta (sem QR code).
Webhook:

Resumo

⚠️ Configure a chave da API (Gemini) na aba Configurações.

Últimas mensagens

💬 Escolha uma conversa à esquerda

📨 Recados e pedidos

Quando alguém cadastrado pede “avisa o Rafael que…”, “pergunta pro João se…” ou “agenda pro Matheus…”, a Ana manda a mensagem, espera a resposta e repassa para quem pediu. Tudo aparece aqui.

Novo lembrete ou alarme

Dias da semana

Novo compromisso

Resumo diário — prévia

Escolha um contato e clique em "Ver prévia". Os horários do resumo ficam em Configurações.

Lembretes e alarmes cadastrados

Agenda, finanças e notas

📅 Agenda

💰 Finanças

📝 Notas

Grupos de permissão

A Ana só responde aos números cadastrados aqui. Cada grupo define quais funções seus números podem usar.

🔌 Conexão com o WhatsApp

Como configurar:
  1. No Meta for Developers, crie um app do tipo Business ligado ao seu Business Manager e adicione o produto WhatsApp.
  2. Cadastre e verifique o número da Ana; copie o Phone Number ID. Crie um usuário do sistema no BM e gere um token permanente com as permissões whatsapp_business_messaging e whatsapp_business_management.
  3. Em WhatsApp → Configuração → Webhook, use a URL e o mesmo verify token daqui. Assine o campo messages.
  4. O painel precisa estar num endereço HTTPS público (ex.: o VPS da Hostinger com domínio).
⚠️ Regra da Meta: a Ana só pode mandar mensagem livre até 24h depois da última mensagem da pessoa. Fora disso (lembretes, recados, resumo), ela usa o modelo acima — crie um modelo aprovado com uma variável, ex.: “{{1}}” ou “Aviso da Ana: {{1}}”. Ligações não são recusadas pela API oficial.

Personalidade

🧠 Inteligência artificial

Há uma chave Gemini no arquivo .env — a do painel tem prioridade se preenchida.

Configurações do Claude (opcional)

Há uma chave Anthropic no arquivo .env.

📞 Ligações (tempos em segundos)

📨 Recados (tempos em segundos)

Ex.: a cada 1800 s (30 min), até 3 vezes: “Oi, Rafael! Ainda estou esperando sua resposta sobre o recado do Matheus…”. Quem pede também pode escolher na hora: “pergunta pro Rafael e cobra a cada 10 min”. Depois do tempo de desistir, a Ana avisa quem pediu. Libere a função “📨 Recados” no grupo de quem pode pedir.

☀️ Resumo diário

Nos horários abaixo a Ana manda para cada número (cujo grupo tem "Resumo diário" ligado) tudo o que ele tem para fazer.

🛡️ Anti-ban — comportamento humano (tempos em segundos)

Números desconhecidos

Alterações não salvas

🔐 Guardar / alterar senha

As senhas ficam criptografadas (AES-256). A chave fica em data/vault.key — sem ela não dá para recuperar, então faça backup dela num lugar seguro.

📇 Salvar contato

Senhas guardadas

Contatos salvos

Conectar pela API oficial do WhatsApp (Meta)

Siga as etapas na ordem. Cada etapa fica com ✅ quando estiver pronta. Enquanto você configura, a Ana continua funcionando pelo QR code — só troca na última etapa.

1 Criar o app na Meta e colar o token

  1. Abra developers.facebook.com/apps → Criar app → tipo Empresa → ligue ao seu Business Manager.
  2. No app, adicione o produto WhatsApp. Em WhatsApp → Configuração da API já aparece um token temporário (24h) — serve para testar.
  3. Para valer de vez: em Business Manager → Usuários do sistema, crie um usuário Admin, dê acesso ao app e à conta do WhatsApp e gere um token sem expiração com as permissões whatsapp_business_messaging, whatsapp_business_management e business_management.
  4. App ID e Chave secreta do app ficam em Configurações do app → Básico.

2 Conta do WhatsApp Business e número

➕ Cadastrar um número novo nessa conta

⚠️ O número não pode estar em uso em nenhum WhatsApp (nem no app normal nem no Business). Se estiver, apague a conta do WhatsApp nesse número no celular antes (Configurações → Conta → Apagar conta). Não use o número que hoje está conectado na Ana por QR code, a não ser que queira migrar ele de vez.

3 Verificar e registrar o número

Número de teste da Meta não precisa disso (pode pular). Número real: peça o código, digite e registre.

O PIN é a confirmação em duas etapas do número — anote, ele é pedido se você registrar de novo.

4 Webhook (para a Ana receber as mensagens)

A Meta precisa de um endereço público com https. No VPS: seu domínio (ex.: https://ana.seudominio.com). No PC: um túnel (ex.: cloudflared tunnel --url http://localhost:3000).

5 Modelo de mensagem (lembretes fora das 24h)

Pela regra da Meta, se a pessoa não falou com a Ana nas últimas 24h, só dá para mandar um modelo aprovado. Este botão cria o modelo aviso_ana (categoria Utilidade). A aprovação costuma levar de minutos a algumas horas.

6 Testar e ativar

Com número de teste da Meta, cadastre antes o seu número em WhatsApp → Configuração da API → Para.