Comunicación
Microsoft Teams en tu producto y en tus agentes de IA, con una API
El toolkit de Microsoft Teams cubre equipos, canales (listar, crear), mensajes de canal y respuestas (leer, publicar, responder) y chats (listar chats, miembros y mensajes, enviar un mensaje), como el usuario conectado. El cliente conecta una cuenta laboral o educativa por OAuth en tu propia app, y Connect renueva los tokens y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/microsoft_teams_create_channel/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"team_id": "<team_id>",
"displayName": "<displayName>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Microsoft Teams.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Microsoft Teams. 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 Microsoft Teams.
Avisar a un canal desde tu producto
Lista los equipos y canales del usuario, elige uno y publica un mensaje con Send channel message cuando algo necesite la atención del equipo.
Responder dentro de un hilo
Lee los mensajes raíz de un canal y sus respuestas, y contesta en el mismo hilo con Reply to channel message, desde un bot o un agente de IA.
Asistente de chat para una persona
Lista los chats del usuario, lee los mensajes recientes con List chat messages y envía un mensaje en un chat existente cuando el usuario apruebe el texto.
Tools
12 tools de Microsoft Teams
- Listar equiposGETLista los equipos de los que el usuario es miembro directo, con id, displayName, description e isArchived. Usa el id como team_id en las otras tools.
- Listar canalesGETLista los canales de un equipo que el usuario puede ver, con id, displayName, description, membershipType y webUrl. Los canales privados y compartidos aparecen solo para sus miembros. Usa el id como channel_id en las tools de mensajes.
- Crear canalPOSTCrea un canal estándar, abierto a todos los miembros del equipo, y lo devuelve con su id. Los canales privados y compartidos necesitan una lista de miembros y no se admiten aquí.
- Listar mensajes del canalGETLista los mensajes raíz de un canal, sin sus respuestas, 20 por página y ordenados por la actividad más reciente de cada hilo. Solo vuelve la primera página: el @odata.nextLink de la respuesta no se puede seguir aquí. Lee un hilo con List channel message replies.
- Leer mensaje del canalGETDevuelve un mensaje raíz de un canal, con su cuerpo, el remitente en from, createdDateTime y webUrl. Sus respuestas no están incluidas.
- Listar respuestas del mensaje del canalGETLista las respuestas a un mensaje raíz de un canal. El mensaje raíz no está incluido: léelo con Get channel message. Solo vuelve la primera página.
- Enviar mensaje al canalPOSTPublica un mensaje nuevo en un canal como el usuario y lo devuelve con su id. Los términos de Microsoft prohíben usar Teams como registro, así que envía solo mensajes que las personas vayan a leer.
- Responder mensaje del canalPOSTPublica una respuesta en el hilo de un mensaje raíz de un canal, como el usuario, y la devuelve con su id. Envía solo mensajes que las personas vayan a leer.
- Listar chatsGETLista los chats individuales, de grupo y de reunión del usuario, con id, topic, chatType y webUrl. Los chats individuales no tienen topic: usa List chat members para ver quién está en un chat. Solo vuelve la primera página.
- Listar miembros del chatGETLista las personas de un chat, con displayName, email y userId.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/microsoft_teams, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Microsoft Teams
¿Necesito implementar la API de Microsoft Teams?
No. Connect ya trae 12 tools de Microsoft Teams 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 Microsoft Teams?
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.
