Notificaciones en Slack

LeadsBase puede enviar mensajes directamente a tus canales de Slack para mantener al equipo informado sin entrar al dashboard. La integración usa el modelo oficial de Slack Apps y es compatible con todos los planes de Slack.

1. Instalar la app de Slack

En Ajustes → Integraciones → Slack → Instalar te llevamos al consentimiento OAuth de Slack. Pedimos los siguientes scopes:

• channels:read — listar canales públicos del workspace.
• chat:write — enviar mensajes al canal seleccionado.
• incoming-webhook — registrar la URL de webhook firmada.

Solo administradores de Slack pueden aprobar la instalación. Si tu organización requiere revisión previa de apps, comparte el ID de app A07XXXXXX con el equipo de IT.

2. Elegir canales destino

Una vez instalada, configura qué eventos van a qué canal:

• #comercial-leads → nuevas empresas detectadas en mapas guardados.
• #data-ops → finalización de jobs de enriquecimiento.
• #compliance → solicitudes RGPD recibidas (acceso, supresión, oposición).
• #alertas → errores de integración o anomalías de uso.

Puedes asignar varios eventos al mismo canal o crear configuraciones por equipo.

3. Eventos disponibles

LeadsBase emite los siguientes eventos:

• map.new_companies — empresas nuevas que cumplen los criterios de un mapa guardado.
• enrichment.completed — un job de enriquecimiento ha terminado.
• enrichment.failed — job ha fallado, con motivo.
• rgpd.request_received — un interesado ejerció un derecho RGPD que afecta a una empresa de tu cartera.
• billing.invoice_paid — pago de factura recibido.
• billing.payment_failed — fallo de cobro (tarjeta caducada, fondos insuficientes).
• webhook.delivery_failed — un webhook saliente no respondió 2xx tras 3 reintentos.

4. Formato de mensaje

Los mensajes usan Slack Block Kit con secciones formateadas:

[New companies] 🆕 12 nuevas en mapa "Tech Madrid"
• Empresa Alfa SL · CNAE 6201 · 25 empleados
• Beta Tech SA · CNAE 6202 · 50 empleados
• ... 10 más

[Ver mapa en LeadsBase →]

Los enlaces apuntan directamente al recurso correspondiente, con autenticación SSO si tu workspace lo tiene activado.

5. Comandos slash

Activa los comandos slash en Integraciones → Slack → Comandos y podrás consultar LeadsBase sin salir de Slack:

• /leadsbase buscar <razón social o CIF> — busca una empresa.
• /leadsbase mapa <nombre> — link al mapa indicado.
• /leadsbase cartera <razón social> — comprueba si está en tu cartera.

La respuesta llega como mensaje privado del bot, solo visible para quien ejecutó el comando.

6. Mute temporal y horas de silencio

Si no quieres notificaciones fuera de horario:

• Horario de envío: configura ventana horaria (ej. 09:00-19:00 L-V).
• Mute por evento: silencia un evento concreto durante 1, 7 o 30 días.
• Mute global: pausa todas las notificaciones durante una migración o vacaciones.

Los eventos silenciados quedan registrados en el log y los puedes consultar al volver.

7. Desinstalar

En Integraciones → Slack → Desinstalar revocamos el token OAuth en Slack y eliminamos la configuración. Los mensajes ya enviados permanecen en los canales como histórico.

Si tienes varios workspaces de Slack (ej. uno por marca o por equipo), conecta varios desde el mismo botón Conectar otro workspace. Cada workspace tiene su propia configuración de canales y eventos.

Para eventos custom o sistemas internos que no usan Slack, ver webhooks.