Envíe los envíos a Slack mediante un webhook
Agregue un punto final de webhook en la pestaña Entrega de un formulario, elija el formato de mensaje de Slack y pegue una dirección de webhook entrante de su propiedad. Es un formato de carga, no una integración nativa con Slack.
Esta publicación se tradujo automáticamente. Lee el original en inglés
FormFlow puede publicar un mensaje corto en Slack cada vez que un formulario recibe un envío. Lo hace mediante un punto final de webhook, el mismo mecanismo que reenvía envíos a cualquier URL de su propiedad. No es una integración nativa con Slack: no hay ninguna aplicación de Slack que instalar, ni inicio de sesión con Slack, ni selector de canal. Usted entrega a FormFlow una dirección de webhook entrante y FormFlow le envía un mensaje con formato de Slack. Este tutorial explica cómo configurarlo y dice con claridad qué contiene y qué no contiene el mensaje.
Qué necesita primero
Un formulario de su equipo que pueda editar.
Una dirección de webhook entrante de su propiedad: la URL de webhook entrante de su espacio de trabajo de Slack, o la dirección de cualquier punto final suyo que acepte el formato de mensajes de Slack. Créela en Slack siguiendo la documentación del propio Slack; este artículo no cubre ese lado.
Una dirección https. FormFlow rechaza http sin cifrar para los puntos finales de webhook.
Agregue el punto final
Abra el formulario y vaya a su pestaña «Entrega».
Busque «Puntos finales de webhook» y elija «Agregar punto final».
En el campo «Enviar como», elija «Mensaje de Slack». El valor predeterminado es «FormFlow JSON (firmado)», así que este cambio es toda la diferencia entre un punto final de Slack y un webhook normal.
El campo de la URL ahora se llama «URL de webhook entrante». Pegue allí su dirección. El campo se enmascara mientras escribe, y puede revelarlo para comprobar lo que pegó.
Deje «Entregando» activado. Viene activado de forma predeterminada; desactívelo para detener la entrega a este punto final.
Guarde el formulario.
El texto de ayuda bajo «Enviar como» dice que la dirección se almacena cifrada y nunca se vuelve a enviar por correo electrónico. La fila contraída del punto final nombra el formato en lugar de mostrar la dirección, de modo que la URL no queda en texto plano a lo largo de la página.
Envíe una prueba
Cada fila de punto final tiene una acción «Enviar prueba». Publica una sola línea, «FormFlow test — submissions from this form will arrive here.», en la dirección de la fila. Si funciona, verá «Prueba entregada»; si falla, verá «La entrega de la prueba falló», con el texto de error del propio receptor, recortado a 300 caracteres.
Se aplican dos condiciones. Guarde primero el formulario: un punto final que nunca se ha guardado no se puede probar, y la acción se lo indica. Y cada persona puede enviar 20 entregas de prueba por hora, contando las fallidas. Una prueba es un botón, no una puerta; el punto final entrega los envíos, la haya pulsado o no.
Qué llega al canal
El mensaje es un timbre, no el registro. Contiene:
Una primera línea en negrita: «New submission — » seguida del nombre del formulario.
Hasta cinco respuestas, una por línea, cada una con una etiqueta en negrita y un valor. Un valor se corta a los 200 caracteres.
Una línea que indica cuántos campos más hay, cuando el formulario tiene más de cinco.
Un enlace «View submission» al envío en su panel de control.
Los espacios en blanco dentro de un valor se colapsan, así que un valor solo puede ocupar una línea. Los caracteres &, < y > se escapan para que Slack no interprete el texto de un remitente como marcado, y un asterisco en un valor se sustituye por un carácter parecido para que un remitente no pueda falsificar una etiqueta en negrita. El mensaje es solo texto sin formato; no usa Block Kit de Slack.
Límites que conviene conocer
Unidireccional. FormFlow envía; nada de Slack vuelve a FormFlow.
Cinco respuestas como máximo, de 200 caracteres cada una. Para ver el envío completo, use el enlace o la bandeja de envíos.
Slack ignora la firma. Todos los formatos de webhook van firmados, pero Slack descarta el encabezado de la firma, así que no hay secreto de firma que copiar para un punto final de Slack.
Los envíos que FormFlow clasifica como spam no se reenvían. Solo los envíos aceptados y que no son spam llegan a un punto final de webhook.
Los reintentos, la espera progresiva entre ellos y la desactivación se comparten con todos los formatos de webhook. Un receptor que falla continuamente puede hacer que se desactive su punto final, así que revise la fila si los mensajes dejan de llegar.
La dirección es una credencial. Cualquiera que tenga una URL de webhook entrante de Slack puede publicar en ese canal. Trátela como una contraseña y sustitúyala en Slack si se filtra.
Lo que esto no decide
No elige su canal ni administra Slack por usted: la dirección que pega fija dónde llegan los mensajes, y eso se configura en Slack. No convierte a Slack en su bandeja de entrada; leer, buscar y exportar envíos sigue ocurriendo en FormFlow. Y no hace que el mensaje de Slack sea una copia de los datos. Si necesita que cada campo se entregue como datos estructurados, agregue un segundo punto final con el formato predeterminado FormFlow JSON.