Agentes de IA conectados ao painel

É a tela Agentes de IA, no menu lateral do painel. Ela ensina a conectar um agente de IA — o Claude, o ChatGPT ou outro agente — aos dados das campanhas, para o usuário fazer perguntas em linguagem natural, como "quanto vendemos pelo WhatsApp este mês, por rede?".

Todo usuário do painel vê esse item de menu: o acesso concedido é dele, com as permissões dele. A mesma tela lista os apps conectados e os tokens que o usuário criou, e é por ela que ele desconecta ou revoga um acesso.

O que o agente enxerga

O agente só lê números agregados das campanhas — cadastros, notas, valores, rankings. Ele não vê nenhum dado pessoal de participante e não altera nada no painel. Ele age com as mesmas permissões do usuário que o conectou, e precisa que esse usuário tenha a permissão de ler campanhas.

Os três caminhos de conexão

A tela mostra o endereço do conector, com um botão para copiar, e o passo a passo de cada agente:

• Claude (claude.ai ou app): adicionar um conector personalizado com o nome Premify e o endereço da tela, clicar em conectar, fazer login no painel e permitir. Na conversa, ligar o Premify no botão de ferramentas.
• ChatGPT (planos pagos): ligar o modo de desenvolvedor nas configurações de apps e conectores, criar o conector Premify com o endereço da tela e autenticação OAuth, fazer login no painel e permitir. Na conversa, ativar o Premify ao lado da mensagem.
• Claude Code e outros agentes: gerar um token na própria tela e usar o comando pronto que ela mostra.

Os nomes dos menus do Claude e do ChatGPT podem mudar com as versões deles, e a própria tela avisa isso.

A tela de permitir a conexão

Quando o Claude ou o ChatGPT pede a conexão, o painel abre a tela Conectar agente de IA. Ela mostra qual agente está pedindo, com qual usuário, e para onde o acesso volta. Também resume o que o agente poderá fazer: só leitura de números agregados, nenhum dado pessoal de participante, as mesmas permissões do usuário, e que dá para desconectar a qualquer momento em Agentes de IA.

O usuário escolhe Permitir ou Recusar. A tela orienta a só permitir se foi ele mesmo quem pediu a conexão agora, naquele agente. Se o usuário não tem a permissão de ler campanhas, a tela avisa que o agente conectaria mas não conseguiria consultar nada.

Apps conectados e tokens

O bloco "Apps conectados e tokens" lista os acessos do usuário, com nome, início do token, data de expiração, último uso e situação (Ativo, Vencido ou Revogado). Os agentes conectados pelo login aparecem como "App conectado".

Para um agente que pede token, o usuário informa um nome (por exemplo, "Claude do notebook") e a validade — 30, 90, 180 ou 365 dias — e clica em Gerar token. O token aparece uma única vez: a tela pede para copiar na hora, porque ele não aparece de novo.

Desconectar um app ou revogar um token tira o acesso na hora. Para voltar, o app precisa ser conectado de novo pelo próprio agente, e o token precisa ser gerado outra vez — revogar não tem desfazer.

Agentes de IA é uma forma de consultar os números das campanhas conversando com o Claude ou o ChatGPT. Cinco orientações:

O agente só lê números agregados. Ele não vê CPF, e-mail nem nome de participante, e não muda nada no painel.

Cada pessoa conecta o próprio agente com o próprio usuário. O agente enxerga o mesmo que essa pessoa enxerga no painel — se ela não pode ler campanhas, o agente não consegue consultar nada.

No Claude e no ChatGPT, o caminho é o conector com login: o painel abre uma tela pedindo para permitir. No Claude Code e em outros agentes, o caminho é o token.

O token aparece uma vez só. Quem perdeu o token gera outro e revoga o antigo.

Para cortar um acesso, basta Desconectar ou Revogar na tela Agentes de IA. O efeito é imediato.

• Falha: o agente conectou mas não consegue consultar nada.
• Possivel causa: o usuário que conectou não tem a permissão de ler campanhas. O agente age com as mesmas permissões dele.
• Como orientar: oriente o Master a marcar a permissão de ler campanhas no role do usuário e peça para conectar de novo.
• Quando escalar: se o usuário tiver a permissão e o agente continuar sem resposta, abrir issue no Jira (projeto DEV) com as evidências e o nome do agente.

• Falha: o usuário perdeu o token gerado.
• Possivel causa: o token só aparece uma vez, no momento em que é criado.
• Como orientar: oriente a gerar um token novo na tela Agentes de IA e revogar o antigo na lista.
• Quando escalar: não é falha.

• Falha: o agente parou de funcionar de repente.
• Possivel causa: o token venceu ou foi revogado, ou o app foi desconectado. A situação aparece na lista de apps conectados e tokens.
• Como orientar: confira a situação na tela. Se estiver Vencido ou Revogado, gere um token novo ou conecte o app de novo pelo próprio agente.
• Quando escalar: se a situação estiver Ativo e o agente continuar recusando, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o cliente pergunta se o agente pode ver dados pessoais dos participantes.
• Possivel causa: dúvida sobre privacidade.
• Como orientar: explique que o agente só lê números agregados das campanhas, sem nenhum dado pessoal de participante, e que o acesso pode ser cortado a qualquer momento.
• Quando escalar: não é falha. Se o cliente relatar dado pessoal aparecendo numa resposta do agente, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o passo a passo da tela não bate com os menus do Claude ou do ChatGPT.
• Possivel causa: os nomes dos menus desses agentes mudam com as versões deles.
• Como orientar: procure nas configurações do agente a área de conectores ou apps e siga a mesma lógica: nome Premify, o endereço copiado da tela e login no painel.
• Quando escalar: se a conexão não completar mesmo seguindo os passos, abrir issue no Jira (projeto DEV) com prints da tela do agente.