Para que serve

Integrações levam avisos para onde a equipe já trabalha e conectam o Canal de Denúncias a outros sistemas da empresa. Cada uma tem um escopo fechado: você decide o que ela recebe ou pode fazer, e tudo fica registrado.

Mapa das integrações

  • E-mails externos: endereços de fora da equipe que recebem avisos das automações depois de confirmar o recebimento.
  • Microsoft Teams: um canal do Teams, cadastrado pelo endereço de webhook criado no próprio canal.
  • Slack: canais de um espaço do Slack, quando o Slack está disponível na sua instalação.
  • Dados dos avisos: a regra da organização sobre metadados em avisos externos.
  • Webhooks: avisam outro sistema com um JSON assinado.
  • Chaves de API: deixam um sistema chamar a API com as permissões escolhidas.
  • MCP e Conectar sua IA: deixam um assistente de IA agir em nome de uma pessoa, com as ações que ela autorizar.

Passo a passo: destinos dos avisos

1

Abra Canal e ouvidoria › Integrações. A coluna do meio lista as integrações com um resumo de cada uma, como "Nenhum cadastrado · 0 de 0 confirmados".

Tela Canal e ouvidoria › Integrações, Destinos e dados dos avisos, com o link Ver automações. Na coluna do meio, Integrações · 5: E-mails externos (Nenhum cadastrado · 0 de 0 confirmados), Slack (Indisponível), Microsoft Teams, Dados dos avisos (Só aviso e link · Regra da organização) e Webhooks. À direita, E-mails externos com o contador 0 de 30, o alerta de que o destino fica fora do controle de acesso do canal e o botão Adicionar e-mail.
A coluna do meio resume cada integração. O link Ver automações leva às automações que usam esses destinos. Dados fictícios da organização de demonstração. Ampliar imagem
2

Em E-mails externos, clique em Adicionar e-mail. O endereço recebe um link e só passa a receber avisos depois de confirmar.

3

Em Microsoft Teams, clique em Cadastrar canal. Dê um nome e cole o endereço do webhook criado no canal do Teams. Uma mensagem de teste confirma o destino antes do cadastro. Esse endereço funciona como uma senha: ele fica cifrado e não volta a ser exibido.

4

Em Slack, siga Autorize o espaço, Escolha os canais e Use nas automações. Se aparecer Slack indisponível nesta instalação, use outro destino.

5

Em Dados dos avisos, decida se avisos externos podem levar metadados do caso. O padrão é "Só aviso e link". Ligar Permitir metadados pede confirmação e vale na hora.

Passo a passo: chave de API

6

Abra Integração › Chaves de API e clique em Nova chave.

7

Preencha Nome, por exemplo "ERP de produção". Se quiser, use Clonar de um papel e depois desmarque em Permissões o que o sistema não precisa. Sem nenhuma permissão, a chave não chama a API.

Formulário Integração › Chaves de API › Nova, com o título Nova chave de integração, o campo obrigatório Nome (exemplo ERP de produção), a lista Clonar de um papel com Não clonar e a lista de Permissões com caixas de seleção, como Ver membros, Ver organização, Ver arquivos e Ver webhooks. No topo, Cancelar e Emitir chave.
Marque só as permissões de que o sistema precisa. A chave guarda uma cópia delas no momento da criação. Dados fictícios da organização de demonstração. Ampliar imagem
8

Clique em Emitir chave e guarde o segredo, que começa com mcd_. Ele aparece uma única vez. Depois, a ficha mostra só o código, o Prefixo e o Último uso.

Passo a passo: webhook

9

Abra Integração › Webhooks e clique em Novo webhook. Informe Nome, URL e Eventos. Em produção, a URL precisa ser HTTPS, e redirecionamentos não são seguidos.

10

Clique em Criar webhook e guarde o segredo, que começa com whsec_. Ele aparece uma única vez e serve para conferir a assinatura de cada entrega.

11

Na ficha do webhook, use Enviar teste e confira o resultado em Entregas.

12

Para que um caso chame o webhook, adicione o passo Chamar webhook numa automação.

Passo a passo: assistente de IA (MCP)

13

Em Organização › MCP, ligue Permitir conexões MCP e clique em Salvar alterações. Cada pessoa também precisa ligar o MCP na própria conta e seguir Conectar sua IA.

Tela Organização › MCP com o Servidor da organização no estado Disponível, a opção Permitir conexões MCP ligada, o Nome do servidor e Instruções para o cliente. À direita, o painel Como a conexão funciona, com Antes de autorizar um cliente (MCP da organização disponível e MCP na sua conta desativado) e Como a delegação funciona.
A organização e a pessoa precisam permitir o MCP. Depois, cada cliente de IA passa por autorização e age como a pessoa que autorizou. Dados fictícios da organização de demonstração. Ampliar imagem

Escopos e proteção

  • Avisos externos levam uma frase fixa e o link. Metadados só com a regra da organização e o pedido do passo da automação.
  • O webhook chamado por uma automação recebe referências do caso (código, canal, empresa, tipo, etapa, prioridade, prazo), nunca o conteúdo do relato.
  • Um webhook não recebe casos protegidos, a menos que você ligue Receber aviso de casos protegidos. Mesmo assim, ele recebe só a marca de caso protegido.
  • A chave de API só chama o que foi marcado. É uma cópia do momento da criação: mudar um papel depois não altera a chave.
  • No MCP, o cliente age como a pessoa que autorizou, nunca como a organização. Casos protegidos continuam invisíveis sem acesso nominal.

Boas práticas

  • Crie uma integração por sistema, com um nome claro.
  • Conceda o mínimo de permissões e revise as chaves sem uso pelo Último uso.
  • Use Trocar segredo periodicamente. Por 24 horas, cada entrega leva a assinatura do segredo novo e a do anterior, para o sistema receptor trocar sem perder entregas.
  • Revogue na hora uma chave ou um webhook que não for mais usado.

Limites e cuidados

  • Destinos externos ficam fora do controle de acesso do canal. Qualquer pessoa com acesso a eles verá o aviso, inclusive alguém citado num relato.
  • Depois de revogada, qualquer chamada com o segredo da chave é recusada. A chave não expira sozinha.
  • Desligar o MCP da organização não altera as permissões dos membros nem revoga outras integrações.
  • A organização tem limites de destinos, como o de e-mails externos mostrado na tela.

Perguntas frequentes

Uma chave de API consegue ler casos protegidos ou a identidade de quem relatou?

Não por estar ligada à organização. O acesso a casos protegidos é dado caso a caso, a pessoas, e a consulta de identidade é sempre feita por uma pessoa.

Posso ver o segredo de novo?

Não. Se perdeu o segredo de um webhook, use Trocar segredo. Se perdeu o de uma chave, emita uma nova e revogue a antiga.

Precisa de ajuda?

Pesquise o tema na Central de Ajuda ou pergunte ao assistente, que responde com base nos guias públicos. Se a dúvida continuar, entre com sua conta do Canal de Denúncias e abra um chamado em Meus chamados. Descreva a tela, o passo e a mensagem exibida.