Avaliações no piloto automático

1. Como funciona

1. De 30 em 30 minutos, o n8n olha os perfis

   Para cada cliente ativo na planilha de configuração, busca as avaliações mais recentes e separa as que ainda não têm resposta.

2. Separa pela nota

   Cada cliente tem um limite, combinado com ele. O padrão é 4: de 4 estrelas pra cima é "boa", abaixo de 4 é "alerta".

3. Avaliação boa: responde sozinho

   O Claude escreve uma resposta curta, no tom da ficha de marca do cliente, citando o que a pessoa elogiou. O n8n publica no Google e registra na planilha.

4. Avaliação ruim: avisa e espera

   Chega no Telegram (ou e-mail) do responsável a avaliação, a nota e um rascunho de resposta, com os botões Aprovar e Recusar. Aprovou, publica. Recusou, ninguém responde pelo robô e a Conexão trata na mão.

5. Todo mês, o relatório

   Quantas avaliações entraram, média de nota, quantas foram respondidas e em quanto tempo, e quais viraram alerta. É isso que o cliente vê e o que justifica a mensalidade.

2. As regras do robô

Vão escritas dentro do fluxo e valem para todo cliente. A resposta fica pública para sempre, com o nome do cliente embaixo.

3. Preparar

1. Credencial do Google no n8n

   No projeto do Google Cloud da Conexão (o mesmo do passo a passo), crie mais um ID do cliente OAuth, agora do tipo Aplicativo da Web. Em "URIs de redirecionamento autorizados", cole o endereço que o n8n mostra ao criar uma credencial Google OAuth2 API. Na credencial do n8n, use o escopo https://www.googleapis.com/auth/business.manage e faça o login com a conta da operação.

   Por que outro ID. O do VS Code é "App para computador". O n8n roda num servidor e precisa do tipo "Aplicativo da Web". Os dois convivem no mesmo projeto.

2. Chave da IA

   A automação precisa de uma chave de API própria da Conexão (em console.anthropic.com), separada da assinatura do Claude que você usa no VS Code. Use o modelo mais barato, o Haiku: escrever uma resposta de avaliação custa centavos. Ponha um limite de gasto mensal no console.

3. Planilha de configuração

   Uma linha por cliente. É ela que liga e desliga o serviço sem mexer no fluxo.

   Coluna	Exemplo
   cliente	Ponte
   perfil	accounts/123/locations/456 (o Claude descobre pra você)
   ativo	sim
   modo	rascunho (tudo vai pra aprovação) ou automatico
   limite	4
   tom	resumo de 3 linhas da ficha de marca
   assinatura	Equipe Ponte
   avisar	chat do Telegram ou e-mail de quem aprova

   copiar

   Use a Business Profile API (o login que fizemos no passo a passo do Perfil do Google) pra listar todos os perfis que a Conexão administra, com o caminho completo de cada um no formato accounts/.../locations/.... Depois crie uma planilha de configuração com as colunas cliente, perfil, ativo, modo, limite, tom, assinatura e avisar. Preencha cliente e perfil, ponha ativo=nao, modo=rascunho e limite=4 em todos, e resuma em 3 linhas o tom de cada cliente a partir da ficha de marca em clientes/[cliente]/marca. Me mostre antes de salvar.

4. Aceite do cliente

   Responder em nome do cliente precisa estar no contrato ou num aceite por escrito: o que o robô responde sozinho, o que vai pra aprovação e quem aprova. Mande junto um exemplo de resposta boa e de resposta a uma reclamação, pra ele validar o tom.

4. Montar no n8n

O Claude Code escreve o fluxo e você importa no n8n. Peça em partes, testando cada uma.

