Slack

Slack es una herramienta de comunicación de equipo, que reúne todas las comunicaciones del equipo en un solo lugar, que se pueden buscar instantáneamente y están disponibles dondequiera que vaya.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Estándar	Todas las regiones de Power Automate excepto las siguientes: - China Cloud operado por 21Vianet
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Estándar	Todas las regiones de Power Apps excepto las siguientes: - China Cloud operado por 21Vianet
Power Automate	Estándar	Todas las regiones de Power Automate excepto las siguientes: - China Cloud operado por 21Vianet

Contacto
Nombre	Microsoft
URL	https://support.microsoft.com/contactus

Metadatos del conector
Publicador	Microsoft
Sitio web	https://slack.com/
Directiva de privacidad	https://slack.com/privacy-policy
Categories	Colaboración; Comunicación

Problemas conocidos y limitaciones

Según la documentación de la API de Slack, algunos métodos de API de Slack que usa el conector dejarán de funcionar en febrero de 2021 y no funcionarán con aplicaciones recién creadas después del 10 de junio de 2020. Por lo tanto, use las versiones más recientes de las acciones siguientes.

Acciones:
Cree un grupo en desuso y use la versión más reciente de Creación de un canal para crear canales privados.
El número máximo de caracteres de un mensaje está limitado a 4000. Para más información, consulte la documentación oficial de Slack.

Conector en profundidad

Para más información sobre el conector, consulte la sección en profundidad.

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos
Frecuencia de sondeos de desencadenador	1	120 segundos

Acciones

Creación de un canal	Cree un canal en slack.
Crear un canal [EN DESUSO]	Esta acción ha quedado en desuso. Use Crear un canal en su lugar. ~~Cree un canal en slack.~~
Crear un grupo [EN DESUSO]	Crea un grupo en slack.
Enumeración de canales públicos (compatibilidad con paginación) (versión preliminar)	Enumere los canales públicos en slack.
Enumerar canales públicos	Enumere los canales públicos en slack.
Enumerar mensajes de conversación (versión preliminar)	Enumere los mensajes publicados en una conversación (canal público, canal privado, mensaje directo o mensaje directo de grupo).
Enumerar respuestas de mensajes (versión preliminar)	Enumere las respuestas en un subproceso de mensaje, incluido el mensaje primario.
Establecer no molestar	Establezca el estado de no molestar al usuario.
Mensaje posterior (V2)	Esta operación se usa para publicar un mensaje en el canal especificado.
Mensaje posterior [EN DESUSO]	Esta acción ha quedado en desuso. Use post message (V2) en su lugar. ~~Esta operación se usa para publicar un mensaje en el canal especificado.~~
Mostrar canales [EN DESUSO]	Esta acción ha quedado en desuso. Use la lista de canales públicos (soporte técnico de paginación) en su lugar. ~~Enumere los canales en slack.~~
Obtener perfil de usuario (versión preliminar)	Obtenga información de perfil para un usuario de Slack. Resulta útil para resolver el autor de un mensaje devuelto por Mensajes de conversación de lista o Respuestas de mensajes de lista.
Unirse a un canal [EN DESUSO]	Esta acción ha quedado en desuso. Use Unirse a un canal público en su lugar. ~~Únase a un canal en slack.~~
Unirse a un canal público	Únase a un canal público en slack.

Creación de un canal

Id. de la operación:: CreateChannel_V2

Cree un canal en slack.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre	name		string	Nombre del nuevo canal.
¿Es canal privado?	is_private		boolean	El canal es privado o no

Devoluciones

Body: CreateChannel_Response

Crear un canal [EN DESUSO]

Id. de la operación:: CreateChannel

Esta acción ha quedado en desuso. Use Crear un canal en su lugar.

~~Cree un canal en slack.~~

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre	name		string	Nombre del nuevo canal.

Devoluciones

Body: CreateChannel_Response

Crear un grupo [EN DESUSO]

Id. de la operación:: CreateGroup

Crea un grupo en slack.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre	name		string	Nombre del grupo.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
Id	group.id	string	Identificador del grupo.
Nombre	group.name	string	Nombre del grupo.

Enumeración de canales públicos (compatibilidad con paginación) (versión preliminar)

Id. de la operación:: ListChannels_V3

Enumere los canales públicos en slack.

Devoluciones

Body: ListChannels_ResponseV3

Enumerar canales públicos

Id. de la operación:: ListChannels_V2

Enumere los canales públicos en slack.

Parámetros

