Después de crear una app de Chat, puedes publicarla a fin de que esté disponible para determinadas personas o grupos, todos los miembros de tu organización de Google Workspace o cualquier usuario de Google Chat.
Cómo los usuarios descubren y usan las apps de Chat
Para descubrir las apps de Google Chat, los usuarios pueden realizar cualquiera de las siguientes acciones:
- Busca e instala apps de Chat desde Google Chat o Google Workspace Marketplace.
- Interactuar con una app que se agregó a un espacio de Chat
- Descubre la app en su panel de mensajes directos después de que un administrador de Google Workspace la haya instalado en su nombre.
Para comenzar a usar una app, los usuarios de Google Chat pueden iniciar un mensaje directo con ella o agregarla a un espacio. Los usuarios también pueden agregar la app con una @ mención. En el siguiente ejemplo, se muestra cómo un usuario @ menciona una app de Chat para agregarla a un espacio:
Cómo los administradores de Google Workspace instalan apps de Chat
Los administradores de Google Workspace pueden buscar apps de chat en Google Workspace Marketplace y, luego, instalarlas para los usuarios de su organización. Cuando un administrador instala una app de Chat, esta aparece en el panel de mensajes directos del usuario.
Los administradores de Google Workspace también pueden administrar y agregar a la lista de entidades permitidas el uso de las apps de Chat en su organización de Google Workspace. Si estás desarrollando una app de Chat para una organización que usa listas de entidades permitidas, debes solicitar que un administrador agregue tu app de Chat a la lista para que los usuarios puedan encontrarla y usarla. Si deseas obtener más información, consulta la documentación de la Ayuda para administradores de Google Workspace, Permite que los usuarios instalen apps de Chat.
Configura y publica tu app de Chat con la consola de Google Cloud
Por lo general, si quieres publicar tu app de Chat y hacer que esté disponible para otras personas, debes seguir estos pasos:
- Habilita y configura la API de Google Chat. Cuando configuras la API, les otorgas a otros usuarios de Google Chat acceso a tu app de Chat para realizar pruebas.
- Publica tu app con el SDK de Google Workspace Marketplace. Puedes configurar tu app de Chat a fin de que esté disponible para los usuarios de tu organización de Google Workspace o para todos los usuarios de Google Chat.
- Si tu organización de Google Workspace administra el acceso a las apps de Chat, solicita que el administrador de Google Workspace agregue la app a la lista de entidades permitidas de la organización.
Configuración de visibilidad y publicación de tu app de Chat
En la siguiente tabla, se explica cómo establecer la configuración de la API de Google Chat y del SDK de Google Workspace Marketplace según el público de tu app de Chat:
| Usuarios previstos de la aplicación | Método de autenticación | Configuración de la API de Google Chat | Configuración del SDK de Google Workspace Marketplace | ¿Dónde se publica mi app de Chat? |
|---|---|---|---|---|
| Tu equipo pequeño | Autentícate como usuario o app. | En el parámetro de configuración Visibilidad, especifica las personas o los Grupos de Google que pueden acceder a la app.
Si tu cuenta de Google Workspace requiere que las apps estén incluidas en la lista de entidades permitidas, solo puedes especificar hasta 5 direcciones de correo electrónico individuales (no puedes especificar Grupos de Google). |
No es necesario que configures el SDK de Google Workspace Marketplace para tu app de Chat. | Los miembros del equipo pueden encontrar y usar tu app de Chat desde Google Chat. |
| Tu equipo grande | Autentícate como usuario o app. | En el parámetro de configuración Visibilidad, especifica las personas o los Grupos de Google que probarán tu app de Chat.
Después de realizar la prueba, publica la app de Chat en tu organización de Google Workspace con la configuración del SDK de Google Workspace Marketplace. |
Configura la Visibilidad de la app como Privada. Establece la Configuración de instalación en Individual + administrador. Si tu cuenta de Google Workspace requiere que las apps estén incluidas en la lista de entidades permitidas, solicita que un administrador agregue tu app de Chat a la lista de entidades permitidas para que los usuarios puedan encontrarla y usarla. Para obtener más información, consulta la documentación de la Ayuda para administradores de Google Workspace: Permite que los usuarios instalen apps de Chat. |
Cualquier miembro de tu organización de Google Workspace puede encontrar e instalar tu app de Chat en Google Chat y verla en Google Workspace Marketplace. Los usuarios y los administradores de Google Workspace pueden instalar tu app desde Marketplace. |
| Tu organización de Google Workspace | Autentícate como usuario o app. | En el parámetro de configuración Visibilidad, especifica personas o Grupos de Google para
probar tu app de Chat.
Después de realizar la prueba, publica la app de Chat en tu organización de Google Workspace con la configuración del SDK de Google Workspace Marketplace. |
Configura la Visibilidad de la app como Privada. Establece la Configuración de instalación en Individual + administrador. |
Cualquier miembro de tu organización de Google Workspace puede encontrar e instalar tu app de Chat en Google Chat y verla en Google Workspace Marketplace. Solo los administradores de Google Workspace pueden instalar tu app desde Marketplace. |
| Todos (app de Chat pública) | Autentícate como usuario o app. | En el parámetro de configuración Visibilidad, especifica personas o Grupos de Google para
probar tu app de Chat.
Después de realizar la prueba, publica tu app de Chat de forma pública con la configuración de Google Workspace Marketplace. |
Configura la Visibilidad de la app como Pública. Establezca la Configuración de instalación en Individual + Administrador |
Cualquier usuario de Google Workspace puede buscar e instalar tu app de Chat en Google Chat, y verla en Google Workspace Marketplace. Solo los administradores de Google Workspace pueden instalar tu app desde Marketplace. |
Habilita y configura la API de Google Chat
Configura un proyecto para tu app en la consola de Google Cloud y habilita la API de Google Chat de la siguiente manera:
- Usa el botón que aparece a continuación para crear un proyecto nuevo (o selecciona uno existente) y
agregarle una cuenta de servicio. Otorga a la cuenta de servicio la función de Propietario del proyecto.
Habilitar la API - Guarda la clave JSON descargada. Tu app puede usar esta clave para autenticar los mensajes que envía a los espacios de forma asíncrona.
- Abre tu proyecto en el . En la lista de APIs, haz clic en Google Chat API.
- Selecciona la pestaña Configuración y, luego, ingresa la información para la app, como se describe en la siguiente tabla.
Cuando guardas la configuración de la app, esta queda disponible para los usuarios especificados de tu organización de Google Workspace.
Configuración de la API de Google Chat
| Campo | Descripción |
|---|---|
| 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 apunta a una imagen gráfica cuadrada (p.ej., PNG o JPEG), de al menos 128 × 128, que aparecerá como avatar de tu app de Chat. |
| Descripción | Una descripción de la funcionalidad de la app de Chat que aparece debajo del nombre de tu app de Chat. |
| Funcionalidad | Un conjunto de campos que determinan cómo la app de Chat puede interactuar con los usuarios:
|
| Configuración de conexión | El extremo de la app de Chat, que es uno de los siguientes:
|
| Comandos de barra | Comandos que se pueden mostrar a los usuarios en Google Chat Permite a los usuarios ver las acciones principales de tu app de Chat en Google Chat y elegir una acción específica con la que desean interactuar. |
| 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 deseas 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 tu app de Chat o para compartir la app de Chat con tu equipo. Para obtener más información, consulta la configuración de visibilidad y publicación de tu app de Chat. |
Otorga permisos de configuración de apps
Puedes otorgar acceso a la página de configuración de la app a usuarios específicos. Para ello, usa los roles de IAM de Propietario de apps de chat y Visualizador de apps de chat. Los usuarios con estas funciones no pueden navegar a la página de configuración de la app a través del panel de APIs y servicios, pero pueden acceder a la página de configuración si navegan a la consola para su proyecto de la siguiente manera:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID
Publica tu app con el SDK de Google Workspace Marketplace
Usa el SDK de Google Workspace Marketplace para realizar cualquiera de las siguientes acciones:
- Publica tu app de Chat de forma pública y permite que cualquier usuario de Google Chat agregue tu app a un espacio.
- Publica la app de Chat en tu organización de Google Workspace.
- Haz que los administradores de Google Workspace puedan ver tu app a fin de que puedan instalarla para los usuarios de su organización. Para que los administradores de Google Workspace puedan verla, tu app debe tener mensajería directa.
Antes de publicar tu app con el SDK de Google Workspace Marketplace, sigue estos pasos:
- Instálala desde Chat para probar tu app de Chat. Asegúrate de que tu app funcione correctamente y no sea un trabajo en curso.
- Revisa los requisitos de publicación y verifica que tu app cumpla con todos ellos. Consulta Áreas de revisión.
- Registra el número de versión de la app; lo necesitas para configurar el SDK de Google Workspace Marketplace.
Cuando estés listo para publicarlo, consulta Descripción general: Publica una app.