Saltar al contenido principal
SVDY Logo
Guía de desarrollador
Disponible ahora

Recibe las alertas de tu equipo en Slack

Las llegadas tarde, las solicitudes de permiso y las aprobaciones aparecen directamente en tu canal de Slack. Tu equipo deja de revisar tres apps cada mañana. Un canal, una única fuente de verdad.

Lo que tu equipo te agradecerá

Los responsables de RR. HH. dejan de revisar tres apps cada mañana. Los retrasos en el fichaje aparecen al instante — no en el resumen del día siguiente. Las solicitudes de ausencia se publican en tu canal del equipo, donde todos ven la lista pendiente. Las aprobaciones de procesos se enrutan al canal correcto de forma automática. Configuración única; funciona para siempre.

Sin ticket de IT

El admin del canal pulsa Connect, elige el canal y listo. Sin aprobación del admin del tenant ni un ciclo de compras de 30 días.

Mensajes limpios

Cada alerta es un mensaje de Slack con formato y un enlace directo a la solicitud — tu equipo actúa con un solo clic.

Silencia lo que no quieras

¿No te interesan las asignaciones de turno? Desactívalas sin perder los avisos de fichaje tardío. Control por alerta en el plan Pro.

Secretos bien guardados

Los tokens de Slack se cifran en reposo. Ni el equipo de soporte de SVDY puede leerlos tras la instalación.

Instala en 30 segundos

1

Abre /admin/integrations en tu tenant de QuTime / PureOA.

2

Haz clic en la tarjeta de Slack → Connect.

3

Slack abre su página de autorización; elige el canal donde quieres recibir las notificaciones.

4

Slack vuelve a svdy; verás un chip verde "Connected" y la lista de toggles por evento.

5

(Opcional) Pulsa Send test para verificar la integración con un mensaje real.

Plan requerido: Starter o superior. Las organizaciones del plan gratuito reciben un 402 con el código license_required al pulsar Connect.


Alertas que puedes activar

7 tipos de alerta — fichajes tardíos, solicitudes de ausencia, aprobaciones de procesos. Cada mensaje de Slack incluye un resumen en una línea y un botón "Open request" para que un manager pueda actuar con un clic. Los 7 son configurables, así tu canal no se convierte en un canal ruidoso.

Fichaje tardío

Origen: attendance

clock_in_late
Activo por defecto

Pro: silenciar

🌴

Solicitud de ausencia enviada

Origen: leaves

leave_request_submitted
Activo por defecto

Pro: silenciar

Ausencia aprobada

Origen: leaves

leave_request_approved
Activo por defecto

Pro: silenciar

Ausencia rechazada

Origen: leaves

leave_request_rejected
Activo por defecto

Pro: silenciar

📋

Solicitud de proceso enviada

Origen: process

process_request_submitted
Activo por defecto

Pro: silenciar

🔄

Cambio de estado del proceso

Origen: process

process_request_status_changed
Activo por defecto

Pro: silenciar

📅

Turno asignado

Origen: attendance

shift_assigned
Inactivo por defecto

Pro: silenciar

Professional+

Silenciar por evento

En los planes Professional y Enterprise, el cuadro de diálogo de conexión muestra toggles para cada uno de los 7 eventos. Silencia los más ruidosos (por ejemplo shift_assigned en plantillas con muchos cambios) sin desconectar la integración. Los planes inferiores reciben los siete eventos por defecto — sin ganchos visuales para funciones que no están activas.

PATCH /v1/integrations/connections/slack/event-subscriptions

{
  "event_subscriptions": {
    "clock_in_late": false,
    "shift_assigned": true
  }
}

PATCH parcial — las claves omitidas en el cuerpo conservan su valor actual. Las claves de evento desconocidas se descartan en silencio (defensa frente a errores tipográficos del cliente).


Formato de mensaje Block Kit

Cada evento se renderiza como cuatro bloques Block Kit: emoji + título header, cuerpo section en mrkdwn, un botón opcional actions (cuando hay un enlace directo) y un pie context en gris pequeño con la clave del evento y la marca de tiempo.

{
  "text": "⏰ Alice late by 12 min",
  "blocks": [
    { "type": "header",
      "text": { "type": "plain_text", "text": "⏰ Alice late by 12 min", "emoji": true } },
    { "type": "section",
      "text": { "type": "mrkdwn", "text": "Clocked in at 09:12 · scheduled 09:00 · Front Office" } },
    { "type": "actions",
      "elements": [
        { "type": "button", "style": "primary",
          "text": { "type": "plain_text", "text": "Open in svdy" },
          "url": "https://qutime.com/admin/attendance/entries/te_..." }
      ] },
    { "type": "context",
      "elements": [
        { "type": "mrkdwn",
          "text": "`clock_in_late` · 2026-05-24 14:00 UTC" }
      ] }
  ]
}

Resolución de problemas

Si la instalación falla, svdy redirige a /admin/integrations?integration_error=<código>. Códigos habituales:

license_required

El plan de la organización está por debajo de Starter (Slack) o Professional (Teams / WeCom).

Mejora el plan en /admin/billing o contacta con ventas.

state_expired_or_invalid

El token de estado de OAuth caducó (TTL de 5 min) o fue manipulado.

Pulsa Connect Slack de nuevo desde /admin/integrations.

provider_mismatch

El estado de OAuth se emitió para un proveedor diferente al indicado en la URL.

Casi seguro un atacante — rechaza y reinstala desde cero.

code_exchange_failed

Slack rechazó el código de autorización.

Desconecta y vuelve a conectar. Si persiste, contacta con support@svdy.com.

provider_error:access_denied

El admin pulsó "Cancelar" en la pantalla de autorización de Slack.

Pulsa Connect Slack de nuevo y aprueba.


Otros proveedores de mensajería

Slack usa OAuth porque su API expone un scope incoming-webhook que devuelve una URL ligada al canal. Microsoft y Tencent no exponen un equivalente — ambos usan un modelo de pegar URL: tú creas un connector / bot dentro de la plataforma y pegas su URL en svdy.

Microsoft Teams

Professional+

Usa un Power Automate Workflow con un disparador HTTP — Microsoft retiró los Office 365 Connectors el 2025-12-31. Carga útil Adaptive Card v1.5.

Hosts de webhook aceptados: *.webhook.office.com, *.logic.azure.com, *.azurewebsites.net.

WeCom (企业微信)

Professional+

Crea un robot de grupo en WeCom (群机器人) y copia su URL de webhook. Carga útil Markdown (límite de 4096 bytes).

Host aceptado: qyapi.weixin.qq.com. Tanto un código HTTP no 2xx como un errcode distinto de cero se consideran fallo.

¿Listo para conectar Slack?

Abre la página de integraciones en tu tenant y pulsa Connect — 30 segundos para una instalación funcional. Detalles de precios a un clic si quieres comparar planes antes.