Ir para o conteúdo principal
Certyneo
Integração oficial do Slack

Certyneo × Slack — notificações de assinatura eletrônica diretamente no seu canal Slack

Cada envelope Certyneo assinado, recusado, expirado ou consultado dispara uma mensagem Slack no canal de sua escolha em menos de 5 segundos. Filtrável por tipo de evento, sem Zapier intermediário.

Conta Certyneo + workspace Slack com função Admin obrigatória. Gratuito a partir do plano Starter Certyneo.

Por que conectar Certyneo ao Slack

A integração foi projetada para equipes que gerenciam suas atividades no Slack e desejam ver as assinaturas sem trocar de aba.

  • Alertas em tempo real

    Uma mensagem Slack aparece no seu canal menos de 5 segundos após o evento (assinatura, recusa, expiração). Sem necessidade de atualizar o dashboard Certyneo para acompanhar o progresso.

  • Canal de sua escolha

    Escolha o canal Slack durante a instalação (#sales, #legal, #ops, ou um canal dedicado como #signatures). Modificável a qualquer momento em Configurações → Integrações.

  • Filtragem por evento

    5 eventos suportados (completed, declined, expired, sent, recipient.signed) — marque os que você deseja receber, desmarque os outros. Evita poluição do canal em alta atividade.

  • OAuth 2.0 + tokens criptografados

    Autenticação padrão Slack OAuth 2.0. O token do bot é criptografado com AES-256-GCM no banco de dados. Nenhuma leitura de mensagens do seu workspace — a app apenas escreve no seu canal autorizado.

Quais eventos disparam uma mensagem Slack?

Aqui estão os 5 eventos enviáveis para o Slack e a visualização da mensagem enviada para cada um. Todos são opt-in em Configurações → Integrações.

EventoMensagem Slack enviada
envelope.completed✅ "Documento X assinado por todos os signatários. Baixe o PDF de prova eIDAS" + link direto para o PDF.
envelope.declined❌ "Documento X recusado por <signataire>. Motivo: <raison>" + link para o envelope para seguimento.
envelope.expired⏰ "Documento X expirado sem assinatura completa. Signatários em falta: <liste>" + botão de seguimento.
envelope.sent📤 "Documento X enviado para <signataires>" — útil para o relatório comercial pós-envio.
recipient.signed✍️ "<Signataire> acabou de assinar o documento X (X/N assinaturas recolhidas)" — útil para fluxos de trabalho sequenciais.

As mensagens usam os componentes Slack Block Kit para uma renderização clara (cor, ícone, botão). Sem spam: um evento = uma mensagem, sem duplicatas mesmo em caso de retry webhook.

Instalar a integração em 4 etapas

A instalação leva menos de 2 minutos. Você precisa de uma conta Certyneo ativa e do papel Admin (ou Owner) no seu workspace Slack.

  1. 1

    Aceda a Definições → Integrações

    Inicie sessão no Certyneo, abra Definições, selecione Integrações e clique em « Ligar Slack ».

  2. 2

    Autorizar Certyneo no Slack

    Você é redirecionado para o Slack. Escolha seu workspace, verifique os scopes solicitados (chat:write, channels:read) e autorize.

  3. 3

    Escolher o canal de destino

    Selecione o canal Slack onde as mensagens chegarão (#signatures, #sales, #ops, ou crie um dedicado). Você pode alterá-lo posteriormente.

  4. 4

    Testar com um envelope

    Envie um envelope de teste para seu endereço de email. Assim que for assinado, uma mensagem aparecerá no canal Slack escolhido.

Pronto para conectar?

A instalação é feita a partir de Configurações → Integrações no seu dashboard Certyneo. O botão abaixo inicia diretamente o fluxo OAuth do Slack.

Segurança e conformidade

A integração Slack respeita a mesma política de segurança do resto da Certyneo: criptografia, privilégio mínimo, audit trail completo, conformidade RGPD.

  • Token de bot Slack criptografado com AES-256-GCM no banco de dados PostgreSQL, nunca em texto simples.
  • Escopos OAuth limitados ao estritamente necessário: chat:write (enviar uma mensagem) + channels:read (listar os canais disponíveis). Sem leitura das mensagens do seu workspace.
  • Nenhum dado pessoal do Slack armazenado além do nome do canal selecionado e do ID do workspace. Sem cópia das mensagens enviadas.
  • Cada mensagem Slack enviada é registrada no audit trail da Certyneo com timestamp e resultado (sucesso / erro).

Perguntas frequentes

Em qual plano Certyneo a integração Slack está incluída?

A integração Slack está disponível a partir do plano Starter (gratuito para 5 envelopes/mês) e em todos os planos pagos. Não há custo adicional relacionado ao Slack.

Posso rotear eventos diferentes para canais diferentes?

Não por padrão: um workspace Slack conectado aponta para UM canal. Para roteamentos mais refinados (por exemplo #legal para declined, #sales para completed), você pode criar vários workflows Slack no lado do Slack que distribuem a partir do canal Certyneo único para os canais de destino.

Quais escopos OAuth são solicitados?

Dois escopos: chat:write (enviar uma mensagem no canal autorizado) e channels:read (listar os canais públicos para oferecer o seletor). Sem acesso às mensagens, DMs ou conversas privadas.

Como desinstalar?

Duas opções: (1) no lado Certyneo, Configurações → Integrações → botão Desconectar — remove o token criptografado e interrompe todo envio; (2) no lado Slack, Settings → Manage Apps → Certyneo → Uninstall. Ambos os métodos são equivalentes e reversíveis.

Posso desativar certos eventos?

Sim. Em Configurações → Integrações → Slack, marque os eventos desejados (envelope.completed, declined, expired, sent, recipient.signed). As alterações entram em vigor imediatamente.

Há risco de rate-limit do Slack em alta atividade?

Não. O Slack permite 1 mensagem/segundo por bot em um canal específico (limite app-level). Para absorver picos de envio em lote, a Certyneo limita os envios no lado do servidor — um grande lote de envelopes assinados simultaneamente é distribuído ao longo de alguns segundos em vez de saturar o canal.

Para saber mais

Conecte Certyneo ao Slack em 30 segundos

OAuth padrão. Nenhum cartão de crédito. Desativável a qualquer momento a partir de Configurações ou Slack.