Verificaciones de estado

Google supervisa las acciones implementadas para verificar que estén disponibles y que respondan a las solicitudes de los usuarios.

El extremo de cada Acción debe responder a un valor predeterminado, sin invocación de parámetros. Esto admite la situación en la que el usuario solicita hablar con una Acción sin proporcionar información adicional (por ejemplo, "Quiero hablar con nombre de la invocación").

Preguntas frecuentes

¿Debo implementar algo específico para respaldar las verificaciones de estado?

No. Las verificaciones de estado de las acciones funcionarán como una solicitud estándar para comunicarse con una acción.

¿Con qué frecuencia se verifica el estado de mi Acción?

Es posible que se supervise tu Acción durante el día.

¿Cómo puedo detectar que una solicitud es una verificación de estado?

Si usas Actions Builder como tu plataforma de desarrollo, recibirás una solicitud de verificación de estado similar al siguiente fragmento:

{
  "handler": {
    "name": "actions.handler.HEALTH_CHECK"
  },
  "intent": {
    "name": "actions.intent.HEALTH_CHECK"
  },
  "session": {
    "id": "actions.session.HEALTH_CHECK"
  },
  "user": {
    "locale":"en-US"
  },
  "device": {
    "capabilities": []
  }
}
  

Cuando recibes esta solicitud, debes responder con un código de respuesta 200; de lo contrario, tu Acción se considera en mal estado. El siguiente fragmento es un ejemplo de una respuesta con el formato correcto:

  {"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}

Si usas Dialogflow como tu plataforma de desarrollo, Google agrega un argumento "is_health_check" y lo pasa al intent. Este argumento se encuentra en el objeto Input de la solicitud de webhook:

{
  ...
  "originalDetectIntentRequest": {
    ...
    "payload": {
      ...
      "inputs": [{
        ...
        "arguments": [{
          "name": "is_health_check",
          "boolValue": true,
          "textValue": "1"
        }]
      }],
      ...
    }
  }
}
  

¿Qué sucede si Google detecta una Acción en mal estado? Si Google detecta que la acción está experimentando una interrupción, se suspenderá. Los usuarios que soliciten la acción en mal estado escucharán "ACTION_NAME no está disponible".

¿Cómo se me notificará si una acción se marca como en mal estado? Cuando Google detecta una Acción en mal estado, enviamos una notificación por correo electrónico al desarrollador principal asociado con el proyecto de Acciones.

¿Qué sucede si mi Acción que usa la vinculación de cuentas se marca como en mal estado? A diferencia de otras acciones, las que usan la vinculación de cuentas no se suspenden después de que Google las declara en mal estado. Los usuarios aún podrán acceder a tu acción durante 7 días después de que recibas el correo electrónico de notificación. Sin embargo, si no solucionaste el problema de vinculación de cuentas después de 7 días, se eliminará tu Acción.

¿Cómo puedo verificar el estado de mi Acción? Puedes revisar tu consola para desarrolladores y ver el estado de tu Acción. Las acciones en mal estado tendrán el estado En mal estado. Las acciones de buen estado se marcarán como Implementada.

¿Cuál es el proceso para mostrar una Acción al estado implementada? Debes revisar tu implementación y solucionar cualquier problema que pueda causar que la acción no responda a un intent de inicio.

Google seguirá supervisando periódicamente el estado de la Acción mientras esté en mal estado. Cuando Google detecta que la acción responde como se espera, esta volverá al estado implementado.