Saltar al contenido principal

Slack

Reelwire sube cada video a un canal de Slack a través de una aplicación de Slack propia: una aplicación hecha solo para su espacio de trabajo no necesita revisión de Slack, solo dos permisos y un lugar en el canal.

Lo que necesita​

  • Un token de bot de su aplicación de Slack, que empieza por xoxb-, con los permisos files:write y chat:write, y la rotación de tokens desactivada: un token con rotación deja de funcionar a las doce horas.
  • El ID del canal en el que publica, con la aplicación añadida a ese canal.

Configuración​

  1. Cree la aplicación. Abra api.slack.com/apps y pulse Create New App. Slack ofrece primero sus plantillas; en Or start your own way, elija From a manifest y pulse Continuar.

  2. Pegue su manifiesto. Cambie a YAML y sustituya lo que hay por las líneas de abajo. Cambie Reelwire en los dos sitios por el nombre que deben mostrar las publicaciones, elija su Espacio de trabajo y pulse Next.

    display_information:
      name: Reelwire
      description: Posts our short-form videos into Slack.
    features:
      bot_user:
        display_name: Reelwire
        always_online: false
    oauth_config:
      scopes:
        bot:
          - chat:write
          - files:write
          - channels:read
    settings:
      org_deploy_enabled: false
      socket_mode_enabled: false
      token_rotation_enabled: false

    Le da a la aplicación exactamente lo que necesita: chat:write y files:write para publicar el video, y channels:read para que Reelwire pueda nombrar el canal tras comprobarlo (publica sin él). Mantiene la rotación de tokens desactivada.

  3. Cree e instale. Slack muestra lo que puede hacer la aplicación: Post messages, Files y Canales. Pulse Create and Install y Allow si Slack lo pide.

  4. Copie el token. En los ajustes de la aplicación, abra OAuth & Permissions (o Install App) y copie el Bot User OAuth Token, que empieza por xoxb-. Manténgalo en privado: quien lo tenga puede publicar como la aplicación.

  5. Añada la aplicación al canal. En Slack, abra los detalles del canal (su nombre arriba), elija la pestaña Agents & apps, pulse Add Agent or App y luego Añadir junto a su aplicación. Enviar /invite @ y el nombre de la aplicación en el canal hace lo mismo. Sin esto, Slack rechaza todas las publicaciones.

  6. Busque el ID del canal. Está al pie de la pestaña Acerca de de los detalles del canal, empieza por C (G en algunos canales privados), como C0123456789, con un botón para copiarlo. No es el nombre del canal.

  7. Introduzca ambos en Reelwire. En Canales, abra los Ajustes del canal, elija Slack como Plataforma y la Relación de aspecto, y en Entrega por conector de plataforma pegue el Token de bot y el ID del canal. Actívelo, junto al nombre de la sección.

  8. Probar conector de plataforma. Reelwire pregunta a Slack si el token funciona, sin publicar nada, y muestra la aplicación y el espacio de trabajo bajo el botón, o el motivo de Slack.

  9. Guardar.

Las publicaciones muestran el nombre y la imagen de la aplicación. Póngale una imagen en Basic Information, Display Information, App icon: un cuadrado de al menos 512 píxeles.

¿Prefiere hacer clic a pegar? Elija Blank app en el paso 1 y póngale nombre. En OAuth & Permissions, Scopes, Bot Token Scopes, añada files:write y chat:write (y channels:read si quiere), pulse el botón Install to de la misma página y siga con el paso 4.

Cómo se ve una publicación​

El video, subido al canal y reproducido allí, con el texto a su lado como mensaje: las propias palabras de la publicación, la línea de la marca, el enlace y los hashtags, hasta 4000 caracteres.

Cambios y retiradas​

Enviar solicitud de eliminación elimina el video y su mensaje. Slack no da a una aplicación forma de cambiar el texto junto a un archivo que compartió, así que Enviar solicitud de actualización lo indica: elimine la publicación y publíquela de nuevo, o edite el mensaje a mano en Slack.

Cuando algo va mal​

La publicación diceQué hacer
Slack rechazó el tokenCopie de nuevo el Bot User OAuth Token de OAuth & Permissions y guárdelo. Si funcionó durante doce horas y luego dejó de hacerlo, la rotación de tokens está activada, algo que Slack no puede volver a desactivar: cree una aplicación nueva con el manifiesto de arriba.
A la aplicación de Slack le falta un permiso que necesitaAñada files:write y chat:write, reinstale la aplicación y guarde su nuevo token.
La aplicación de Slack no está en ese canalAñádala al canal (paso 5) y luego Reenviar solicitud de publicación en Más de la pantalla Publicaciones.
Slack no encuentra ese canalCompruebe el ID del canal: empieza por C y está al pie de la pestaña Acerca de de los detalles del canal. Añada primero la aplicación si el canal es privado.
Ese canal de Slack está archivadoDesarchívelo en Slack o introduzca el ID de otro canal.
Slack no aceptó el videoLas subidas de archivos están desactivadas en su espacio de trabajo de Slack, o limitadas por debajo del tamaño del clip: pregunte a quien lo administra.

Para detenerlo, desactive el conector en el canal. Para terminarlo definitivamente, quite la aplicación en Slack bajo el nombre de su espacio de trabajo arriba a la izquierda, Tools & settings, Manage apps, lo que revoca su token, o elimínela al pie de Basic Information en api.slack.com.