Contas, equipe e e-mails

O painel do bot é multi-conta. Cada conta é um negócio separado, com o seu WhatsApp, as suas chaves (OpenAI ou Gemini, WuzAPI ou API oficial, Safefy, segredo dos pagamentos), os seus fluxos, conversas, vendas e configurações. Uma conta nunca vê nada de outra.

A primeira conta é a conta da plataforma, que guarda tudo o que existia antes. Os endereços antigos dos webhooks, sem a conta no caminho, continuam valendo para ela.

Criar uma conta (cadastro público)

1. A pessoa abre /cadastro e informa o nome, o nome do negócio, o e-mail e uma senha.
2. Ela recebe um e-mail para confirmar o endereço e clica em "Confirmar e-mail".
3. O administrador da plataforma recebe um e-mail: nova conta aguardando liberação.
4. Em Plataforma, o administrador clica em Liberar. A pessoa recebe um e-mail avisando que o acesso foi liberado.
5. A partir daí ela entra, conecta o WhatsApp dela, coloca as chaves dela e monta os fluxos.

Enquanto a conta não é liberada, ninguém dela entra e nada automático sai. O login explica em que passo a pessoa está: confirmar o e-mail (com reenvio automático do link) ou aguardar a liberação.

Contra abuso

• No máximo 5 cadastros por hora vindos da mesma conexão.
• O e-mail precisa ser confirmado.
• A conta só funciona depois de liberada.
• Um cadastro com um e-mail que já existe não revela isso: o dono do e-mail recebe um aviso.

Plataforma (só para o administrador da plataforma)

A página Plataforma lista todas as contas, com quem é o dono, quantas pessoas e conversas cada uma tem e a situação: e-mail não confirmado, aguardando liberação, liberada ou desativada.

• Liberar: a conta passa a funcionar e o dono é avisado por e-mail.
• Desativar: ninguém da conta entra e nada automático sai pelo WhatsApp dela. Os dados ficam guardados.
• Reativar: desfaz a desativação.

A conta da plataforma não pode ser desativada.

Equipe

Em Equipe, todos veem quem tem acesso à conta. Só os donos podem:

• Convidar alguém por e-mail, como Equipe ou Dono. A pessoa recebe um link que vale por 7 dias, cria a senha e já entra na conta.
• Cancelar um convite pendente.
• Mudar o papel de alguém ou remover alguém (nunca a si mesmo).

Equipe e donos usam o painel do mesmo jeito: conversas, fluxos, configurações e chaves da conta. A diferença é só a gestão das pessoas.

Minha conta e alterar a senha

Em Minha conta (no fim do menu, ou no menu do celular), a pessoa vê o e-mail, a conta e o papel, e pode alterar a senha: informa a senha atual e a nova (pelo menos 10 caracteres). Depois de alterar, todas as outras sessões abertas com a senha antiga são encerradas; a atual continua. Cinco senhas atuais erradas em 15 minutos bloqueiam a troca por um tempo.

Esqueci minha senha

Na tela de login, Esqueci minha senha manda um link que vale por 1 hora e só funciona uma vez. A resposta é a mesma exista ou não o e-mail. Ao criar a nova senha, todas as sessões abertas da pessoa são encerradas.

Avisos por e-mail

Em Configurações → Avisos por e-mail, cada conta escolhe se a equipe recebe:

• Venda confirmada: um e-mail por venda confirmada pelo sistema de pagamento, com o valor e o link da conversa;
• Conversa precisa da equipe: uma vez por conversa, quando ela ganha o aviso de Atenção (cliente pediu alguém, a IA não soube responder...).

Os avisos vão para todas as pessoas da conta com e-mail confirmado.

Configurar o e-mail (Resend)

Os e-mails saem pelo Resend. Nas variáveis do bot no Dokploy, defina:

Variável	Exemplo
RESEND_API_KEY	a chave da API do Resend
EMAIL_FROM	Tesseract <[email protected]> (de um domínio verificado no Resend)

Sem elas, o cadastro público e os convites ficam desligados (as telas explicam isso) e os avisos não saem. Login, esqueci minha senha de quem já existe e todo o resto continuam funcionando.

Endereços de cada conta

Cada conta tem os seus webhooks, com o id da conta no caminho (o painel mostra os endereços certos em Configurações):

Para quê	Endereço
WuzAPI	/api/webhooks/wuzapi/<conta>?key=<chave> (o painel configura sozinho ao conectar)
API oficial da Meta	/api/webhooks/meta/<conta>
Vendas avisadas pelo site da conta	/api/webhooks/payments/<conta>

Cada conta cria o seu próprio usuário na WuzAPI. Só a conta da plataforma usa WUZAPI_URL e WUZAPI_ADMIN_TOKEN das variáveis de ambiente; as outras informam a WuzAPI delas em Configurações.