> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Slack

> Conecte Living Security con Slack para enviar notificaciones de capacitación, alertas de seguridad y actualizaciones de Playbook a su espacio de trabajo.

La integración con Slack permite que Living Security envíe notificaciones directamente a su espacio de trabajo de Slack. Notifique a los usuarios sobre las asignaciones de capacitación, alerte a los equipos de seguridad sobre eventos de riesgo y mantenga informados a los gerentes sobre el progreso de sus equipos.

<Note>
  Para configurar el envío de recordatorios y de Playbook, comience en **Configuración → Comunicaciones → Canales** y haga clic en la tarjeta **Slack**. Esta página describe la configuración subyacente de la aplicación de Slack.
</Note>

## Requisitos previos

Antes de configurar la integración con Slack, asegúrese de contar con lo siguiente:

* Permisos de administrador del espacio de trabajo de Slack o de instalación de aplicaciones
* Acceso al portal de la API de Slack en [api.slack.com](https://api.slack.com)
* Privilegios de administrador en Living Security

## Creación de una aplicación de Slack

<Steps>
  <Step title="Cree una nueva aplicación de Slack">
    1. Vaya a [api.slack.com/apps](https://api.slack.com/apps)
    2. Haga clic en **Create New App**
    3. Seleccione **From scratch**
    4. Introduzca un nombre para la aplicación (por ejemplo, "Living Security")
    5. Seleccione su espacio de trabajo
    6. Haga clic en **Create App**

    <Check>
      Su aplicación aparece en el panel de control de la API de Slack.
    </Check>
  </Step>

  <Step title="Configure los ámbitos de OAuth">
    1. En la barra lateral izquierda, haga clic en **OAuth & Permissions**
    2. Desplácese hasta **Bot Token Scopes**
    3. Agregue los siguientes ámbitos:

    | Ámbito | Finalidad |
    | - | - |
    | `chat:write` | Enviar mensajes a los canales |
    | `chat:write.public` | Enviar mensajes a los canales sin unirse a ellos |
    | `users:read` | Consultar información de los usuarios |
    | `users:read.email` | Identificar usuarios por su dirección de correo electrónico |

    <Tip>
      Agregue únicamente los ámbitos que su organización necesite. Menos ámbitos implican mayor seguridad.
    </Tip>
  </Step>

  <Step title="Instale la aplicación en su espacio de trabajo">
    1. Desplácese hasta la parte superior de **OAuth & Permissions**
    2. Haga clic en **Install to Workspace**
    3. Revise los permisos y haga clic en **Allow**

    <Check>
      Aparece un **Bot User OAuth Token** que comienza con `xoxb-`.
    </Check>
  </Step>

  <Step title="Obtenga su secreto de firma">
    1. En la barra lateral izquierda, haga clic en **Información básica**
    2. Desplácese hasta **App Credentials**
    3. Copie el **Signing Secret**

    <Warning>
      Mantenga su secreto de firma en privado. Nunca lo comparta en repositorios públicos ni en registros.
    </Warning>
  </Step>
</Steps>

## Incorporación de credenciales en Living Security

<Steps>
  <Step title="Acceda a las integraciones salientes">
    Vaya a **Configuración → Integraciones → Saliente** y haga clic en la tarjeta **Slack**.
  </Step>

  <Step title="Agregue sus credenciales">
    Haga clic en **Add Credential** e introduzca lo siguiente:

    <ParamField body="botToken" type="string" required>
      Su Bot User OAuth Token, que comienza con `xoxb-`. Se encuentra en **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      El Signing Secret de su aplicación. Se encuentra en **Información básica → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Opcional. Necesario únicamente para las conexiones de Socket Mode. Comienza con `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Opcional. Un nombre descriptivo para esta credencial (por ejemplo, "Production Slack").
    </ParamField>
  </Step>

  <Step title="Guarde y verifique">
    Haga clic en **Guardar**. La credencial aparece en su lista con el estado **activo**.

    <Check>
      Su integración con Slack ya está conectada y lista para enviar notificaciones.
    </Check>
  </Step>
</Steps>

## Tipos de notificaciones

Una vez conectada, Living Security puede enviar a Slack los siguientes tipos de notificaciones:

| Notificación | Descripción |
| - | - |
| Asignaciones de capacitación | Avisan a los usuarios cuando se les asigna una nueva capacitación |
| Recordatorios de capacitación | Recuerdan a los usuarios los próximos plazos |
| Confirmaciones de finalización | Confirman cuándo se ha completado una capacitación |
| Alertas de seguridad | Notifican a los equipos de seguridad sobre eventos de riesgo |
| Resúmenes de Playbook | Envían actualizaciones periódicas sobre el rendimiento del Playbook |

## Solución de problemas

<AccordionGroup>
  <Accordion title="Los mensajes no aparecen en los canales">
    * Verifique que el bot haya sido invitado al canal (`/invite @YourBotName`)
    * Compruebe que el ámbito `chat:write.public` esté agregado para publicar en canales públicos sin unirse a ellos
    * Confirme que el ID del canal sea correcto (utilice el ID del canal, no su nombre)
  </Accordion>

  <Accordion title="Error de token no válido">
    * Asegúrese de haber copiado el token completo, que comienza con `xoxb-`
    * Verifique que la aplicación siga instalada en su espacio de trabajo
    * Compruebe si el token fue regenerado (en ese caso, es necesario actualizarlo en Living Security)
  </Accordion>

  <Accordion title="Límite de solicitudes">
    Slack limita las solicitudes a la API. Si aparecen errores por límite de solicitudes:

    * Reduzca la frecuencia de las notificaciones
    * Consolide varias notificaciones en mensajes de resumen
    * Comuníquese con el servicio de soporte si tiene casos de uso de gran volumen
  </Accordion>
</AccordionGroup>

## Mejores prácticas

<Tip>
  Cree un canal de Slack exclusivo para las notificaciones de Living Security (por ejemplo, `#security-training`) para mantener organizadas las alertas y reducir el ruido en los canales generales.
</Tip>

* Utilice etiquetas de credenciales descriptivas cuando administre varios espacios de trabajo
* Audite periódicamente qué canales reciben notificaciones
* Configure resúmenes de notificaciones en lugar de mensajes individuales para las alertas de gran volumen
* Revise trimestralmente los permisos de la aplicación de Slack y elimine los ámbitos que no se utilicen

## Temas relacionados

<CardGroup cols={2}>
  <Card title="Integración con correo electrónico" icon="envelope" href="/es/integrations/outbound/email">
    Configure el correo electrónico como canal de entrega.
  </Card>

  <Card title="Integración con Teams" icon="microsoft" href="/es/integrations/outbound/teams">
    Configure Microsoft Teams como canal de entrega.
  </Card>

  <Card title="Registro de comunicaciones" icon="clock-rotate-left" href="/es/features/communications/log">
    Realice el seguimiento del estado y el historial de entrega de Slack.
  </Card>

  <Card title="Cómo configurar una nueva integración" icon="plug" href="/es/integrations/managing/setup">
    Guía general de configuración de integraciones.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.