Nombre	Clave	Tipo	Description
Tipos de conversación	types	string	Tipos de conversación separados por comas que se van a incluir. El valor predeterminado es public_channel. Incluya explícitamente private_channel, im o mpim para enumerar otros tipos de conversación.
Excluir archivado	exclude_archived	boolean	Establézcalo en true para excluir las conversaciones archivadas.
Resultados máximos	limit	integer	Número máximo de conversaciones que se van a devolver.
Id. de equipo	team_id	string	Identificador de equipo codificado. Solo se requiere para un token de toda la organización.
Cursor	cursor	string	Cursor de paginación devuelto por la solicitud anterior.

Devoluciones

Body: ListChannels_Response

Enumerar mensajes de conversación (versión preliminar)

Id. de la operación:: ListConversationMessages

Enumere los mensajes publicados en una conversación (canal público, canal privado, mensaje directo o mensaje directo de grupo).

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de conversación	channel	True	string	Conversación de la que se van a capturar mensajes.
Resultados máximos	limit		integer	Número máximo de mensajes que se van a devolver por página.
Marca de tiempo más antigua	oldest		string	Solo se incluirán los mensajes después de esta marca de tiempo de Unix en los resultados.
Marca de tiempo más reciente	latest		string	Solo se incluirán los mensajes antes de esta marca de tiempo de Unix en los resultados.
Hilo completo	inclusive		boolean	Incluya mensajes con las marcas de tiempo más antiguas o más recientes en los resultados.
Incluir todos los metadatos	include_all_metadata		boolean	Devuelve todos los metadatos asociados a cada mensaje.

Devoluciones

Body: ListMessages_Response

Enumerar respuestas de mensajes (versión preliminar)

Id. de la operación:: ListMessageReplies

Enumere las respuestas en un subproceso de mensaje, incluido el mensaje primario.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de conversación	channel	True	string	Conversación que contiene el subproceso.
Marca de tiempo del mensaje primario	ts	True	string	Marca de tiempo del mensaje primario que inicia el subproceso. Disponible como campo `ts` en un mensaje devuelto por Enumerar mensajes de conversación.
Resultados máximos	limit		integer	Número máximo de mensajes que se van a devolver por página.
Marca de tiempo más antigua	oldest		string	Solo se incluirán los mensajes después de esta marca de tiempo de Unix en los resultados.
Marca de tiempo más reciente	latest		string	Solo se incluirán los mensajes antes de esta marca de tiempo de Unix en los resultados.
Hilo completo	inclusive		boolean	Incluya mensajes con las marcas de tiempo más antiguas o más recientes en los resultados.

Devoluciones

Body: ListMessages_Response

Establecer no molestar

Id. de la operación:: SetDND

Establezca el estado de no molestar al usuario.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Número de los minutos	num_minutes		string	El número de minutos que se van a establecer no molestar.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
Posponer habilitado	snooze_enabled	boolean	Indica si la posposición está habilitada.

Mensaje posterior (V2)

Id. de la operación:: PostMessage_V2

