IBM Cloud Docs
Slack

Slack

Slack es una plataforma de mensajería que ayuda a los equipos a conectarse y colaborar. Cuando selecciona Slack como destino de servicio, cualquier notificación suscrita sobre un suceso se puede enviar como un mensaje a los canales Slack.

Cuando se envía un mensaje con una longitud superior a 3000 caracteres a Slack, el texto del mensaje se trunca con los líderes [...].

Generar URL de webhook entrante de slack

Para publicar una notificación de Slack, que necesita para generar una URL webhook entrante. Para generar la URL, siga estos pasos: Webhooks entrantes para Slack.

Configuración de un destino de slack

Antes de configurar Slack como destino de los mensajes directos, asegúrate de haber creado y configurado una aplicación Slack con un ámbito de token de bot de chat:write. Consulte la documentación de la API de Slack para obtener más información: (https://api.slack.com/quickstart#creating).

Para configurar un destino Slack, siga estos pasos:

  1. Inicie sesión en el panel de control de su instancia Event Notifications y vaya a Destinos.

  2. Haga clic en Añadir para añadir un nuevo destino.

  3. En el panel lateral Añadir un destino, facilite los siguientes datos:

  • Nombre: Introduzca un nombre para el destino.
  • Descripción: Opcionalmente, introduce una descripción para tu destino.
  • Tipo: En Destino, selecciona Slack de la lista como tipo de destino.
  • Enviar mensajes: Elige una de las siguientes opciones:
    • Uso de webhooks entrantes: Proporcione la URL del webhook entrante de Slack.
    • Usando mensajes directos: Proporciona el Bot User OAuth Token.

Configuración de una suscripción de slack

  1. Uso de webhooks de entrada
    • Puede añadir color de adjunto a las suscripciones individuales de Slack basándose en un código hexadecimal. Por ejemplo, utilice #0000FF para establecer el color en azul.
  2. Uso de mensajes directos
    • Puede proporcionar una lista de identificadores de miembros y de canales. Si se proporcionan identificadores de canal, la aplicación se integrará en los canales especificados.

Aspecto de una notificación de holgura predeterminada (sin plantilla) de Event Notifications

La notificación de sucesos genera notificaciones de slack procedentes de la carga útil entrante La plantilla de notificación de sucesos que se utiliza para enviar a slack se parece a la siguiente:

{
  "blocks": [
    {
      "type": "rich_text",
      "elements": [
        {
          "type": "rich_text_section",
          "elements": [
            {
              "type": "text",
              "text": "{{ibmendefaultshort}}", // Read from event payload
              "style": {
                "bold": true
              }
            }
          ]
        }
      ]
    },
    {
      "type": "section",
      "text": {
        "type": "plain_text",
        "text": "{{ibmendefaultlong}}", // Read from event payload
        "emoji": true
      }
    },
    {
      "type": "divider"
    },
    {
      "type": "context",
      "elements": [
        {
          "type": "mrkdwn",
          "text": "```{{event_payload}}```" // Full notification payload sent to /notifications endpoint
        }
      ]
    }
    ]
}

Aquí -

ibmendefaultshort es la carga útil corta predeterminada que se proporciona en la carga útil entrante. ibmendefaultlong es la carga útil larga por defecto que se proporciona en la carga útil entrante. data son los datos JSON proporcionados en la carga útil entrante y formateados como JSON en la notificación de Slack.

Para obtener más información sobre cómo crear y utilizar las plantillas de notificación de Slack, consulte aquí

Prueba de una configuración de destino de Slack

Puede probar un destino de Slack en el menú de opciones que proporciona el destino. Puede probar fácilmente un destino, tanto si la configuración proporcionada es correcta como si no lo es con un solo clic.

Para obtener más información sobre cómo probar un destino, consulte aquí.

Política de reintentos de slack

Al publicar una notificación de slack, problemas como errores de red y fallos de aplicación pueden hacer que las solicitudes fallen. Se utiliza un reintento para proporcionar resiliencia a las solicitudes externas. Pruebe a reintentar las solicitudes en tales situaciones utilizando los valores siguientes:

  • Límite = 60 segundos: tiempo total que el servicio dedica a reintentar.
  • Paso = 5 segundos: después de cada anomalía, el servicio espera 5 segundos antes de reintentar. Este retraso impide el bombardeo de los servicios externos (webhook).

Además, las condiciones de tiempo de espera siguientes hacen que la llamada de slack falle:

  • Un tiempo de espera de conexión de 10 segundos
  • Un tiempo de espera de respuesta de 60 segundos

Si una llamada al URL de Webhook de Slack falla incluso después de reintentos, la notificación se pierde.