Productividad
Miro en tu producto y en tus agentes de IA, con una API
El toolkit de Miro cubre boards, miembros y elementos: lista y lee boards, crea y actualiza sticky notes y cards, y elimina elementos. Tu producto o agente de IA los llama por Connect, que maneja la conexión OAuth del cliente y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/miro_create_board/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Miro.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Miro. 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 Miro.
Boards creados por tu producto
Un SaaS crea un board en Miro para cada proyecto nuevo y devuelve el viewLink al usuario.
Datos convertidos en sticky notes
Una herramienta de agencia o investigación agrega sticky notes con comentarios o ideas a un board, dentro de un frame cuando hace falta.
Agente que ordena un board
Un agente de IA lista los elementos de un board, crea cards asignadas a miembros y actualiza sus fechas límite.
Tools
12 tools de Miro
- Listar boardsGETLista los boards que el usuario conectado puede abrir, con id, name, description, viewLink, owner, team y fechas. Paginación por offset.
- Obtener boardGETDevuelve un board: name, description, viewLink, owner, team, política de uso compartido y fechas.
- Crear boardPOSTCrea un board en el equipo de la conexión y lo devuelve con id y viewLink. En el plan gratuito un equipo puede tener solo 3 boards editables.
- Actualizar boardPATCHActualiza el nombre, la descripción o el uso compartido de un board y lo devuelve. Los campos omitidos conservan su valor.
- Listar miembros del boardGETLista los miembros de un board con id, name y role. El id es el assigneeId que piden Crear card y Actualizar card. Paginación por offset.
- Listar elementosGETLista los elementos de un board, como sticky notes, cards, textos, formas y frames, con id, type, data, position, geometry y parent.
- Obtener elementoGETDevuelve un elemento de un board, de cualquier tipo, con data, style, position, geometry y parent.
- Crear sticky notePOSTAgrega una sticky note a un board y la devuelve con su id. Sin position va al centro del board; dentro de un frame (parent.id), la posición cuenta desde el frame.
- Actualizar sticky notePATCHActualiza el texto, forma, color, posición, tamaño o frame de una sticky note y la devuelve. Los campos omitidos conservan su valor.
- Crear cardPOSTAgrega una card, el elemento de tarea de Miro, a un board y la devuelve con su id. Sin position va al centro del board; dentro de un frame (parent.id), la posición cuenta desde el frame.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/miro, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Miro
¿Necesito implementar la API de Miro?
No. Connect ya trae 12 tools de Miro 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 Miro?
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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
