Guías de Workflow

Uso de notificaciones de Slack

Última actualización: May 2022 • Tiempo de lectura estmiado: 6 MIN

Si su equipo usa Slack, puede configurar un flujo de trabajo de Kustomer para notificar a un canal cada vez que ingrese un nuevo mensaje de chat. Este artículo lo guiará a través de los pasos para crear un flujo de trabajo para que nunca se pierda otro chat entrante de un cliente.

¿Quién puede acceder a esta función?

Los administradores pueden acceder a la configuración del flujo de trabajo.
Disponible para todas las organizaciones en todos los planes.

En este articulo

Requisitos previos
Encuentre su URL de Webhook de Slack
Crear el flujo de trabajo
Introduzca el código JSON del flujo de trabajo

Requisitos previos

Antes de seguir esta guía, le recomendamos que ya se sienta cómodo con los conceptos básicos del uso de Workflows: Resumen de Workflows

Deberá tener una cuenta de Slack activa y comprender el uso de webhooks y trabajar con API de desarrollador. Estos dos documentos cubren la información básica necesaria que se aplicará en este tutorial:

API de Slack: envío de mensajes mediante webhooks entrantes
API de Kustomer: llamar a una API REST dentro de un flujo de trabajo

Encuentre su URL de webhook de Slack

Antes de que pueda comenzar el proceso de configuración en Kustomer, deberá crear un webhook entrante en Slack. Para configurar esto, siga estos pasos desde la API de Slack: Envío de mensajes usando Webhooks entrantes.

Cuando se complete esta configuración, tome nota de la URL de su webhook; lo necesitará más adelante en el proceso de configuración en la configuración de Kustomer. Su URL de webhook de Slack tendrá este formato:

				
					https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Crear el flujo de trabajo

Ahora, abrirá Kustomer. El primer paso será crear el flujo de trabajo.

Vaya a Configuración y seleccione Plataforma > Flujos de trabajo.
Seleccione Agregar flujo de trabajo.
Aparecerá el modal Nuevo flujo de trabajo. Complete el Título del flujo de trabajo; puede dejar el campo Descripción en blanco porque nuestro fragmento de código se lo proporcionará.
Seleccione Crear para guardar el flujo de trabajo y comenzar a trabajar en el Editor de flujo de trabajo.

Introduzca el código JSON del flujo de trabajo

A continuación, utilizará el Editor de flujo de trabajo para pegar un código de flujo de trabajo que se proporciona a continuación. Este código JSON se encargará de la mayor parte de la creación del flujo de trabajo, además de algunos valores de marcador de posición que deberá actualizar manualmente.

2. Aparece un modal donde puede editar el código para este flujo de trabajo directamente. Seleccione y elimine el código JSON actual.

3. Copie este bloque de código y péguelo en el campo de texto JSON en su Editor de flujo de trabajo:

				
					{
  "description": "Posts to Slack whenever a message is created with message conversation details.",
  "name": "slack",
  "steps": [
    {
      "id": "eeWBChdww",
      "transitions": [
        {
          "meta": {
            "name": "Email or SMS?"
          },
          "condition": {
            "values": [
              {
                "values": [
                  "/#steps.1.channel",
                  "email"
                ],
                "op": "contains"
              },
              {
                "values": [
                  "/#steps.1.channel",
                  "sms"
                ],
                "op": "contains"
              }
            ],
            "op": "or"
          },
          "target": "cSS3Gw1fV"
        }
      ]
    },
    {
      "appVersion": "kustomer-^1.2.1",
      "params": {
        "identifier": "/#steps.1.customer"
      },
      "action": "kustomer.customer.find",
      "id": "cSS3Gw1fV",
      "transitions": [
        {
          "condition": {
            "values": [
              true
            ],
            "op": "true"
          },
          "target": "VIK9f-WHk"
        }
      ]
    },
    {
      "appVersion": "kustomer-^1.2.1",
      "params": {
        "id": "/#steps.1.conversation"
      },
      "action": "kustomer.conversation.find-by-id",
      "id": "VIK9f-WHk",
      "transitions": [
        {
          "meta": {
            "name": "Inbound?"
          },
          "target": "eH6zZmIOm",
          "condition": {
            "op": "eq",
            "values": [
              "/#steps.1.direction",
              "in"
            ]
          }
        }
      ]
    },
    {
      "appVersion": "kustomer-^1.2.1",
      "params": {
        "headers": {
          "Content-Type": "application/json"
        },
        "uri": "SLACKHOOKHERE",
        "method": "POST",
        "json": true,
        "data": {
          "attachments": [
            {
              "fallback": "New message in Kustomer for conversation: {{steps.VIK9f-WHk.name}}",
              "pretext": "New message in Kustomer for conversation {{steps.1.conversation}}",
              "title": "Go to conversation",
              "title_link": "https://ORGNAME.kustomerapp.com/app/conversations/{{steps.1.conversation}}",
              "color": "#D00000",
              "fields": [
                {
                  "title": "Event",
                  "value": "Outbound Message Created",
                  "short": false
                },
                {
                  "title": "Customer Name",
                  "value": "/#steps.cSS3Gw1fV.name",
                  "short": false
                },
                {
                  "title": "Subject",
                  "value": "/#steps.VIK9f-WHk.name",
                  "short": false
                },
                {
                  "title": "Conversation Status",
                  "value": "/#steps.VIK9f-WHk.status",
                  "short": false
                },
                {
                  "title": "Message Direction",
                  "value": "/#steps.1.direction",
                  "short": false
                },
                {
                  "title": "Message Body",
                  "value": "/#steps.1.preview",
                  "short": false
                }
              ]
            }
          ],
          "username": "Kustomer",
          "channel": "#CHANNELNAME"
        }
      },
      "action": "kustomer.rest-api.json",
      "id": "eH6zZmIOm",
      "transitions": []
    }
  ],
  "trigger": {
    "transitions": [
      {
        "meta": {
          "name": "Filter imported messages"
        },
        "condition": {
          "values": [
            "/#steps.1.importedAt"
          ],
          "op": "dne"
        },
        "target": "eeWBChdww"
      }
    ],
    "eventName": "kustomer.message.create",
    "id": "1",
    "appVersion": "kustomer-^1.2.1"
  }
}

4. En las siguientes líneas, actualice las cadenas de marcador de posición de la siguiente manera:

- línea 83: SLACKHOOKHERE la URL del webhook de Slack, que localizó anteriormente.
- línea 92: ORGNAME: el subdominio de su organización Kustomer.
- línea 129: #NOMBRE DEL CANAL: el canal de Slack donde desea que se publiquen las notificaciones.

5. Seleccione Actualizar para descartar el editor JSON y guardar los cambios en este flujo de trabajo.

6. Si desea realizar otros cambios en este flujo de trabajo, puede hacerlo ahora. Cuando haya terminado, guarde y salga del Editor de flujo de trabajo.

Cuando esté listo para activar este flujo de trabajo, use el interruptor en la configuración del flujo de trabajo para activarlo o desactivarlo.

¿Te resultó útil este artículo

SiNo

¿Necesitas ayuda? Contáctanos