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ê pode criar uma ação do PhishER e selecionar a opção Send to Webhook (Enviar para o 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 Inbox (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 Settings (Configurações) > Webhook.
3. Clique no botão New Webhook (Novo webhook) no canto superior direito da página para abrir a janela pop-up Add Webhook Settings (Adicionar configurações do webhook).
4. Na janela pop-up Add Webhook Settings (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. Name (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. Authorization (Autorização): no menu suspenso, selecione um dos seguintes protocolos: No Auth (Sem autorização), API Key (Chave de API), Bearer Token (Token do portador) ou Basic Auth (Autenticação básica).
   4. Available Data (Dados disponíveis): selecione um ou mais tipos de dados que você deseja enviar para o webhook.
      Observação: o tipo de dados Addresses (Endereços) envia todos os endereços de e-mail na carga do webhook, inclusive os endereços de e-mail nos campos From (De), To (Para), CC (Cc), Reply To (Responder para) e Reported By (Denunciado por).
   5. Custom Data (Dados personalizados): para adicionar dados personalizados à carga do seu webhook, clique no ícone de +. Depois, preencha os campos key (chave) e value (valor). Por exemplo, se o aplicativo exigir "{ "System" : "PhishER" }" na carga para receber os dados, você pode digitar "System" e "PhishER".
   6. Custom Headers (Cabeçalhos personalizados): para adicionar um cabeçalho personalizado, clique no ícone de +. Depois, preencha os campos key (chave) e value (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. Message Tags (Marcas da mensagem): nesta seção, você pode marcar as caixas de seleção Success (Êxito) ou Failure (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. 
   (Criar webhook)
5. Clique em Create (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 Update Webhook Settings (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. New Webhook (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. Name (Nome): esta coluna exibe o nome do webhook.
3. URL: esta coluna exibe o URL ao qual o webhook retornará a chamada.
4. Selected Data (Dados selecionados): esta coluna exibe os tipos de dados que você deseja enviar para o webhook.
5. Success Tag (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. Failure Tag (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. Actions (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.