Google Chat

Coloque um agente do Pepe no Google Chat para sua equipe falar com ele em espaços e mensagens diretas.

Google Chat

Conectar o Google Chat permite que as pessoas falem com o agente nos espaços e nas mensagens diretas. O Google Chat entrega cada mensagem na URL de retorno do Pepe; configure a conexão pela configuração guiada (ou pelo painel):

pepe setup

O config de uma conexão contém:

• access_token: um token OAuth para a Chat API, usado como bearer nas respostas. Guarde como ${ENV_VAR} e renove por fora.
• project_number: o número do projeto do Cloud em que o app do Chat está registrado. Na página de configuração do app do Chat, defina Authentication Audience como Project Number. A outra opção (HTTP endpoint URL) envia um token com formato diferente, que o Pepe não valida, então toda mensagem recebida seria rejeitada.

Só eventos MESSAGE de uma pessoa são atendidos. As respostas são publicadas de volta no espaço pela Chat REST API. Formato da URL de retorno:

https://YOUR_HOST/webhooks/default/googlechat/<slug>

Autenticação de entrada

O Pepe confere que cada requisição recebida veio mesmo do Google antes de o agente ver qualquer coisa: cada requisição traz um token assinado pelo Google no Authorization: Bearer, e o Pepe o valida (assinatura contra as chaves publicadas pelo Google, emissor e uma audiência igual a project_number). Assim o endpoint aceita POSTs direto do Google, sem precisar de um proxy que valide. Se o seu proxy já faz essa checagem, defina trust_proxy: true na conexão para pular a do Pepe.

Veja Webhooks para os campos compartilhados por toda conexão (agent, mode, trainers, session_ttl_min, ephemeral, commands) e como a rota genérica funciona por baixo dos panos.

Trocando de modelo

Os comandos /model e /models deixam as pessoas ver ou trocar qual modelo de IA responde a elas. Eles só funcionam numa conexão em modo admin com commands habilitado; no support, são tratados como texto comum. /models lista os modelos disponíveis para o projeto dessa conexão; /model mostra o atual, ou troca:

/model openrouter               # pergunta se troca só esse chat ou todos
/model openrouter session       # troca só para esta conversa
/model openrouter global        # troca para todos com quem essa conexão fala

Qualquer pessoa numa conversa permitida pode trocar o modelo da própria conversa. Trocar globalmente, para todos com quem essa conexão fala, é reservado aos treinadores, a mesma lista de confiança que controla a memória. Defina model_switch_locked: true na conexão para desativar totalmente a troca de modelo por quem não é treinador.