Comunicación
Google Chat en tu producto y en tus agentes de IA, con una API
El toolkit de Google Chat cubre espacios, mensajes directos, mensajes, reacciones y miembros, siempre actuando como el usuario que conectó. Tu cliente autoriza Google una vez con OAuth, y tu producto o agente de IA llama cada operación a través de Connect, que guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/google_chat_create_space/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"space": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a Google Chat.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Google Chat. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Google Chat.
Avisar a equipos en su chat
Envía un mensaje desde tu producto a un espacio o mensaje directo, o responde dentro de un hilo existente cuando una alerta recibe una actualización.
Crear un espacio por proyecto
Crea un espacio, invita a las personas adecuadas y añade miembros después, cuando alguien nuevo se une a la cuenta o al proyecto.
Un agente que entiende el chat
Deja que un agente de IA busque mensajes en los espacios del usuario, lea una conversación y responda o reaccione en su nombre.
Tools
11 tools de Google Chat
- Listar espaciosGETLista los espacios, chats grupales y mensajes directos en los que participa el usuario, con name, displayName y spaceType. La parte del name después de spaces/ es el spaceId de las demás herramientas, y los chats grupales y mensajes directos solo aparecen tras el primer mensaje.
- Obtener mensaje directoGETDevuelve el espacio de mensaje directo entre el usuario y otra persona; la parte del name después de spaces/ es el spaceId de Send message. Responde 404 cuando ambos aún no tienen mensaje directo, que Create space inicia.
- Crear espacioPOSTCrea un espacio con el usuario e invita a otras personas. SPACE requiere displayName y admite hasta 49 personas; GROUP_CHAT requiere al menos dos personas y ningún nombre; DIRECT_MESSAGE requiere exactamente una persona y devuelve el mensaje directo existente si lo hay.
- Listar mensajesGETLista los mensajes de un espacio, de más antiguos a más nuevos por defecto, con name, sender, createTime, text y thread. Los remitentes vienen como users/ seguido de un id, sin el nombre visible; envía nextPageToken como pageToken para la página siguiente.
- Buscar mensajesPOSTBusca mensajes por palabras clave en todos los espacios y mensajes directos del usuario, de más recientes a más antiguos. Cada resultado trae el mensaje, cuyo name lleva los ids del espacio y del mensaje; los mensajes de apps de Chat, los mensajes privados y los espacios silenciados quedan fuera.
- Enviar mensajePOSTEnvía un mensaje de texto del usuario a un espacio o mensaje directo. Para responder en un hilo, envía thread con el nombre del hilo de List messages y messageReplyOption; sin messageReplyOption el mensaje inicia un hilo nuevo.
- Actualizar mensajePATCHCambia el texto de un mensaje, con updateMask definido como text.
- Eliminar mensajeDELETEElimina un mensaje. Un mensaje con respuestas en un hilo solo se elimina con force true, que elimina también las respuestas.
- Crear reacciónPOSTAñade una reacción con emoji del usuario a un mensaje.
- Listar miembrosGETLista los miembros de un espacio con role y state. Los miembros vienen como users/ seguido de un id, sin el nombre visible; envía nextPageToken como pageToken para la página siguiente.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/google_chat, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Google Chat
¿Necesito implementar la API de Google Chat?
No. Connect ya trae 11 tools de Google Chat descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Google Chat?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
