wvuhskr/lsa-responsiveness-tracker

Rastreador de Capacidad de Respuesta LSA

Use la CLI empaquetada como la única autoridad para la ingesta, métricas y generación de informes. El resultado es un proxy de tiempo de respuesta y estado de clientes potenciales, no la cifra oficial de capacidad de respuesta de Google LSA. La sincronización de mensajes es precisa cuando los eventos requeridos están completos; el estado de teléfono conectado es aproximado.

Lea el contrato del conector antes de recopilar datos. Use el runbook para archivos privados, comandos CLI, significados de salida y recuperación.

Flujo de Trabajo

1. Descubra un conector activo por capacidad, no por proveedor o nombre de herramienta. Debe ejecutar GAQL sin procesar contra local_services_lead_conversation, aceptar un cliente seleccionado y devolver filas completas con evidencia de paginación. No se admiten conectores solo de agregación.
2. Inspeccione el esquema de la herramienta activa. Identifique sus argumentos de consulta y cliente, el argumento opcional de administrador o ID de cliente de inicio de sesión, y los argumentos de paginación. No adivine nombres de argumentos.
3. Enumere o identifique cuentas accesibles si el conector admite el descubrimiento de cuentas. De lo contrario, solicite al usuario el ID del cliente y, solo cuando lo requiera el esquema, el ID del cliente de inicio de sesión. Nunca coloque identificadores o credenciales en esta habilidad, archivos rastreados o salida del chat.
4. Ejecute una pequeña sonda de acceso para la cuenta seleccionada. Deténgase y proporcione orientación de recuperación si la autenticación, selección de cliente, acceso a recursos o paginación no están disponibles.
5. Ejecute una sonda de recursos requeridos y campos usando los campos exactos del contrato. Solicite el campo opcional de texto del mensaje solo cuando el usuario haya optado explícitamente. Deténgase si el resultado es solo de agregación, carece de las columnas devueltas requeridas, informa un error, es parcial o está incompleto.
6. Ejecute la consulta de informes acotada y drene cada página, preservando los metadatos de columna devueltos y la cadena de tokens de página. Un resultado guardado completo del conector es aceptable solo con evidencia de finalización explícita y veraz. Guarde las respuestas sin procesar y el manifiesto directamente en archivos locales privados; nunca pegue filas reales en el chat.
7. Invoque el comando CLI probe en cada respuesta guardada. No continúe después de una salida distinta de cero; siga la acción de recuperación del runbook.
8. Invoque el comando CLI report con la configuración privada y un directorio de salida privado. Presente el informe generado y repita las advertencias sobre proxy, mensajes y teléfono.

Nunca calcule un porcentaje de respaldo ni duplique las fórmulas de métricas. Nunca resuma los valores de filas privadas en el chat. Nunca exponga credenciales, tokens de acceso, identificadores de cliente, texto de mensajes o nombres de archivos de entrada/salida del conector en el chat. Los recibos de instalación pueden contener solo las rutas del paquete y la CLI definidas por el instalador, nunca datos del conector.

Trate una cuenta LSA migrada a una campaña de pago por cliente potencial de Performance Max como no verificada hasta que esa cuenta pase la sonda de acceso en vivo, la sonda de campos requeridos, las comprobaciones de paginación y la sonda CLI. La herramienta está diseñada para la transición porque lee recursos de conversación de clientes potenciales de la API de Google Ads en lugar del panel independiente en retirada, pero no prometa una compatibilidad posterior a la migración sin cambios sin esa validación directa.