Usa webhooks para recibir notificaciones sobre los eventos que ocurren en tu foro.

Cuando se produce el evento (por ejemplo, cuando un usuario nuevo crea una cuenta en tu foro), Website Toolbox crea un objeto de evento. Este objeto contiene toda la información relevante sobre lo que acaba de ocurrir, incluido el tipo de evento y los datos asociados a ese evento. A continuación, enviamos el objeto de evento como JSON a la URL de tu webhook mediante una solicitud HTTP POST.

Los webhooks funcionan muy bien cuando se combinan con la API del foro. Por ejemplo, el webhook puede avisar a tu aplicación cuando un nuevo usuario se registre en tu foro y, a continuación, puedes usar la API para realizar modificaciones en la cuenta del foro de ese usuario.

Para utilizar esta función, es necesario contar con el plan Growth o Pro del foro.

Configuración de los ajustes de los webhooks

1. Inicia sesión en tu cuenta de Website Toolbox.
2. Haga clic en el enlace Integrar.
3. Haz clic en el enlace Webhook.
4. Haz clic en el botón Agregar webhook.
5. Introduce la URL de tu webhook y selecciona los eventos que quieres recibir.
6. Haz clic en Guardar.

Puedes crear varios webhooks para enviar eventos a diferentes URL. Cada webhook se puede configurar para recibir diferentes tipos de eventos.

Responder a un webhook

Consulta nuestro código de ejemplo para recibir un evento de webhook.

Para confirmar la recepción de un webhook, tu terminal debe devolver un código de estado HTTP 2xx. Se ignora cualquier otra información que se devuelva en los encabezados o en el cuerpo de la solicitud. Todos los códigos de respuesta que estén fuera de este rango, incluidos los códigos 3xx, indicarán que no has recibido el webhook. Esto significa que una redirección de URL o una respuesta con el mensaje «No modificado» se considerarán un error.

Si un webhook no se recibe correctamente por cualquier motivo, seguiremos intentando enviar el webhook una vez por hora durante un máximo de 3 días.

Un ejemplo de evento

{
«api_version»: «1", 
 «data»: {
«object»: {
«signature»: «Gracias, John». , 
 «name»: «John Doe», 
 «allowEmails»: false, 
 «lastPostTimestamp»: 0, 
 «userGroups»: [7440, 2452, 52423], 
 «userTitle»: «Power User», 
 «reputation»: 423, 
 «username»: «john», 
 «postCount»: 32, 
 «userId»: 181855, 
 «lastVisitTimestamp»: 1322811119, 
 «InstantMessagingType»: «», 
 «InstantMessagingID»: «», 
 «object»: «User», 
 «invisible»: false, 
 «correo electrónico»: "johnDoe@gmail.com «, 
 «AvatarURL»: "https://test.com/images/avatar.png «, 
«joinDateTimeStamp»: 1322811119, 
 «enableMessages»: true 

}}, 
 «object»: «event», 
 «id»: 1534, 
 «type»: «user.created», 
 «mode»: «live»
} 

Visualización de eventos y respuestas de webhooks

Puedes ver los eventos que se enviaron a tu webhook y la respuesta que se recibió de él siguiendo las instrucciones que aparecen a continuación:

1. Inicia sesión en tu cuenta de Website Toolbox.
2. Haga clic en el enlace Integrar.
3. Haz clic en el enlace Webhook.
4. Haz clic en el número de eventos del webhook que deseas ver.