wvuhskr/lsa-responsiveness-tracker

LSA Responsiveness Tracker

Use o CLI empacotado como a única autoridade para ingestão, métricas e geração de relatórios. O resultado é um proxy de tempo de resposta e status de lead, não o valor oficial de responsividade do Google LSA. O tempo das mensagens é preciso quando os eventos necessários estão completos; o status de telefone conectado é aproximado.

Leia o contrato do conector antes de coletar dados. Use o runbook para arquivos privados, comandos CLI, significados de saída e recuperação.

Fluxo de Trabalho

1. Descubra um conector ativo por capacidade, não por provedor ou nome da ferramenta. Ele deve executar GAQL bruto contra local_services_lead_conversation, aceitar um cliente selecionado e retornar linhas completas com evidência de paginação. Conectores apenas de agregação não são suportados.
2. Inspecione o esquema da ferramenta ativa. Identifique seus argumentos de consulta e cliente, argumento opcional de gerente ou login-customer e argumentos de paginação. Não adivinhe nomes de argumentos.
3. Liste ou identifique contas acessíveis se o conector suportar descoberta de contas. Caso contrário, pergunte ao usuário pelo ID do cliente e, apenas quando exigido pelo esquema, pelo ID login-customer. Nunca coloque identificadores ou credenciais nesta skill, em arquivos rastreados ou na saída do chat.
4. Execute um pequeno teste de acesso para a conta selecionada. Pare e forneça orientação de recuperação se autenticação, seleção de cliente, acesso a recursos ou paginação não estiverem disponíveis.
5. Execute um teste de recurso e campo obrigatórios usando os campos exatos do contrato. Solicite o campo opcional de texto da mensagem apenas quando o usuário tiver optado explicitamente. Pare se o resultado for apenas de agregação, faltar colunas obrigatórias retornadas, reportar um erro, for parcial ou incompleto.
6. Execute a consulta de relatório limitada e drene cada página, preservando os metadados das colunas retornadas e a cadeia de tokens de página. Um resultado salvo completo do conector é aceitável apenas com evidência de conclusão explícita e verdadeira. Salve as respostas brutas e o manifesto diretamente em arquivos locais privados; nunca cole linhas reais no chat.
7. Invoque o comando CLI probe em cada resposta salva. Não continue após uma saída diferente de zero; siga a ação de recuperação do runbook.
8. Invoque o comando CLI report com a configuração privada e um diretório de saída privado. Apresente o relatório gerado e repita as ressalvas de proxy, mensagem e telefone.

Nunca calcule uma porcentagem substituta ou duplique as fórmulas de métricas. Nunca resuma valores de linhas privadas no chat. Nunca exponha credenciais, tokens de acesso, identificadores de cliente, texto de mensagens ou nomes de arquivos de entrada/saída do conector no chat. Os recibos de instalação podem conter apenas os caminhos do pacote e CLI definidos pelo instalador, nunca dados do conector.

Trate uma conta LSA migrada para uma campanha Performance Max de pagamento por lead como não verificada até que essa conta passe pelo teste de acesso ativo, teste de campo obrigatório, verificações de paginação e teste CLI. A ferramenta foi projetada para a transição porque lê recursos de lead-conversation da API Google Ads em vez do painel independente que está sendo descontinuado, mas não prometa compatibilidade inalterada pós-migração sem essa validação direta.