Documentación
Conectar Slack con un webhook entrante
Crea un webhook entrante de Slack para un canal, añádelo a AutoPSEO, envía un mensaje de prueba y soluciona los errores que devuelve Slack cuando falla un envío.
AutoPSEO publica en Slack mediante webhooks entrantes. Slack te proporciona una URL que escribe en un único canal, la pegas en AutoPSEO y los informes y las alertas empiezan a llegar a ese canal. AutoPSEO no instala nada en tu espacio de trabajo: no puede leer mensajes, ver la lista de tus canales ni publicar en ningún sitio al que no apunte el webhook. Añade una entrada por cada canal en el que quieras recibir mensajes.
Crear el webhook en Slack
Slack emite los webhooks entrantes a través de una app de Slack. Siguiendo la guía de webhooks entrantes de Slack:
- Crea una app de Slack para tu espacio de trabajo, o abre una que ya uses para notificaciones. Elige un nombre que tu equipo reconozca, como Informes SEO.
- En la configuración de la app, abre Incoming Webhooks y activa Activate Incoming Webhooks.
- Haz clic en Add New Webhook to Workspace, elige el canal y aprueba. Si se trata de un canal privado, primero debes ser miembro de él.
- Copia la nueva URL desde Webhook URLs for Your Workspace. Empieza por
https://hooks.slack.com/services/.
Repite los pasos 3 y 4 para cada canal adicional; una misma app puede tener varios webhooks. Una URL creada con los antiguos webhooks de integración personalizada de Slack también sigue funcionando, aunque Slack recomienda migrarlos a una app.
Slack trata la URL como un secreto: cualquiera que la tenga puede publicar en el canal. Pégala en AutoPSEO y no la incluyas en tickets, wikis ni capturas de pantalla.
Añadirlo a AutoPSEO
- En Slack, Teams & Webhooks, busca Slack - Connected workspaces y haz clic en Add to Slack. Se abre el formulario New channel con Slack ya seleccionado como destino.
- Name: una etiqueta para las listas de AutoPSEO, el historial de envíos y el mensaje de prueba, por ejemplo
#seo-alerts. - Webhook URL: pega la URL de Slack. Para una entrada de Slack, AutoPSEO solo acepta direcciones
httpsde slack.com y te avisa al instante si la URL no es válida. - Haz clic en Add channel y, a continuación, en Send test en la fila nueva. En unos segundos debería aparecer en Slack un mensaje breve con el nombre de la entrada, y AutoPSEO te indica cuánto tardó Slack en responder.
La URL se almacena cifrada (AES-GCM). A partir de ese momento, la lista solo muestra su host y los últimos caracteres, así que elige nombres que dejen claro a qué canal de Slack corresponde cada entrada.
Después, dale algo que publicar: un informe programado o una alerta. La tabla Slack - Subscriptions, situada debajo de la lista, muestra entonces, por cada canal de Slack, todas las reglas que publican en él, su programación y si están activas o en pausa.
Varios canales y espacios de trabajo
Un webhook pertenece a un solo canal de un solo espacio de trabajo, y Slack no permite que un mensaje sustituya el canal para el que se creó el webhook. Esto hace que todo sea predecible:
- Un canal de Slack, una entrada. Para repartir a los clientes entre
#client-ay#client-b, crea un webhook para cada uno y añade ambos. - Varios espacios de trabajo funcionan igual, ya que cada webhook vive en el espacio de trabajo donde lo creaste.
- Una entrada puede tener muchas reglas. Envía el informe semanal y la alerta de caída de tráfico a la misma entrada, o mantén las alertas en un canal propio con más actividad.
Por qué no llegó un mensaje
Send test muestra el motivo de inmediato. En el caso de los mensajes programados, abre Delivery history, que conserva la respuesta de Slack a cada intento fallido.
| Lo que muestra AutoPSEO | Qué significa | Qué hacer |
|---|---|---|
| Slack rechazó la URL (no_service) | El webhook se eliminó o se desactivó en Slack, o la URL tiene un error de escritura | Crea un webhook nuevo, añádelo y elimina después la entrada antigua |
| El canal de Slack ya no existe o está archivado | Slack respondió channel_not_found o channel_is_archived | Crea un webhook para un canal que siga en uso |
| Slack está limitando la frecuencia de envíos | Slack respondió con HTTP 429 | Espera un poco y usa Send now o Test rule |
| Tiempo de espera agotado tras 10 segundos | Slack no respondió a tiempo | Inténtalo de nuevo más tarde |
| Tu periodo de prueba ha terminado | No hay un plan ni una prueba activos | Elige un plan; los envíos programados se reanudan con él |
Un informe programado que falla no se vuelve a enviar en el mismo periodo, así que usa Send now cuando hayas corregido la causa. Una alerta que no se pudo publicar se evalúa de nuevo en su siguiente comprobación (cuándo se ejecutan las alertas).
Eliminar un canal de Slack
Delete en la fila de la entrada elimina la URL almacenada y, tras una confirmación que te indica cuántas son, todas las reglas que publican en ella. AutoPSEO no cambia nada en Slack: el webhook sigue funcionando hasta que alguien lo elimine en la app de Slack, así que hazlo también allí si es posible que otras personas hayan visto la URL.