1. Gerar o fluxo

   copiar

   Monte um workflow do n8n (JSON pronto pra importar) chamado "Avaliações Google · Conexão":
   
   1) Schedule Trigger a cada 30 minutos.
   2) Lê a planilha de configuração [link] e segue só com as linhas ativo=sim.
   3) Pra cada cliente, HTTP Request GET https://mybusiness.googleapis.com/v4/{perfil}/reviews?pageSize=50&orderBy=updateTime%20desc usando a credencial Google OAuth2 API "Google Conexão".
   4) Filtra as avaliações sem o campo reviewReply. Converte starRating (ONE..FIVE) em número.
   5) Grava na aba "registro" e pula as que já estão lá (pelo name da avaliação), pra nunca tratar a mesma duas vezes.
   6) Nó do Anthropic (modelo Haiku, credencial "Claude Conexão") escreve a resposta com as regras: até 60 palavras, citar algo específico do comentário, tom da coluna tom, assinar com a coluna assinatura, sem desconto ou brinde, sem repetir dado pessoal, sem discutir, sem inventar promessa. Sem comentário = agradecimento curto. Se o comentário vier com "(Translated by Google)", responder em português.
   7) Se modo=automatico E nota >= limite: PUT https://mybusiness.googleapis.com/v4/{name da avaliação}/reply com {"comment": resposta}.
   8) Senão: nó do Telegram "Send and Wait for Response" com aprovação (Aprovar / Recusar) pro chat da coluna avisar, mostrando cliente, nota, comentário e rascunho. Aprovou, faz o PUT do passo 7. Recusou, marca "tratar na mão" no registro.
   9) Atualiza a aba "registro": cliente, data da avaliação, nota, comentário, resposta, como saiu (automática, aprovada, recusada) e horário.
   
   Deixe nomes claros nos nós, notas explicando cada parte, e nenhuma chave escrita dentro do JSON. Depois me explique como importar e como testar com um cliente só.

2. Importar e ligar as credenciais

   No n8n: Workflows › Import from File. Em cada nó que pedir credencial, escolha a do Google, a do Claude e a do Telegram.

3. Testar com um cliente só, em modo rascunho

   Na planilha, ponha ativo=sim e modo=rascunho em um único cliente, de preferência o perfil da própria Conexão. Rode o fluxo na mão. Todas as avaliações sem resposta devem chegar no Telegram para aprovar. Aprove uma e confira no Google que a resposta apareceu.

4. O relatório do mês

   copiar

   A partir da aba "registro" da planilha de avaliações, monte o relatório de [mês] do [cliente]: avaliações recebidas, média de nota e comparação com o mês anterior, quantas foram respondidas e o tempo médio até a resposta, quantas viraram alerta e o que foi feito com cada uma, e 3 trechos de elogio pra usar em conteúdo (só com autorização do cliente). Uma página, linguagem de dono de negócio.

5. Fase 2: manter o perfil atualizado

Depois que as avaliações estiverem rodando, o mesmo n8n cuida do resto do perfil. Vale como segundo degrau do pacote.

6. Portão antes de ligar o automático

Cada cliente só passa para modo=automatico quando tudo isto estiver feito:

• Duas semanas em modo rascunho, com as respostas aprovadas sem precisar editar quase nenhuma.
• Cliente aprovou por escrito o modelo de resposta e o limite de estrelas.
• O registro mostra que a mesma avaliação nunca foi tratada duas vezes.
• O alerta de avaliação ruim chega para quem aprova, em menos de uma hora.
• Limite de gasto ligado no console da IA.
• Cliente de saúde ou jurídico: fica em rascunho até validar com ele as regras do conselho.

7. Virar serviço da Conexão

Pode ser um pacote próprio ou somar ao pacote Presença no Google e nas IAs da aula 7. Preencha com a gente: fica salvo neste navegador e vai junto quando você enviar a trilha.

8. Erros comuns

9. Trilha

Marque quando cumprir o "pronto quando".

• Credenciais no n8nPronto quando: Google, Claude e Telegram conectados sem erro.
• Planilha de configuraçãoPronto quando: todos os clientes com perfil estão nela, em modo rascunho.
• Fluxo importado e testadoPronto quando: uma avaliação aprovada no Telegram apareceu respondida no Google.
• Primeiro cliente no automáticoPronto quando: passou pelo portão da seção 6.
• Pacote no papelPronto quando: a seção 7 está preenchida e a proposta foi para o primeiro cliente.