# Webhooks

La plataforma también permite el uso de Webhooks para ciertos eventos específicos dentro de tu cuenta. Para ello, se deben habilitar y configurar desde la sección webhooks en la configuración de la cuenta.

Un webhook es una acción POST automática a una URL determinada con información determinada.

Para habilitarlos, debes checkear la parte superior de la página y después proceder a crear todos los webhooks que quieras.

Los webhooks se pueden crear a partir de acciones de sitios o espacios.

Al crear un webhook, debes tener la URL a la que quieres enviar la información, seleccionar el tipo de log y sitio (en caso de ser necesario) que gatillará el webhook y luego guardar los cambios.

Luego de esto, podrás ver en la lista todos los webhooks que estén activos.

# Crear un webhook administrativo

Llama a tus canales de gestión a través de un webhook.

Para crear un webhook, sigue estos pasos:

Desde la página de administración, haz click en Configuración, luego selecciona Webhooks.
Haz click en + Nuevo Webhook.
Escribe el nombre y la URL a la cual quieres llamar.
Selecciona los sitios o espacios que quieras que activen el webhook.
Selecciona el tipo de log que activará el webhook.
Agrega los headers necesarios para la llamada.
Haz click en Guardar.

Los webhooks de sitio son:

Página creada
Página eliminada
Página publicada
Página despublicada
Página actualizada
Inicio de sesión
Cierre de sesión
Navegación aprobada
Navegación publicada
Navegación enviada a revisión
Navegación actualizada
Perfil actualizado
Sitio creado
Sitio eliminado
Sitio desactivado
Sitio habilitado
Sitio oculto
Sitio puesto en desarrollo
Sitio visible
Sitio actualizado
Templates aprobados
Templates enviados para su revisión
Templates actualizados
Tema instalado
Tema restablecido
Tema actualizado
Widget aprobado
Widget clonado
Widget creado
Widget publicado
Widget restaurado
Widget enviado a revisión
Widget despublicado
Widget actualizado

Los webhooks de espacios son:

Categoría creada
Categoría eliminada
Categoría actualizada
Entrada aprobada
Entrada creada
Entrada publicada
Entrada enviada a revisión
Entrada despublicada
Entrada actualizada
Espacio creado
Espacio actualizado
Tipo creado
Tipo eliminado
Tipo actualizado

# Ejemplo de Payload

{
   "id":1552,
   "account_id":2,
   "site_id":null,
   "user_id":2,
   "type":null,
   "value_1":"6111a767-71dc-485c-bea3-80229edf7450",
   "value_2":"the-new-type",
   "value_3":"space-test",
   "request_ip":"127.0.0.1",
   "request_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36",
   "loggeable_id":5,
   "loggeable_type":"Content::Entry",
   "options":{
      "title":"test entries (6111a767-71dc-485c-bea3-80229edf7450)}"
   },
   "created_at":"2021-08-13T17:08:46.000Z",
   "user_type":"AdminUser",
   "space_id":1,
   "log_type_id":262,
   "realm_id":null,
   "trigger_uid":"entry_created_log",
   "trigger_name":"Entry created log",
   "trigger_entity":"Content::Entry",
   "trigger_entity_id":5,
   "trigger_entry_uuid":"6111a767-71dc-485c-bea3-80229edf7450",
   "trigger_content_uuid":"the-new-type",
   "trigger_entry_space_uid":"space-test"
}

# Crear un webhook de reino

Llama a tus canales de gestión a través de un webhook.

Para crear un webhook, sigue estos pasos:

Desde un reino, haz click en Configuración del reino, luego selecciona Webhooks.
Haz click en + Nuevo Webhook.
Escribe el nombre y la URL a la cual quieres llamar.
Selecciona el tipo de log que activará el webhook.
Agrega los headers necesarios para la llamada.
Haz click en Guardar.

Los webhooks de reino con sus payloads respectivos:

Respuesta de formulario creada
Respuesta de formulario actualizada
Respuesta de originación creada

{
   "ip":"172.71.194.146",
   "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
   "e_a":"created_log",
   "e_c":"origination_submission",
   "uid":2300345,
   "idsite":4521,
   "realm_id":681,
   "realm_uid":"jordana",
   "account_id":381,
   "origination_uid":"ori",
   "submission_uuid":"4c23599f-2aa6-4a8c-b2ae-66be46b7b938"
}

Respuesta de originación iniciada

{
   "ip":"172.71.194.146",
   "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
   "e_a":"started_log",
   "e_c":"origination_submission",
   "uid":2300345,
   "idsite":4521,
   "realm_id":681,
   "realm_uid":"jordana",
   "account_id":381,
   "origination_uid":"ori",
   "submission_uuid":"4c23599f-2aa6-4a8c-b2ae-66be46b7b938"
}

Tarea de respuesta de originación enviada

{
   "ip":"172.71.195.36",
   "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
   "e_a":"task_submitted_log",
   "e_c":"origination_submission",
   "uid":2300345,
   "idsite":4521,
   "task_id":157,
   "realm_id":681,
   "realm_uid":"jordana",
   "account_id":381,
   "origination_uid":"ori",
   "submission_uuid":"4c23599f-2aa6-4a8c-b2ae-66be46b7b938"
}

Respuesta de originación completada

{
   "id":35914440,
   "account_id":381,
   "site_id":null,
   "user_id":1177351,
   "value_1":null,
   "value_2":null,
   "value_3":null,
   "request_ip":"172.71.195.87",
   "request_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
   "loggeable_id":419,
   "loggeable_type":"Origination::Submission",
   "options":{"title":null},
   "created_at":"2025-06-16T10:50:22.000-04:00",
   "space_id":null,
   "log_type_id":415405,
   "realm_id":681,
   "trigger_uid":"origination_submission_completed_log",
   "trigger_name":"Origination submission completed log",
   "trigger_entity":"Origination::Submission",
   "trigger_entity_id":419,
   "trigger_entry_uuid":null,
   "trigger_content_uuid":null,
   "trigger_entry_space_uid":null
}

Respuesta de originación cancelada

{
   "ip":"172.71.195.41",
   "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
   "e_a":"canceled_log",
   "e_c":"origination_submission",
   "uid":2300345,
   "idsite":4521,
   "realm_id":681,
   "realm_uid":"jordana",
   "account_id":381,
   "origination_uid":"ori",
   "submission_uuid":"04bf572a-9e00-4474-ae8a-6a0bc17d4c1a"
}

Inicio de sesión
Iniciar sesión con código
Cerrar sesión
Error al intentar iniciar sesión
Error al intentar iniciar sesión con código
Usuario creado
Usuario actualizado
Usuario habilitado
Registro de usuario
Restaurar contraseña
Usuario borrado

Nota: El webhook es llamado a través de un POST cuando se genera un log del tipo seleccionado. Una vez creado el webhook, podrás enviar una notificación de prueba con información falsa para probar que tu URL está recibiendo correctamente los POSTs desde Modyo.

← Gestión de sesión privada usando OpenID Connect (OIDC) API de administración →