Recibe interacciones de los usuarios y responde a ellas

En esta página, se describe cómo tu app de Google Chat puede recibir y responder a las interacciones del usuario, también conocida como app de Google Chat eventos de interacción.

Un evento de interacción con la app de Google Chat representa cualquier acción que que el usuario toma para invocar una app de Chat o interactuar con ella, como como @mencionar una app de Chat o agregarla a una espacio. Cuando los usuarios interactúan con una app de Chat, Google Chat envía un evento de interacción a la app de Chat. La app de Chat puede usar el evento para procesar la interacción y crear una respuesta.

Por ejemplo, las apps de Chat usan eventos de interacción para realizar cualquiera de las lo siguiente:

Ejemplo de un evento de interacción Respuesta típica de una app de Chat
Un usuario invoca una app de Chat mediante @mencionarla o usar un comando de barra. El La app de Chat procesa lo que dice el mensaje crear un mensaje. Por ejemplo, una app de Chat responde el comando /about con un mensaje que explica las tareas que que puede hacer la app de Chat.
Un usuario agrega una app de Chat a un espacio. La app de Chat envía una información mensaje en el que se explique qué hace y cómo pueden interactuar los usuarios del espacio que la modifica.
Un usuario quita un App de Chat desde un espacio. El La app de Chat quita las notificaciones entrantes configurados para el espacio (por ejemplo, borrar webhook) y aclara almacenamiento interno.
Un usuario hace clic en un botón de una tarjeta o un diálogo enviado por el App de Chat La app de Chat procesa y almacena que el usuario envió, o bien devuelve otra tarjeta o diálogo.

Para cada tipo de interacción del usuario, Google Chat envía de interacción que ayuda a tu app de Chat a manejar cada según corresponda. Por ejemplo, Google Chat usa el tipo de evento ADDED_TO_SPACE para cualquier interacción en la que un usuario agregue el elemento de Chat a un espacio La app de Chat puede administrar una respuesta, como publicar un mensaje de bienvenida al espacio. Para ver todos los eventos de interacción admitidos, consulta el Referencia de EventType documentación.

En esta página, se describe cómo hacer lo siguiente:

  • Configura tu app de Chat para recibir eventos.
  • Procesa el evento de interacción en tu infraestructura.
  • Si corresponde, responde a los eventos de interacción.

Recibe eventos de interacción con la app de Chat

En esta sección, se describe cómo recibir y procesar eventos de interacción para tu App de Chat

Configura tu app de Chat para recibir eventos de interacción

No todas las apps de Chat son interactivas. Por ejemplo: Los webhooks entrantes solo pueden enviar mensajes salientes y no pueden responder a los usuarios. Si estás creando una app app de Chat, debes elegir un extremo que le permita La app de Chat recibe, procesa y responde a las interacciones eventos. Para obtener más información sobre cómo diseñar tu app de Chat, consulta Arquitecturas de implementación de apps de Chat.

Si creaste una app de Chat interactiva, debes configurar la API de Google Chat para que Google Chat pueda enviarte de interacción:

  1. En la consola de Google Cloud, abre la página de la API de Google Chat:

    Ir a la página de la API de Google Chat

  2. Haz clic en la pestaña Configuración.
  3. En la sección Funciones interactivas, haz clic en el botón de activación Habilitar funciones interactivas.
  4. En Funcionalidad, selecciona una de las siguientes casillas de verificación o ambas:
    1. Recibir mensajes 1:1: Permite que los usuarios interactúen con tu app de Chat en espacios de mensajes directos (MD). Tu app de Chat recibe eventos de interacción cada vez que un usuario envía un mensaje en el espacio de MD.
    2. Unirse a espacios y conversaciones grupales: Permite que los usuarios agreguen y quiten tu app de Chat en espacios con más de una persona. Tu app de Chat recibe eventos de interacción cada vez que se la agrega al espacio o se quita de este, así como cada vez que los usuarios mencionan @o usan un comando de barra en el espacio.
  5. En Configuración de la conexión, especifica a qué lugar Google Chat envía los eventos de interacción con la app de Chat.
  6. Opcional: En Comandos de barra, agrega y configura uno o más comandos de barra. Para obtener más información, consulta Cómo configurar comandos de barra.
  7. Opcional: En Vistas previas de vínculos, agrega y configura uno o más patrones de URL de los que puede obtener una vista previa tu app de Chat. Si deseas obtener más información, consulta Vista previa de vínculos.
  8. Haz clic en Guardar.

Tu app de Chat ya está configurada para recibir interacciones eventos de Google Chat.

Controla los reintentos de llamada HTTP en tu servicio

Si falla una solicitud HTTPS a tu servicio (como un tiempo de espera, una conexión de red o un código de estado HTTPS que no sea 2xx), es posible que Google Chat reintente varias veces en pocos minutos (pero esto no está garantizado). Como resultado, un Chat podría recibir el mismo mensaje varias veces en en ciertas situaciones. Si la solicitud se completa correctamente, pero muestra un resultado no válido carga útil del mensaje, Google Chat no reintentará la solicitud.

Procesa eventos de interacción o responde a ellos

En esta sección, se explica cómo las apps de Google Chat pueden procesar y responder a eventos de interacción.

Después de que tu app de Chat recibe un evento de interacción de Google Chat, pueden responder de muchas maneras. En muchos casos, la interacción Las apps de Chat responden al usuario con un mensaje. La app de Google Chat también puede buscar información en un registrar la información del evento de interacción o simplemente cualquier otra cosa. En esencia, este comportamiento del procesamiento es lo que define la App de Google Chat

Para cada evento de interacción, las apps de Chat reciben un cuerpo de la solicitud. que es la carga útil de JSON que representa el evento. Puedes usar la información útil para procesar una respuesta. Para ver ejemplos de cargas útiles de eventos, consulta Tipos de eventos de interacción con la app de Chat.

En el siguiente diagrama, se muestra cómo La app de Google Chat suele procesar o responder a diferentes tipos de de interacción:

Arquitectura de cómo las apps de Google Chat procesan los eventos de interacción.

Ver respuestas en tiempo real

Los eventos de interacción permiten que las apps de Chat respondan en tiempo real. de forma síncrona. Las respuestas síncronas no requieren autenticación.

Para crear respuestas síncronas a los eventos de interacción, consulta lo siguiente guías:

Para responder de forma síncrona, una app de Chat debe responder dentro de 30 segundos, y la respuesta debe publicarse en el espacio donde interacción existente. De lo contrario, la app de Chat responden de forma asíncrona.

Responde de forma asíncrona

A veces, las apps de Chat deben responder a un evento de interacción después de los 30 días segundos o realizar tareas fuera del espacio donde ocurrió el evento de interacción de red. Por ejemplo, una app de Chat podría necesitar responderán al usuario luego de completar una tarea prolongada. En este caso, Las apps de Chat pueden responder de forma asíncrona llamando a la API de Google Chat.

Para crear un mensaje con la API de Chat, consulta Crea un mensaje. Para guías sobre el uso métodos adicionales de la API de Chat, consulta la Descripción general de la API de Chat.