Redactar mensajes de Block Kit

Objetivos de aprendizaje

Después de completar esta unidad, podrá:

Redactar un mensaje de Block Kit con Block Kit Builder.
Utilizar plantillas para crear mensajes más personalizados.
Explicar qué son las cargas de mensajes.

Enviar mensajes de Block Kit

En segundo plano, los mensajes de Block Kit son cargas de JSON que desglosan los tipos de bloques que se utilizan. Se pasan entre la aplicación y Slack a través de la API web de Slack. Si bien puede crear bloques de mensajes de forma manual, existe una forma más sencilla e intuitiva de utilizar Block Kit Builder.

Redactar mensajes con Block Kit Builder

Ahora que conocemos los tipos de bloques, elementos de bloque y superficies, aprendamos cómo crear mensajes de Block Kit sencillos y complejos.

Todo en un solo lugar, con Block Kit Builder puede elegir bloques del panel izquierdo (1) y, a continuación, arrastrar, soltar y volver a organizarlos para diseñar y obtener una vista previa de los diseños de Block Kit en el panel central (2). Una vez que ha creado un mensaje de Block Kit a su gusto, puede copiar la matriz de JSON necesaria para la aplicación de Slack (3) o puede enviarla de forma directa a Slack con el clic de un botón (4).

Interfaz de Block Kit Builder con cada sección numerada como se describe arriba

Block Kit Builder también tiene mensajes de plantilla que puede utilizar como punto de partida para tareas como aprobaciones, votaciones, incorporaciones y boletines de noticias.

De forma alternativa, puede utilizar la guía de referencia de bloque para generar de forma manual una matriz de bloque completa.

Explorar la estructura de carga de mensajes

La estructura de la carga de mensajes o de la instrucción de bloques es universal. Cada bloque contiene un campo de tipo, que especifica qué tipo de bloque se utiliza, junto con otros campos que describen el contenido del bloque.

Echemos un vistazo a la plantilla de incorporación a continuación. Este mensaje está redactado con bloques de sección, imagen y contexto para el diseño. También hay un elemento interactivo anidado en una de las secciones, conversations_select. Esta plantilla se puede utilizar tal cual está o puede ser el punto de partida de un flujo de trabajo más sólido para incorporar a un nuevo miembro del equipo.

{
    "blocks": [
        {
            "type": "section",
            "text": {
                "type": "mrkdwn",
                "text": "Hey there 👋 I'm TaskBot. I'm here to help you create and manage tasks in Slack.\nThere are two ways to quickly create tasks:"
            }
        },
        {
            "type": "section",
            "text": {
                "type": "mrkdwn",
                "text": "*1️⃣ Use the `/task` command*. Type `/task` followed by a short description of your tasks and I'll ask for a due date (if applicable). Try it out by using the `/task` command in this channel."
            }
        },
        {
            "type": "section",
            "text": {
                "type": "mrkdwn",
                "text": "*2️⃣ Use the _Create a Task_ action.* If you want to create a task from a message, select `Create a Task` in a message's context menu. Try it out by selecting the _Create a Task_ action for this message (shown below)."
            }
        },
        {
            "type": "image",
            "title": {
                "type": "plain_text",
                "text": "image1",
                "emoji": true
            },
            "image_url": "https://api.slack.com/img/blocks/bkb_template_images/onboardingComplex.jpg",
            "alt_text": "image1"
        },
        {
            "type": "section",
            "text": {
                "type": "mrkdwn",
                "text": "➕ To start tracking your team's tasks, *add me to a channel* and I'll introduce myself. I'm usually added to a team or project channel. Type `/invite @TaskBot` from the channel or pick a channel on the right."
            },
            "accessory": {
                "type": "conversations_select",
                "placeholder": {
                    "type": "plain_text",
                    "text": "Select a channel...",
                    "emoji": true
                }
            }
        },
        {
            "type": "divider"
        },
        {
            "type": "context",
            "elements": [
                {
                    "type": "mrkdwn",
                    "text": "👀 View all tasks with `/task list`\n❓Get help at any time with `/task help` or type *help* in a DM with me"
                }
            ]
        }
    ]
}

El resultado es un mensaje significativo y enriquecido que permite que los nuevos usuarios de Slack creen tareas de acuerdo con el flujo de trabajo configurado por el equipo, completo con distintos pasos, capturas de pantalla y un elemento interactivo que permite que los usuarios agreguen el bot a un canal.

Vista previa de mensaje de incorporación de TaskBot que guía al usuario sobre cómo usar el comando /task y la acción Crear una tarea, y cómo agregar TaskBot a un canal

Pero ¿cómo interactúa el usuario con estos mensajes? En la próxima unidad, veremos cómo manejar la interactividad con una carga de Block Kit. Manejar la interacción del usuario es un paso clave para hacer flujos de trabajo y mensajes de Block Kit funcionales.

Recursos

Aplicación de Slack: Block Kit Builder (requiere inicio de sesión)