Esta operación se usa para publicar un mensaje en el canal especificado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre del canal	channel	True	string	Canal, grupo privado o canal de mensajería instantánea al que se va a enviar el mensaje. Puede ser un nombre (por ejemplo, #general) o un identificador codificado.
Texto del mensaje	text	True	string	Cuerpo del mensaje que se va a enviar. Slack API truncará los mensajes que contienen más de 40 000 caracteres. Para ver las opciones de formato, consulte https://api.slack.com/docs/formatting
Marca de tiempo del mensaje primario	thread_ts		string	Marca de tiempo del mensaje primario al publicar una respuesta en un subproceso.
Difusión al canal	reply_broadcast		boolean	Pase true para enviar también una respuesta subprocesada al canal.
Nombre del bot	username		string	Nombre del bot.
Publicar como usuario	as_user		boolean	Pase true para publicar el mensaje como el usuario autenticado, en lugar de como un bot.
Modo de análisis	parse		string	Cambiar cómo se tratan los mensajes. Para obtener más información, consulte https://api.slack.com/docs/formatting
Análisis de marcado de Slack	mrkdwn		boolean	Configuración de análisis de marcado de Slack. Habilitado de forma predeterminada.
Nombres de vínculo	link_names		integer	Busque y vincule los nombres de canal y los nombres de usuario.
Vínculos de desfurcar	unfurl_links		boolean	Pase true para habilitar la desfurcación de contenido basado principalmente en texto.
Elementos multimedia desfurcación	unfurl_media		boolean	Pase false para deshabilitar la desfurcación del contenido multimedia.
Dirección URL del icono	icon_url		uri	Dirección URL de una imagen que se va a usar como icono para este mensaje.
Icono Emoji	icon_emoji		string	Emoji que se usará como un icono para este mensaje.

Devoluciones

Detalles del mensaje publicado en un canal de Slack.

Body: PostMessageResponse

Mensaje posterior [EN DESUSO]

Id. de la operación:: PostMessage

Esta acción ha quedado en desuso. Use post message (V2) en su lugar.

~~Esta operación se usa para publicar un mensaje en el canal especificado.~~

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre del canal	channel	True	string	Canal, grupo privado o canal de mensajería instantánea al que se va a enviar el mensaje. Puede ser un nombre (por ejemplo, #general) o un identificador codificado.
Texto del mensaje	text	True	string	Cuerpo del mensaje que se va a enviar (menos de 4000 caracteres). Para ver las opciones de formato, consulte https://api.slack.com/docs/formatting.
Nombre del bot	username		string	Nombre del bot.
Publicar como usuario	as_user		boolean	Pase true para publicar el mensaje como el usuario autenticado, en lugar de como un bot.
Modo de análisis	parse		string	Cambiar cómo se tratan los mensajes. Para obtener más información, consulte https://api.slack.com/docs/formatting.
Nombres de vínculo	link_names		integer	Busque y vincule los nombres de canal y los nombres de usuario.
Vínculos de desfurcar	unfurl_links		boolean	Pase true para habilitar la desfurcación de contenido basado principalmente en texto.
Elementos multimedia desfurcación	unfurl_media		boolean	Pase false para deshabilitar la desfurcación del contenido multimedia.
Dirección URL del icono	icon_url		uri	Dirección URL de una imagen que se va a usar como icono para este mensaje.
Icono Emoji	icon_emoji		string	Emoji que se usará como un icono para este mensaje.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
Resultado correcto	ok	boolean	Indica si la operación se realizó correctamente.
Channel	channel	string	Canal al que se publicó el mensaje.
Date-Time creados	ts	string	aaaa-MM-ddTHH:mm:ss.fffZ
Texto del mensaje	message.text	string	Cuerpo del mensaje.
Id. de mensaje	message.id	string	Identificador único del mensaje.
Id. de creador	message.user	string	Identificador único del usuario que publicó el mensaje.
Hora de creación	message.created	integer	Marca de tiempo de Unix para cuando se crea el mensaje.
Está eliminado	message.is_user-deleted	boolean	Indica si el mensaje se ha eliminado o no.
Mensajes de error	error	string	Detalles de los mensajes de error, si los hay.

Mostrar canales [EN DESUSO]

Id. de la operación:: ListChannels

Esta acción ha quedado en desuso. Use la lista de canales públicos (soporte técnico de paginación) en su lugar.

~~Enumere los canales en slack.~~

Devoluciones

Body: ListChannels_Response

Obtener perfil de usuario (versión preliminar)

Id. de la operación:: GetUserProfile

Obtenga información de perfil para un usuario de Slack. Resulta útil para resolver el autor de un mensaje devuelto por Mensajes de conversación de lista o Respuestas de mensajes de lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
ID de usuario	user	True	string	Identificador del usuario para el que se va a obtener información de perfil.

Devoluciones

Body: GetUserProfile_Response

Unirse a un canal [EN DESUSO]

Id. de la operación:: JoinChannel

Esta acción ha quedado en desuso. Use Unirse a un canal público en su lugar.

~~Únase a un canal en slack.~~

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre	name		string	Nombre del canal.

Devoluciones

Body: JoinChannel_Response

Unirse a un canal público

Id. de la operación:: JoinChannel_V2

Únase a un canal público en slack.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre del canal	channel		string	Nombre del canal.

Devoluciones

Body: JoinChannel_ResponseV2

Desencadenadores

Cuando se crea un archivo

Id. de la operación:: OnNewFile

Cuando se crea un archivo

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Channel	channel	True	string	Nombre del canal.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
Id	id	string	Identificador del archivo
Creado	created	integer	Cuando se creó el archivo.
Nombre	name	string	El nombre del archivo.
Title	title	string	Título del archivo.

Definiciones

Channel

Canal

Nombre	Ruta de acceso	Tipo	Description
Id	id	string	Identificador del canal.
Nombre	name	string	Nombre del canal.
Es canal público	is_channel	boolean	Si esta conversación es un canal público.
Canal privado	is_group	boolean	Si esta conversación es un canal privado.
Es mensaje directo	is_im	boolean	Si esta conversación es un mensaje directo entre dos usuarios.
Mensaje directo de grupo	is_mpim	boolean	Si esta conversación es un mensaje directo de grupo.
Es privado	is_private	boolean	Si esta conversación es privada.
Se archiva	is_archived	boolean	Si se ha archivado esta conversación.
Es miembro	is_member	boolean	Si el usuario autenticado es miembro de esta conversación.
ID de usuario	user	string	Para los mensajes directos, el identificador del otro usuario de la conversación.
Número de miembros	num_members	integer	Número de miembros de esta conversación.

ListChannels_Response

Nombre	Ruta de acceso	Tipo	Description
canales nueva	channels	array of Channel
Cursor siguiente	response_metadata.next_cursor	string	Cursor para pasar a la siguiente solicitud. Vacío cuando no hay más resultados.

ListChannels_ResponseV3

Nombre	Ruta de acceso	Tipo	Description
value	value	array of Channel

SlackMessage

Mensaje publicado en una conversación de Slack.

Nombre	Ruta de acceso	Tipo	Description
Id. de mensaje	ts	string	Identificador de marca de tiempo único del mensaje.
Id. de autor	user	string	Identificador del usuario que publicó el mensaje. Use Obtener perfil de usuario para resolverlo en un usuario.
Texto del mensaje	text	string	Cuerpo del mensaje.
Tipo de mensaje	type	string	Tipo del mensaje.
Id. de subproceso	thread_ts	string	Marca de tiempo del mensaje primario, si este mensaje forma parte de un subproceso.
Recuento de respuestas	reply_count	integer	Número de respuestas a este mensaje, si inicia un subproceso.

ListMessages_Response

Nombre	Ruta de acceso	Tipo	Description
value	value	array of SlackMessage

SlackUserProfile

Detalles de perfil adicionales para un usuario de Slack.

Nombre	Ruta de acceso	Tipo	Description
Nombre para mostrar	display_name	string	Nombre para mostrar que el usuario ha elegido para su perfil.
Nombre real	real_name	string	Nombre y apellido del usuario.
Correo electrónico	email	string	La dirección de correo del usuario.
Avatar Url	image_72	string	Dirección URL de una versión de 72 x 72 píxeles del avatar del usuario.

SlackUser

Un usuario de Slack.

Nombre	Ruta de acceso	Tipo	Description
Id	id	string	El identificador del usuario.
Nombre de usuario	name	string	Nombre de usuario de Slack del usuario.
Nombre real	real_name	string	Nombre y apellido del usuario.
¿Es bot?	is_bot	boolean	Si el usuario es un bot.
Está desactivado	deleted	boolean	Indica si se ha desactivado la cuenta del usuario.
Zona horaria	tz	string	Zona horaria legible del usuario.
Profile	profile	SlackUserProfile	Detalles de perfil adicionales para un usuario de Slack.

GetUserProfile_Response

Nombre	Ruta de acceso	Tipo	Description
Resultado correcto	ok	boolean	Indica si la operación se realizó correctamente.
Usuario	user	SlackUser	Un usuario de Slack.
Mensajes de error	error	string	Detalles de los mensajes de error, si los hay.

CreateChannel_Response

Nombre	Ruta de acceso	Tipo	Description
Channel	channel	Channel	Canal

JoinChannel_Response

Nombre	Ruta de acceso	Tipo	Description
Ya en el canal	already_in_channel	boolean	Si el usuario ya está en el canal o no.
Channel	channel	Channel	Canal

JoinChannel_ResponseV2

Nombre	Ruta de acceso	Tipo	Description
Channel	channel	Channel	Canal
Advertencia	warning	string	Si el usuario ya está en el canal o no.

PostMessageResponse

Detalles del mensaje publicado en un canal de Slack.

Nombre	Ruta de acceso	Tipo	Description
Resultado correcto	ok	boolean	Indica si la operación se realizó correctamente.
Channel	channel	string	Canal al que se publicó el mensaje.
Hora de creación	ts	string	Marca de tiempo de Unix para cuando se creó el mensaje.
Tipo de mensaje	message.type	string	Tipo del mensaje.
Texto del mensaje	message.text	string	Cuerpo del mensaje.
Hora de creación	message.ts	string	Marca de tiempo de Unix para cuando se creó el mensaje.
Mensajes de error	error	string	Detalles de los mensajes de error, si los hay.