antworkDOCS

Slack

Antwork publica en un canal de Slack los posts que te necesitan, y con la app de Antwork para Slack actúas sobre ellos desde ahí.

EstadoDisponible en todos los planesConfiguraciónAñadir a Slack o un webhook

Qué llega a Slack

Cada espacio de Antwork conecta un canal de Slack. En la página de Slack del espacio eliges cuáles de estos recibe:

EventoCuándo se publica
Borradores sin enviarUn borrador que hizo tu IA o la API y quedó sin enviar 5 minutos. Si lo envías desde el chat mientras tanto, nunca llega. Un post con una versión por red es un solo mensaje.
Posts pendientes de aprobaciónUn post retenido para aprobación, en espacios que la exigen (Agency).
Posts fallidosUn post que no se publicó, con el motivo y qué hacer.
Cuentas que reconectarComo mucho una vez cada 24 horas por cuenta, con un enlace para reconectar.
Posts publicadosCada post al publicarse, con un enlace. Desactivado por defecto.
Los mensajes se actualizan solos: cuando un post se envía, aprueba o publica en cualquier sitio (Slack, la app, tu IA o la API), su mensaje pierde los botones y dice qué pasó.

Conectar Slack

Con la app de Antwork para Slack (botones y /antwork)

  1. En Antwork, abre tu espacio y ve a Desarrollador → Slack.
  2. Pulsa Añadir a Slack e inicia sesión en el Slack que quieras.
  3. Elige el canal en la página de Slack y pulsa Permitir.
  4. Vuelves a Antwork, que saluda en el canal. Enviar prueba publica otro saludo cuando quieras.

Con un incoming webhook (solo enlaces)

Sin instalar ninguna app: los mensajes llegan con enlaces a Antwork en lugar de botones.

  1. En Slack, crea un incoming webhook para el canal (la app Incoming Webhooks de Slack).
  2. Copia su URL (https://hooks.slack.com/services/…).
  3. En Antwork, abre Desarrollador → Slack, elige pegar un incoming webhook y pégala.

Conectar, cambiar o quitar Slack lo puede hacer quien pueda cambiar los ajustes del espacio: el propietario y los administradores en Agency, cualquier miembro en los demás planes.

Botones y /antwork

Cada botón pasa los mismos controles que en el resto de Antwork, así que un post enviado desde Slack se rechaza por los mismos motivos que en la app (límites del plan, reglas de la red, falta una imagen).

BotónQué hace
Publicar ahoraPublica el borrador ya, en todas las redes del mensaje.
Programar en el próximo huecoLo programa en el siguiente hueco libre de la cuenta. Sin huecos configurados, Slack te pide elegir la hora en Antwork.
DescartarBorra el borrador de Antwork, tras confirmarlo.
AprobarAprueba un post retenido; sale ahora o a su hora programada.
Pedir cambiosDevuelve el post a su autor; añade una nota en Antwork.
ReintentarVuelve a publicar un post fallido.

Quién puede pulsarlos

  • Un clic solo cuenta desde el Slack que se conectó.
  • Quien pulsa debe ser miembro del espacio de Antwork, identificado por el email que Slack tiene suyo: tiene que ser el email con el que entra en Antwork.
  • Actúa con su propio rol en Antwork: enviar requiere permiso para enviar posts; aprobar, ser propietario o administrador en un plan con aprobaciones. Cualquier otra persona recibe una nota privada y no pasa nada.

/antwork

Escribe /antwork en cualquier canal para ver, en privado, qué tienes pendiente en el espacio conectado: borradores, posts que aprobar, programados y fallos de esta semana. /antwork help lo explica.

Permisos y datos

La app de Antwork para Slack pide estos permisos y solo los usa para esto:

PermisoPara qué
chat:writePublicar los mensajes de Antwork y actualizarlos cuando un post cambia.
chat:write.publicPublicar en el canal público que elegiste sin tener que invitar antes a la app.
commandsResponder a /antwork.
incoming-webhookQue elijas el canal en la propia página de Slack al instalar.
users:readSaber quién pulsó un botón.
users:read.emailRelacionar a quien pulsa con un miembro de Antwork por su email.

Qué guarda y envía Antwork

  • Guarda: los nombres del Slack y del canal, y el token de la app o la URL de tu webhook, cifrados.
  • Envía a Slack: la red, la cuenta y el texto del post, como texto plano (un borrador no puede hacer @channel ni esconder un enlace), su estado y el consejo si falló.
  • Lee de Slack: solo el email de quien pulsa un botón o usa `/antwork`, para relacionarlo con un miembro de Antwork. Nunca lee los mensajes de tus canales.
  • Quitar Slack borra la conexión y revoca el token de la app.

Cambiarlo o quitarlo

  • Eventos: activa o desactiva cada evento en la página de Slack del espacio.
  • Enviar prueba publica un saludo y muestra la respuesta de Slack si falla.
  • Desconectar borra la conexión y revoca el token; también puedes quitar la app desde los ajustes de Slack.
  • Si se quita la app de Slack, se archiva el canal o Slack falla durante un día, Antwork desactiva la conexión y explica el motivo en la página de Slack. Volver a activar un evento la reactiva.

Preguntas

5
¿Qué planes incluyen Slack?
Todos. Los botones de aprobación solo aparecen en espacios con aprobaciones, que es una función de Agency.
¿Puede Slack publicar algo que no he aprobado?
No. No se publica nada sin que una persona pulse un botón (o lo envíe desde otro sitio); Antwork no decide nada en Slack.
¿Puedo conectar más de un canal?
Un canal por espacio de Antwork. Varios espacios pueden publicar cada uno en su canal, en el mismo Slack o en otros.
¿Antwork lee mis mensajes de Slack?
No. Publica y actualiza sus propios mensajes, y solo lee el email de quien pulsa uno de sus botones o usa /antwork.
¿Cómo lo quito?
Desconéctalo en la página de Slack del espacio en Antwork, o quita la app de Antwork en Slack. Cualquiera de las dos detiene todos los mensajes.

Ayuda

¿Dudas o un problema con Slack? Escribe a iker.gonzalez@antwork.io.

WebhooksZapierTodas las integraciones

¿Algo no cuadra? Dinos cuál.