Pular para o conteúdo principal
SVDY Logo
Guia para desenvolvedores
Disponível agora

Receba os alertas da sua equipe no Slack

Atrasos no ponto, solicitações de folga e aprovações aparecem no seu canal do Slack. Sua equipe deixa de checar três apps toda manhã. Um canal, uma única fonte de verdade.

O motivo pelo qual seu time vai te agradecer

Os gerentes de RH deixam de checar três apps toda manhã. Atrasos no ponto aparecem na hora — não no resumo do dia seguinte. Os pedidos de ausência são postados no canal do time, onde todo mundo vê a fila. As aprovações de processo são roteadas automaticamente para o canal correto. Configuração única; roda para sempre.

Sem chamado de TI

O admin do canal clica em Connect, escolhe o canal e pronto. Sem aprovação do admin do tenant, sem ciclo de compras de 30 dias.

Mensagens limpas

Cada alerta é uma mensagem do Slack formatada com link direto para o pedido — seu time clica uma vez para resolver.

Silencie o que quiser

Não se importa com atribuição de turnos? Desligue sem perder os alertas de atraso no ponto. Controle por alerta no plano Pro.

Segredos bem guardados

Os tokens do Slack são criptografados em repouso. Nem o suporte da SVDY consegue lê-los após a instalação.

Instale em 30 segundos

1

Abra /admin/integrations no seu tenant do QuTime / PureOA.

2

Clique no card Slack → Connect.

3

O Slack abre a página de autorização; escolha o canal onde quer receber as notificações.

4

O Slack volta para a svdy; você verá um chip verde "Connected" e a lista de toggles por evento.

5

(Opcional) Clique em Send test para verificar a integração com uma mensagem real.

Plano necessário: Starter ou superior. Organizações no plano grátis recebem 402 com o código license_required ao clicar em Connect.


Alertas que você pode ativar

7 tipos de alerta — atrasos no ponto, pedidos de ausência, aprovações de processo. Cada mensagem do Slack tem um resumo em uma linha e um botão "Open request" para o gestor agir com um clique. Todos os 7 podem ser ligados/desligados, então seu canal não vira uma máquina de barulho.

Atraso no ponto

Origem: attendance

clock_in_late
Ligado por padrão

Pro: silenciar

🌴

Pedido de ausência enviado

Origem: leaves

leave_request_submitted
Ligado por padrão

Pro: silenciar

Ausência aprovada

Origem: leaves

leave_request_approved
Ligado por padrão

Pro: silenciar

Ausência recusada

Origem: leaves

leave_request_rejected
Ligado por padrão

Pro: silenciar

📋

Solicitação de processo enviada

Origem: process

process_request_submitted
Ligado por padrão

Pro: silenciar

🔄

Status do processo alterado

Origem: process

process_request_status_changed
Ligado por padrão

Pro: silenciar

📅

Turno atribuído

Origem: attendance

shift_assigned
Desligado por padrão

Pro: silenciar

Professional+

Silenciar por evento

Nos planos Professional e Enterprise, o diálogo de conexão exibe toggles para cada um dos 7 eventos. Silencie os mais barulhentos (por exemplo shift_assigned em escalas com muita rotatividade) sem desconectar a integração. Planos inferiores recebem os sete eventos por padrão — sem teasers de UI para funcionalidades que não estão ativas.

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

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

PATCH parcial — chaves omitidas no corpo mantêm o valor atual. Chaves de evento desconhecidas são descartadas silenciosamente (defesa contra erros de digitação do cliente).


Formato de mensagem Block Kit

Cada evento é renderizado como quatro blocos Block Kit: emoji + título header, corpo section em mrkdwn, um botão opcional actions (quando há link direto) e um rodapé context cinza com a chave do evento e o timestamp.

{
  "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" }
      ] }
  ]
}

Resolução de problemas

Quando a instalação falha, a svdy redireciona para /admin/integrations?integration_error=<código>. Códigos comuns:

license_required

O plano da organização está abaixo de Starter (Slack) ou Professional (Teams / WeCom).

Faça upgrade em /admin/billing ou fale com o time de vendas.

state_expired_or_invalid

O token de estado do OAuth expirou (TTL de 5 min) ou foi forjado.

Clique em Connect Slack novamente em /admin/integrations.

provider_mismatch

O estado do OAuth foi emitido para um provedor diferente do indicado na URL.

Quase certamente um ataque — recuse e reinstale do zero.

code_exchange_failed

O Slack rejeitou o código de autorização.

Desconecte e conecte novamente. Se persistir, fale com support@svdy.com.

provider_error:access_denied

O admin clicou em "Cancelar" na tela de autorização do Slack.

Clique em Connect Slack novamente e aprove.


Outros provedores de mensageria

O Slack usa OAuth porque a API dele expõe um scope incoming-webhook que retorna uma URL vinculada a um canal. Microsoft e Tencent não expõem equivalente — ambos usam um modelo de colar URL: você cria um connector / bot dentro da plataforma e cola a URL na svdy.

Microsoft Teams

Professional+

Use um Power Automate Workflow com gatilho HTTP — a Microsoft descontinuou os Office 365 Connectors em 2025-12-31. Payload Adaptive Card v1.5.

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

WeCom (企业微信)

Professional+

Crie um robô de grupo no WeCom (群机器人) e copie a URL do webhook. Payload em Markdown (limite de 4096 bytes).

Host aceito: qyapi.weixin.qq.com. Tanto um status HTTP não 2xx quanto um errcode diferente de zero são tratados como falha.

Pronto para conectar o Slack?

Abra a página de integrações no seu tenant e clique em Connect — 30 segundos até estar instalado. Detalhes de preço a um clique se quiser comparar planos antes.