En la subpestaña Webhooks de la configuración de PhishER, puede crear webhooks para conectar su plataforma de PhishER con otras plataformas que utilice. Un webhook, también conocido como API de inserción de HTTP, es una forma de que una aplicación proporcione información en tiempo real a otra aplicación. Cuando se activan los mensajes por acciones específicas de PhishER, los webhooks le permiten enviar los datos del mensaje a otra aplicación.

Después de integrar los webhooks con la plataforma de PhishER, puede crear una acción de PhishER y seleccionar la opción Send to Webhook (Enviar a webhook). Esta opción permite a PhishER enviar mensajes denunciados que se vean afectados por dicha acción al webhook de su organización. Una vez activada la acción, puede hacer clic en un mensaje relacionado de su Inbox (Bandeja de entrada) de PhishER y consultar a qué webhook se ha enviado el mensaje.

Creación de un nuevo webhook

Para conectar un nuevo webhook a la plataforma PhishER, siga estos pasos:

1. Inicie sesión en la plataforma PhishER.
2. Diríjase a Settings (Configuración) > Webhook.
3. Haga clic en el botón New Webhook (Nuevo webhook) en la esquina superior derecha de la página para abrir la ventana emergente Add Webhook Settings (Añadir configuración de webhook).
4. En la ventana emergente Add Webhook Settings (Añadir configuración de webhook) que se abre, configure los ajustes de su webhook. Para obtener más información sobre estos ajustes, consulte la captura de pantalla y la lista que se muestran a continuación:
   1. Name (Nombre): en este campo, introduzca un nombre personalizado para su webhook.
   2. URL: en este campo, introduzca la URL a la que está intentando devolver la llamada. Para obtener una lista de rescritores y acortadores compatibles con PhishER, consulte el artículo Preguntas frecuentes de PhishER.
   3. Authorization (Autorización): en el menú desplegable, seleccione uno de los siguientes protocolos: No Auth (Sin autorización), API Key (Clave de API), Bearer Token (Token del portador) o Basic Auth (Autorización básica).
   4. Available Data (Datos disponibles): seleccione uno o más tipos de datos que quiere enviar al webhook.
      Nota: El tipo de dato Addresses (Direcciones) envía todas las direcciones de correo electrónico de la carga del webhook, incluidas las direcciones de correo electrónico de los campos From (De), To (Para), CC, Reply To (Responder a) y Reported By (Denunciante).
   5. Custom Data (Datos personalizados): para añadir datos personalizados a la carga de su webhook, haga clic en el icono del signo más. Luego, rellene los campos key (clave) y value (valor). Por ejemplo, si su aplicación necesita «{ "System" : "PhishER" }» en la carga para recibir datos, puede introducir «System» y «PhishER».
   6. Custom Headers (Encabezados personalizados): si quiere añadir un encabezado personalizado, haga clic en el icono del signo más. Luego, rellene los campos key (clave) y value (valor). Por ejemplo, si su firewall necesita el encabezado «{ "Header" : "PhishER" }» para permitir que los datos pasen, puede introducir «Header» y «PhishER».
   7. Message Tags (Etiquetas del mensaje): en esta sección, puede marcar las casillas Success (Correcto) o Failure (Fallo) si quiere que PhishER asigne una etiqueta cuando se utiliza el webhook para enviar datos. Luego, introduzca el nombre de la etiqueta en el campo situado junto a la casilla seleccionada. 
   
5. Haga clic en Create (Crear).

Gestión de sus webhooks

En la subpestaña Webhook de la configuración de PhishER, puede conectar y gestionar sus webhooks. Para actualizar un webhook, puede hacer clic en el nombre de uno de ellos para abrir la ventana emergente Update Webhook Settings (Actualizar configuración de webhook). Luego, puede actualizar la información del webhook.

Para obtener más información sobre la subpestaña Webhook, consulte la captura de pantalla y la lista que aparecen a continuación:

1. New Webhook (Nuevo webhook): puede hacer clic en este botón para añadir un nuevo webhook. Para obtener más información sobre la adición de un nuevo webhook, consulte la subsección anterior de este artículo.
2. Name (Nombre): esta columna muestra el nombre del webhook.
3. URL: esta columna muestra la URL a la que devolverá la llamada el webhook.
4. Selected Data (Datos seleccionados): esta columna muestra los tipos de datos que quiere enviar al webhook.
5. Success Tag (Etiqueta de éxito): esta columna muestra la etiqueta que PhishER asigna a un mensaje si el webhook envía los datos y recibe una URL de devolución de llamada correctamente.
6. Failure Tag (Etiqueta de fallo): esta columna muestra la etiqueta que PhishER asigna a un mensaje si el webhook no pudo enviar los datos y recibir una URL de devolución de llamada correctamente.
7. Actions (Acciones): esta columna muestra las acciones que se pueden ejecutar en una entrada de webhook. Puede hacer clic en el icono de la papelera para eliminar la entrada.