Tools de Slack
Las 12 operaciones de Slack que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Listar conversacionesGETLista los canales del workspace: todos los canales públicos y los privados a los que se añadió la app. El id de un canal es el argumento channel de las otras tools, e is_member indica si la app está en él. La respuesta tiene channels y response_metadata.next_cursor: pásalo como cursor para leer la página siguiente.
- Crear conversaciónPOSTCrea un canal público o privado con la app como miembro y lo devuelve con su id. Agrega personas con Invite members to conversation.
- Unirse a una conversaciónPOSTAgrega la app a un canal público y devuelve el canal. La app debe ser miembro para leer los mensajes de un canal o publicar en él. A un canal privado no se puede unir así: un miembro agrega la app desde Slack.
- Invitar miembros a la conversaciónPOSTInvita a miembros del workspace a un canal en el que está la app. Si uno de los ids falla, no se invita a nadie salvo que force sea true.
- Listar mensajesGETLista los mensajes de un canal del que la app es miembro, del más nuevo al más antiguo. Las respuestas de hilos no se incluyen: léelas con List thread replies. La respuesta tiene messages, has_more y response_metadata.next_cursor: pásalo como cursor para leer la página siguiente. Una app instalada fuera de Slack Marketplace puede quedar limitada a 15 mensajes por llamada y una llamada por minuto.
- Listar respuestas de un hiloGETLista un hilo de un canal del que la app es miembro: el mensaje principal seguido de sus respuestas. La respuesta tiene messages, has_more y response_metadata.next_cursor: pásalo como cursor para leer la página siguiente. Una app instalada fuera de Slack Marketplace puede quedar limitada a 15 mensajes por llamada y una llamada por minuto.
- Enviar mensajePOSTPublica un mensaje como el bot de la app y lo devuelve con channel y ts, el par que piden Update message y Delete message. Envía text, markdown_text o blocks. La app debe ser miembro del canal: llama antes a Join conversation en un canal público.
- Programar mensajePOSTPrograma un mensaje del bot de la app para un momento de hasta 120 días adelante y devuelve su scheduled_message_id. Envía text, markdown_text o blocks. La app debe ser miembro del canal, y un canal admite como máximo 30 mensajes programados dentro de los mismos 5 minutos.
- Editar mensajePOSTEdita un mensaje que publicó el bot de la app y lo devuelve. Enviar text sin blocks reemplaza los blocks del mensaje por ese texto; omitir text los conserva.
- Eliminar mensajePOSTElimina un mensaje que publicó el bot de la app. Los mensajes de personas no se pueden eliminar con esta conexión.
- Listar usuariosGETLista los miembros del workspace con id, name, real_name y profile.email, incluidos bots (is_bot) y miembros desactivados (deleted). La respuesta tiene members y response_metadata.next_cursor: pásalo como cursor para leer la página siguiente.
- Obtener usuario por emailGETDevuelve el miembro del workspace que tiene esta dirección de email, con su id, para mencionarlo, invitarlo o enviarle un mensaje.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
