Enviar mensaje de canal

Compatibilidad de proyectos

Windows | Multiplataforma

Información general

Descripción	método API	Ruta de la API
Envíe mensajes en un canal de Microsoft Teams con archivos adjuntos de SharePoint opcionales.	Publicar	/normalised-teams/{team_id}/channels/{channel_id}/messages-v2/drive/items

Entrada

Parámetro	Descripción	Tipo de datos
ID del equipo	Identificador único del equipo. Introduce el nombre del equipo para recuperarlo de la lista desplegable disponible o escribe un ID de equipo personalizado. Puedes recuperar el ID de la salida de la actividad Obtener equipo por nombre .	String
ID del canal	Identificador único del canal. Introduce el nombre del canal para recuperarlo de la lista desplegable disponible o escribe un ID de canal. Puedes recuperar el ID de la salida de la actividad Obtener canal por nombre .	String
CuerpoMensaje	Contenido de texto del mensaje	String
Tarjeta adaptable JSON	Carga útil JSON que representa el contenido de la tarjeta adaptable. Sustituye " por ' y elimina todos los caracteres de escape que contengan '', como \n, \r. Por ejemplo, reemplaza \r\n"tipo" por 'tipo'. Para obtener más información, consulta la documentación de la API de Microsoft Teams y la documentación de las tarjetas adaptables.	String
Imagen	Imagen adjunta para incluir en el mensaje	.xml
ID de archivo (hasta 20 archivos)	Uno o más ID de archivo de SharePoint para adjuntar al mensaje. Puedes recuperar este ID de la salida de Obtener archivo o carpeta o Cargar archivos (actividades de Microsoft 365). Este campo admite entrada de tipo String.	Matriz de cadenas
ID de menciones	Índice de la entidad mencionada en el mensaje, un identificador numérico que vincula etiquetas <at> en el texto del mensaje para mencionar entradas. Debe coincidir con el atributo id en la etiqueta HTML <at> . Valores posibles: 0, 1, 2, etc.	Int32
Menciona el tipo de identidad de usuario mencionado	Tipo de identidad del usuario mencionado. Valores comunes: member, aadUser, onPremiseAadUser, guest. El valor predeterminado para los miembros regulares del equipo es member.	String
Menciona el ID de usuario mencionado	Identificador único del usuario mencionado (identificador único del usuario de AAD). Por ejemplo 74a49af0-e4a2-43d6-9d83-52f5f0.	String
Menciona el nombre para mostrar del usuario mencionado	Nombre para mostrar completo del usuario mencionado de Azure AD. Por ejemplo John Doe	String
Texto de mención de menciones	Texto utilizado para mencionar al usuario en el mensaje. Debe coincidir con el texto entre las etiquetas <at> . Por ejemplo John Doe.	String

Salida

Parámetro	Descripción	Tipo de datos
IdDeMensaje	Identificador único del mensaje enviado	String
URL de web	URL web del mensaje enviado	String
Mensaje	Objeto de mensaje de canal completo devuelto por la API	Objeto

Nota:

• En los flujos de trabajo de la API, se devuelve un único objeto de respuesta como salida. Cualquier campo obligatorio puede extraerse directamente de este objeto.
• En los flujos de trabajo de RPA, algunos parámetros de salida pueden diferir, pero los valores necesarios pueden recuperarse del objeto de respuesta incluso si no se exponen explícitamente.

Uso de menciones de usuario

Para mencionar a un usuario en tu mensaje de canal de Teams, debes configurar tanto el texto del mensaje como las propiedades de las menciones.

Nota:

Actualmente no se admite la mención de etiquetas, solo se pueden mencionar usuarios.

1. Formatea el texto del mensaje.

Incluye la mención utilizando etiquetas HTML <at> con un atributo id :

"Hello <at id=\"0\">John Doe</at>, please review this."

2. Configura las propiedades de las menciones como en la siguiente tabla.

   Propiedad	Valor	Descripción
   ID de menciones	0	Identificador numérico (incremento para varias menciones)
   Texto de mención de menciones	John Doe	Nombre para mostrar que se muestra en la mención
   Menciona el nombre para mostrar del usuario mencionado	John Doe	Nombre completo del usuario de Azure AD
   Menciona el ID de usuario mencionado	{AAD Object ID}	ID de objeto de Azure AD del usuario (ver más abajo)
   Menciona el tipo de identidad de usuario mencionado	Miembro	Tipo de identidad (miembro/UsuarioDeAnuncio/invitado)

Para obtener el ID de objeto de Azure AD:

• Portal de Azure : dirígete a Azure Active Directory > Usuarios > {User}> Copiar ID de objeto.
• API de Microsoft Graph : GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}
• PowerShell : Get-AzureADUser -ObjectId "[e-mail]" | Select ObjectId

Ejemplo de configuración para mencionar al usuario "Jane Smith":

• Texto del mensaje: "Task completed <at id=\"0\">Jane Smith</at>"
• ID de menciones: 0
• Texto de mención de menciones: "Jane Smith"
• Menciona el nombre para mostrar del usuario mencionado: "Jane Smith"
• Menciona el ID de usuario mencionado: "ef1c916a-3135-4417-ba27-8eb7bd084193"
• Menciones al tipo de identidad de usuario mencionado: "member"
  Nota:

  • Solo se puede mencionar un usuario por instancia de actividad.
  • El id en la etiqueta <at> debe coincidir con la propiedad ID de menciones.
  • Un ID de objeto de Azure AD incorrecto hará que la mención falle.
  • Asegúrese de que su bot/aplicación tenga permisos para mencionar a los usuarios en el canal.