A configuração dos Webhooks Workflow é composta por 2 dois principais componentes: Webhooks Meus fluxos e TriggersMeus gatilhos.
...
Meus Fluxos
O webhook worflow é um tipo de integração na qual o contratante pode receber informações no estilo de callback, assim, depois de configurado o webhookworkflow, ele será disparado quando um evento acontecer dentro do sistema da Privacy Tools. A chamada é feita por uma trigger a partir de um determinado evento. É necessário informar um endpoint, (URL REST do serviço do contratante), o método a ser usado (verbo HTTP), o tipo de autenticação e o corpo da requisição (no formato JSON).
...
Para acessar, Webhooks>>Meus webhooks.
...
Para adicionar um novo, clique em “Adicionar Webhook” :
...
Ao acessar a tela de configurações, é preciso informar os parâmetros (Método, Endpois Endpoint e forma de autenticação):
...
No caso de criar um webhook para "Pedidos de titulares", que é quando um Dsar DSAR é cadastrado, temos disponíveis as seguintes variáveis
...
Selecione o webhooks desejado e em seguida, ‘OK’:
...
Depois de selecionadoApós selecionar , clicar em ‘Salvar’:
...
Feito isso, temos:
...
Eventos de disparo
Os eventos de disparo são um conjunto fixo de eventos já pré-mapeados pela PrivacyTools que podem gerar disparos de triggers cadastrados. Cada vez que acontecer um evento destes abaixo o sistema deve buscar se existem triggers esperando por esse evento e se existe fazer o disparo conforme configurado:
Categoria do evento | Nome do evento | Variáveis que ele gera |
Pedidos de titulares | Titular cria um novo pedido Titular responde pedido Empresa responde pedido Pedido muda de status | ${email} |
Consentimento - Titulares | Novo titular criado Dados de titular atualizado Titular removido | ${email} |
Consentimento - Ações | Novo consentimento aceito Novo consentimento revogado Ou seja qualquer mudança na dp_consent_log | ${identifier} ${email} ${templateHash} ${consentStatus} |
Variáveis globais
As variáveis globais são algumas variáveis que o sistema sempre vai gerar ao disparar uma trigger.
Variável | Valor |
${companyID} | Código da empresa |
${serverName} | Host do servidor de origem (dpo.privacytools, demo.privacytools etc) |
${response} | Resposta da execução anterior caso seja um processo encadeado |
${eventCategory} | Categoria do evento de disparo |
${eventName} | Nome do evento de disparo |