Archivos
SharePoint en tu producto y en tus agentes de IA, con una API
El toolkit de SharePoint cubre sitios, listas y bibliotecas de documentos, columnas de listas y elementos de listas en una organización de Microsoft 365. Tu cliente conecta SharePoint una vez con OAuth, y tu producto o agente de IA llama a 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/sharepoint_create_item/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"site_id": "<site_id>",
"list_id": "<list_id>",
"fields": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a SharePoint.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de SharePoint. 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 SharePoint.
Escribe registros en una lista
Lee las columnas de una lista y crea un elemento con los campos obligatorios para que los datos de tu producto lleguen donde ya trabaja el equipo del cliente.
Explora los sitios del cliente
Busca sitios por palabra clave, lista sus listas y bibliotecas y lee elementos con los valores de sus columnas.
Agente limpia elementos de listas
Un agente de IA encuentra elementos por sus campos, lee cada uno con Obtener elemento y elimina los que el usuario confirme.
Tools
8 tools de SharePoint
- Buscar sitiosGETBusca los sitios de SharePoint de la organización por palabra clave y devuelve id, displayName, name, webUrl y descripción. Usa el id como site_id. Solo se devuelve la primera página.
- Obtener sitioGETDevuelve un sitio con id, displayName, name, descripción, webUrl y createdDateTime.
- Listar listasGETLista las listas y bibliotecas de documentos de un sitio, con id, name, displayName, webUrl y list.template, que es genericList para una lista y documentLibrary para una biblioteca. Las listas ocultas del sistema quedan fuera. Solo se devuelve la primera página.
- Listar columnasGETLista las columnas de una lista con name, displayName, required, readOnly y la faceta de su tipo, como text, number, dateTime, boolean o choice con las opciones permitidas. El name, no el displayName, es la clave de una columna en fields.
- Listar elementosGETLista los elementos de una lista con id, webUrl, createdBy y lastModifiedDateTime, además de los valores de las columnas en fields cuando expand es fields. En una biblioteca de documentos, cada elemento es un archivo o carpeta. Solo se devuelve la primera página.
- Obtener elementoGETDevuelve un elemento de una lista con id, webUrl, createdBy y lastModifiedDateTime, además de los valores de las columnas en fields cuando expand es fields.
- Crear elementoPOSTCrea un elemento en una lista y lo devuelve con su id y los valores guardados. Toda columna obligatoria de Listar columnas debe estar en fields.
- Eliminar elementoDELETEElimina un elemento de una lista.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/sharepoint, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de SharePoint
¿Necesito implementar la API de SharePoint?
No. Connect ya trae 8 tools de SharePoint 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 SharePoint?
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.
