Trabaja con eventos de Google Chat

En esta página, se explica cómo las apps de Google Chat pueden recibir y responder eventos en Google Chat.

Un evento de Google Chat representa una actividad o un cambio en Chat, como un mensaje nuevo en un espacio. Tu app de Chat puede usar eventos para comprender lo que sucedió y tomar medidas o responder de manera significativa para los usuarios.

Estos son algunos ejemplos de cómo puedes usar los eventos:

• Supervisa y responde mensajes nuevos en un espacio, por ejemplo, revisa palabras o frases clave.
• Envía un mensaje de bienvenida a los usuarios a medida que se unan al espacio para explicarles los lineamientos del espacio o compartir sugerencias sobre cómo usar la app de Chat de manera efectiva.
• Hacer un seguimiento de la actividad de Chat y analizarla Por ejemplo, para enviar un informe mensual sobre miembros nuevos o los mensajes que obtienen la mayor cantidad de reacciones o respuestas.
• Comunícate entre plataformas de mensajería. Por ejemplo, los usuarios pueden enviar y recibir mensajes de usuarios de una plataforma de mensajería diferente sin salir de Chat.

Cómo funcionan los eventos

Cada vez que sucede algo en Google Chat, se crea, actualiza o borra un recurso de la API de Google Chat. Los eventos entregan información sobre cuándo ocurrió la actividad y el recurso de la API de Chat que se vio afectado.

Chat categoriza los eventos por tipo. Los tipos de eventos te ayudan a filtrar y solicitar solamente el tipo de información que necesitas, y te permiten controlar eventos similares de la misma manera.

En la siguiente tabla, se muestra cómo una actividad en Chat afecta a un recurso relacionado de la API de Chat y el tipo de evento que recibe tu app de Chat:

Actividad	Recurso de la API de Chat	Tipo de evento
Un usuario publica un mensaje en un espacio de Chat	Se crea un recurso Message.	Mensaje nuevo
Un usuario se convierte en administrador del espacio.	Se actualiza un recurso Membership.	Se actualizó la membresía
Un usuario reacciona a un mensaje.	Se crea un recurso Reaction.	Reacción nueva
Un usuario abandona un espacio.	Se borró un recurso Membership.	Membresía borrada

Nota: Tu app de Chat también puede recibir eventos de interacción. Estos eventos te ayudan a responder a las interacciones directas de los usuarios, como cuando un usuario agrega tu app de Chat a un espacio o @menciona tu app de Chat. Para configurar y recibir eventos de interacción, consulta Recibe y responde interacciones con tu app de Google Chat.

Recibe eventos de Google Chat

Para recibir eventos, la app de Chat puede realizar una de las siguientes acciones:

• Suscríbete a eventos mediante la API de Google Workspace Events para recibir eventos a medida que ocurren.
• Llama a la API de Chat para consultar eventos.

Las APIs de Google Workspace Events y de Chat son compatibles y entregan los mismos tipos de eventos. Para comprender si debes suscribirte o consultar eventos, revisa la siguiente tabla:

	Suscríbete a eventos	Consulta de eventos
Casos de uso	Procesa o responde a eventos en tiempo real. Supervisa la actividad de las membresías de los usuarios y descubre nuevos espacios que puedes supervisar.	Procesar o responder a eventos periódicamente o a través de un activador Recuperar los eventos perdidos de una suscripción (debido a una interrupción o suscripción inactiva)
API	API de Google Workspace Events	Chat API
Fuente de los eventos	Espacios y usuarios	Solo espacios
Formato del evento	Un mensaje de Google Cloud Pub/Sub, con el formato que se indica en la especificación de CloudEvent. Para obtener más detalles, consulta Estructura de los eventos de Google Workspace.	Un recurso de la API de Chat ( spaces.spaceEvent)
Datos de eventos	Cadena codificada en base64 con o sin datos de recursos. Para ver ejemplos de cargas útiles, consulta Datos de eventos.	Carga útil de JSON que contiene datos de recursos Algunos tipos de eventos solo incluyen ciertos campos de recursos. Para ver cargas útiles de ejemplo, consulta la documentación de referencia de SpaceEvents.

Para obtener información sobre cómo crear suscripciones con la API de Google Workspace Events, consulta la documentación de la API de Google Workspace Events. Si quieres consultar eventos con la API de Chat, consulta las siguientes guías:

• Cómo obtener detalles sobre un evento de un espacio de Google Chat
• Enumera eventos de un espacio de Google Chat

Limitaciones

• En el caso de las suscripciones de usuarios, los eventos sobre miembros nuevos en mensajes directos o chats en grupo sin nombre (google.workspace.chat.membership.v1.created) solo se activan después de la publicación del primer mensaje.
• Los cambios en el historial del espacio no activan eventos de espacio actualizados (Tipo de evento: google.workspace.chat.spaces.v1.updated).
• Para recibir eventos de membresía, el usuario debe ser miembro directo del espacio. Si se agregó, actualizó o quitó indirectamente un usuario de un espacio a través de un Grupo de Google, la suscripción no recibirá esos eventos de membresía. Para comprender cómo funcionan las membresías de Grupos de Google, consulta Agrega un Grupo de Google a un espacio.