Leer mensaje del canal en Microsoft Teams, con una API
Devuelve un mensaje raíz de un canal, con su cuerpo, el remitente en from, createdDateTime y webUrl. Sus respuestas no están incluidas.
- Identificador
- microsoft_teams_get_channel_message
La llamada
POST https://connect.reportei.com/api/tools/microsoft_teams_get_channel_message/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>",
"channel_id": "<channel_id>",
"message_id": "<message_id>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| team_id | string | Sí | Team id from List teams. |
| channel_id | string | Sí | Channel id from List channels. |
| message_id | string | Sí | Message id from List channel messages. |
Conexiones posibles
Tu cliente conecta su cuenta de Microsoft Teams una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
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.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/microsoft_teams_get_channel_message. Se convierte en la definición de tool de tu agente sin conversión.
Otras 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.
- 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.
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.
