Na subguia Webhook das Configurações do PhishER, crie webhooks para conectar sua plataforma PhishER a outras plataformas que você usa. Um webhook, também conhecido como API push HTTP, é a forma na qual um aplicativo fornece informações em tempo real a outro aplicativo. Quando as mensagens são disparadas por ações específicas do PhishER, os webhooks permitem que você envie dados dessas mensagens para outro aplicativo.

Depois de integrar os webhooks à plataforma PhishER, você poderá criar uma ação do PhishER e selecionar a opção Enviar para webhook. Essa opção permite que o PhishER envie as mensagens denunciadas afetadas por essa ação ao webhook da sua organização. Depois que a ação for disparada, clique em uma mensagem relacionada na Caixa de entrada do PhishER e veja à qual webhook a mensagem está sendo enviada.

Como criar um novo webhook

Para conectar um novo webhook à sua plataforma PhishER, siga estas etapas:

1. Faça login na plataforma PhishER.
2. Acesse Configurações > Webhook.
3. Clique no botão Novo webhook no canto superior direito da página para abrir a janela pop-up Adicionar configurações do webhook.
4. Na janela pop-up Adicionar configurações do webhook exibida, defina as configurações do webhook. Para saber mais sobre essas configurações, veja a captura de tela e a lista abaixo:
   1. Nome: neste campo, digite um nome personalizado para o seu webhook.
   2. URL: neste campo, digite o URL ao qual você está tentando retornar a chamada. Para obter uma lista de todas as ferramentas de reescrita e encurtamento de URLs compatíveis com o PhishER, veja o artigo Perguntas frequentes do PhishER.
   3. Autorização: no menu suspenso, selecione um dos seguintes protocolos: Sem autorização, Chave da API, Token do portador ou Autenticação básica.
   4. Dados disponíveis: selecione um ou mais tipos de dados que você deseja enviar para o webhook.
      Observação: o tipo de dados Endereços envia todos os endereços de e-mail na carga do webhook, inclusive os endereços de e-mail nos campos De, Para, Cc, Responder para e Denunciado por.
   5. Dados personalizados: para adicionar dados personalizados à carga do seu webhook, clique no ícone de +. Depois, preencha os campos chave e valor. Por exemplo, se o aplicativo exigir "{ "System" : "PhishER" }" na carga para receber os dados, você pode digitar "System" e "PhishER".
   6. Cabeçalhos personalizados: para adicionar um cabeçalho personalizado, clique no ícone de +. Depois, preencha os campos chave e valor. Por exemplo, se o seu firewall exigir o cabeçalho "{ "Header" : "PhishER" }” para permitir que os dados passem, você pode digitar "Header" e "PhishER".
   7. Marcas da mensagem: nesta seção, você pode marcar as caixas de seleção Êxito ou Falha se desejar que o PhishER atribua uma marca quando o webhook for usado para enviar dados. Depois, digite um nome para a marca no campo ao lado da caixa de seleção marcada. 
   
5. Clique em Criar.

Como gerenciar seus webhooks

Na subguia Webhook das Configurações do PhishER, você pode conectar e gerenciar seus webhooks. Para atualizar um webhook, clique no nome de um webhook para abrir a janela pop-up Atualizar configurações do webhook. Depois, atualize as informações do webhook.

Para obter mais informações sobre a subguia Webhook, veja a captura de tela e a lista abaixo:

1. Novo Webhook: clique neste botão para adicionar um novo webhook. Para obter mais informações sobre como adicionar um novo webhook, veja a subseção deste artigo, acima.
2. Nome: esta coluna exibe o nome do webhook.
3. URL: esta coluna exibe o URL ao qual o webhook retornará a chamada.
4. Dados selecionados: esta coluna exibe os tipos de dados que você deseja enviar para o webhook.
5. Marca de êxito: esta coluna exibirá a marca que o PhishER atribui a uma mensagem quando o webhook enviar dados e receber um URL de retorno de chamada com êxito.
6. Marca de falha: esta coluna exibirá a marca que o PhishER atribui a uma mensagem quando o webhook não conseguir enviar dados e receber um URL de retorno de chamada.
7. Ações: esta coluna exibe as ações disponíveis para execução em uma entrada do webhook. Clique no ícone de lixeira para excluir a entrada.