Cómo conectar Slack a Shopify Flow
Slack firma todas las solicitudes que envía a su aplicación - comandos de barra, mensajes interactivos y envíos a través de la API de eventos - con el secreto de firma de su aplicación. Workflow Webhooks convierte esa llamada en un activador de Shopify Flow, de modo que su tienda pueda reaccionar ante ella: etiquetar a un cliente, añadir una nota al pedido, enviar un correo electrónico interno, actualizar un metacampo… cualquier cosa que Shopify Flow pueda hacer.
Esta guía establece todo el proceso - Slack envía, Workflow Webhooks recibe y verifica, Shopify Flow actúa - con la firma HMAC de Slack comprobada en cada solicitud, de modo que solo Slack pueda iniciar su flujo de trabajo.
Lo que puede construir
- Permita que su equipo active un flujo de trabajo de Shopify Flow desde Slack mediante un comando con barra, sin conceder a nadie acceso de administrador.
- Apruebe algo en Slack y haga que Shopify Flow etiquete el pedido o al cliente que se ha aprobado.
- Convierta un atajo de Slack en una acción de la tienda: añada una etiqueta, envíe un correo electrónico o actualice un metacampo.
Eventos típicos que se pueden enviar: un comando con barra, como /restock, la pulsación de un botón en un mensaje interactivo o un evento de la API de eventos.
Antes de empezar
- Workflow Webhooks instalado en su tienda Shopify.
- Shopify Flow instalada, que se puede descargar de forma gratuita desde la App Store de Shopify.
- Una cuenta en Slack con permiso para crear webhooks.
Paso 1: Cree el webhook en Workflow Webhooks
- Acceda a Workflow Webhooks -> Webhooks -> Crear webhook y asígnele un nombre que pueda reconocer en Shopify Flow, como por ejemplo
Slack events. - En «Autenticación», seleccione HMAC.
- En «Proveedor de firma», seleccione Slack. La aplicación rellena automáticamente el encabezado, el algoritmo, el payload firmado y la ventana de repetición; no hay que configurar nada más.
- Deje el campo «Secreto» en blanco por ahora y haga clic en «Guardar». Copie la URL del webhook que aparece en la página.
Consulte Autenticación para conocer los demás modos de autenticación, y Asignación de la carga útil y variables de flujo para seleccionar qué campos se envían a Shopify Flow.
Paso 2: Añada el punto final en Slack
En la configuración de su aplicación de Slack, añada la URL como «URL de solicitud» para el comando de barra, la interactividad o la API de eventos, y copie el «Secreto de firma» de «Información básica» → «Credenciales de la aplicación».
Cómo encontrar su secreto de firma de Slack
Secreto de firma de la aplicación Slack (Información básica -> Credenciales de la aplicación).
La propia documentación de Slack sobre las firmas de webhooks, disponible en, incluye la redacción exacta y las capturas de pantalla correspondientes a su cuenta.
Pegue esa clave secreta en el campo «Secret» del webhook en Workflow Webhooks y guarde los cambios. A partir de ese momento, cada mensaje de Slack se verificará antes de llegar a Shopify Flow.
Qué comprueba esto
| ¿Qué? | Valor |
|---|---|
| Encabezado de la firma | X-Slack-Signature |
| Dónde se coloca la firma | El valor del encabezado, tras el prefijo v0= |
| ¿Qué se ha firmado? | v0:{timestamp}:{body} |
| Firma | HMAC-SHA256, codificado en hexadecimal |
| Marca de tiempo | El encabezado X-Slack-Request-Timestamp, expresado en segundos de Unix |
| Protección contra la reproducción | Se rechazan las solicitudes cuya marca de tiempo firmada se sitúe a más de 5 minutos del momento actual. |
| El secreto | Se utiliza como texto sin formato. Péguelo tal y como lo muestra el remitente. |
En la payload firmada, {body} es el cuerpo de la solicitud sin procesar, byte a byte, y {timestamp} es la marca de tiempo mencionada anteriormente.
Cualquier solicitud que incumpla alguno de estos requisitos se rechaza con el código de error 401, se registra en Historial y resolución de problemas y nunca inicia un flujo de trabajo.
Paso 3: Crear el flujo de trabajo Shopify Flow
- En «Shopify Flow», cree un flujo de trabajo y seleccione el activador «Workflow Webhooks».
- Haga clic en «Grabar eventos» y, a continuación, envíe un evento de prueba desde Slack (o utilice la opción «Enviar prueba» en Workflow Webhooks) para que Shopify Flow aprenda la estructura de sus datos.
- Cada webhook que tenga activa el mismo activador de Flow, por lo que debe añadir una primera condición basada en el ID del webhook para que este flujo de trabajo se limite exclusivamente a Slack. El ID aparece en la página del webhook.
- Añada sus acciones: etiquete a un cliente, añada una nota, envíe un correo electrónico interno, actualice un metacampo.
Paso 4: Realice una prueba de extremo a extremo
Activa un evento real en Slack. En Workflow Webhooks -> Historial debería ver la invocación con el estado «Éxito». Si la firma era incorrecta, aparecerá una entrada de error con el motivo correspondiente; además, en Verificación de webhooks firmados se explica cómo funciona el verificador de firmas, que le muestra exactamente en qué paso se produjo el error.
La firma no coincide▾
En este pedido: el secreto (la causa más habitual: un espacio de más o una clave procedente de un entorno incorrecto), si el remitente está utilizando el secreto de otro punto final y si algún elemento entre Slack y la aplicación reescribe el cuerpo del mensaje. Las firmas abarcan los bytes sin procesar, por lo que un proxy que reformatee el JSON las invalida. El verificador de firmas de la página de webhooks muestra el texto exacto que se ha firmado.
Me aparece el error 401 en todas las solicitudes▾
Compruebe que la autenticación del webhook esté configurada en HMAC con el proveedor Slack seleccionado, que se haya introducido el secreto y que Slack esté enviando la solicitud a la URL exactamente tal y como la muestra la aplicación, incluido el código al final.
No aparece nada en el historial▾
La solicitud nunca llegó. Vuelva a comprobar la URL en Slack y consulte el propio registro de entrega de Slack para ver la respuesta que recibió. Un 404 indica que el webhook es incorrecto o ha sido eliminado; un 429 significa que ha superado el límite de invocaciones de su plan; consulte Planes y uso.
El flujo de trabajo se ejecuta para eventos incorrectos▾
Cada webhook de su tienda activa el mismo activador de Shopify Flow. Añada una condición basada en el identificador del webhook como primer paso del flujo de trabajo, o limite los eventos que envía desde Slack.
Las solicitudes fallan con el mensaje «marca de tiempo fuera de los límites de tolerancia»▾
Slack incluye una marca de tiempo y la aplicación rechaza cualquier evento con más de 5 minutos de antigüedad. Normalmente, esto se debe a un problema de reloj en el lado del remitente o a que Slack ha vuelto a intentar el envío mucho más tarde con la marca de tiempo original. Los nuevos intentos de la misma solicitud original no pueden pasar; pida a Slack que envíe un evento nuevo.
Relacionado
- Verificación de webhooks firmados - todos los proveedores que verificamos, y cómo describir a aquellos que no verificamos.
- Asignación de la carga útil y variables de flujo - extraer los campos adecuados de la payload e introducirlos en Shopify Flow.
- Protección contra entregas duplicadas - ¿Qué ocurre cuando Slack vuelve a intentar realizar un envío?
- Historial y resolución de problemas - el registro de todas las solicitudes, con la posibilidad de reproducirlas.