Configura la API de Google Chat

Cada app de Google Chat que crees requiere su propio proyecto de Google Cloud con la API de Chat habilitada y configurada. En esta página, se muestra cómo configurar la API de Chat.

Requisitos previos

Configura la API de Chat

  1. En la consola de Google Cloud, busca “API de Google Chat” y haz clic en API de Google Chat. Luego, haz clic en Administrar.

    Ir a la API de Chat

  2. Haz clic en la pestaña Configuración y, luego, ingresa la siguiente información requerida:

    • Nombre de la app: Es el nombre que usan las personas cuando interactúan con tu app de Chat.
    • URL del avatar: Es una URL HTTPS que dirige a una imagen gráfica cuadrada (por ejemplo, PNG o JPEG), de al menos 128 × 128, que aparece como el avatar de tu app de Chat.
    • Descripción: Es una descripción del objetivo previsto de la app de Chat que aparece debajo del nombre de esta.

  3. Para activar las funciones interactivas, haz clic en el botón de activación Habilitar funciones interactivas que permite a los usuarios interactuar con tu app de Chat y usar la siguiente tabla para finalizar la configuración:

    Campo Descripción
    Funcionalidad Un conjunto de campos que determinan cómo la app de Chat puede interactuar con los usuarios:
    • Recibir mensajes 1:1: Los usuarios pueden buscar y enviar mensajes a la app de Chat directamente en Google Chat.
    • Unirse a espacios y conversaciones grupales: Los usuarios pueden agregar la app de Chat a espacios y conversaciones grupales.
    Configuración de conexión El extremo de la app de Chat, que es uno de los siguientes:
    • URL de la app: Es un extremo HTTPS que aloja la implementación de la app de Chat.
    • Proyecto de Apps Script: Es un ID de implementación para un proyecto de Apps Script que implementa una app de Chat.
    • Nombre del tema de Cloud Pub/Sub: Es un tema de Pub/Sub al que se suscribe la app de Chat como un extremo.
    • Dialogflow: Registra la app de Chat con una integración de Dialogflow. Para obtener más información, consulta Compila una app de Google Chat de Dialogflow que comprenda el lenguaje natural.
    Comandos de barra Comandos que se pueden mostrar a los usuarios en Google Chat. Permite que los usuarios vean las acciones principales de tu app de Chat en Google Chat y elijan una acción específica con la que quieren interactuar. Para obtener más información, consulta Responde a comandos de barra como una app de Chat.
    Vistas previas de vínculos Patrones de URL que la app de Chat reconoce y para los que proporciona contenido adicional cuando los usuarios envían vínculos Si quieres obtener más información, consulta Cómo obtener una vista previa de los vínculos.
    Visibilidad Hasta 5 personas o uno o más Grupos de Google que puedan ver e instalar tu app de Chat. Usa este campo para probar la app de Chat o compartir la app de Chat con tu equipo. Para obtener más información, consulta Configuración de visibilidad y publicación de tu app de Chat.

  4. Para registrar errores en Cloud Logging cada vez que la app de Chat muestre un error, selecciona la casilla de verificación Registrar errores en Logging. Para obtener más información, consulta los registros de errores de consultas de las apps de Chat.

  5. Haz clic en Guardar. Cuando guardas la configuración de la app de Chat, esta se encuentra disponible para los usuarios especificados de tu organización de Google Workspace.

Cómo otorgar permiso a otras personas para configurar una app de Chat

Puedes otorgar acceso a usuarios específicos a la página de configuración de la app de Chat. Usa los roles de IAM de Propietario de apps de chat y Visualizador de apps de chat. Los usuarios con estos roles no pueden navegar a la página de configuración de las apps de Chat mediante el panel de APIs y servicios, pero pueden acceder a la página de configuración si navegan a la consola de Google Cloud para el proyecto de Cloud host de la app de Chat de la siguiente manera:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

En la que PROJECT_ID es el ID del proyecto de Google Cloud que aloja la app de Chat.