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 API de 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.

Se requiere el plan Growth o Pro del foro para usar esta función.

Configuración de los ajustes de los webhooks

1. Inicie sesión en su cuenta de Website Toolbox.
2. Haga clic en el Integrar enlace.
3. Haga clic en el Webhook enlace.
4. Haga clic en el Añadir Webhook botón.
5. Introduce la URL de tu webhook y selecciona los eventos que quieres recibir.
6. Haga clic 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

Vea nuestro código de muestra para recibir un evento de webhook.

Para confirmar la recepción de un webhook, el punto final 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",
 «datos»: {
 «objeto»: {
 «signature»: «Gracias, John. «,
 «nombre»: «John Doe»,
 «AllowEmails»: falso,
 «Marca de tiempo de la última publicación»: 0,
 «Grupos de usuarios»: [7440, 2452, 52423],
 «UserTitle»: «Usuario avanzado»,
 «reputación»: 423,
 «nombre de usuario»: «john»,
 «Número de publicaciones»: 32,
 «ID de usuario»: 181855,
 «Marca de tiempo de la última visita»: 1322811119,
 «Tipo de mensajería instantánea»: «»,
 «ID de mensajería instantánea»: «»,
 «objeto»: «Usuario»,
 «invisible»: falso,
 «correo electrónico»: "johnDoe@gmail.com «,
 «URL del avatar»: "https://test.com/images/avatar.png «,
 «JoinDateTimeStamp»: 1322811119,
 «enableMessages»: verdadero
 }
 },
 «objeto»: «evento»,
 «identificación»: 1534,
 «tipo»: «creado por el usuario»,
 «modo»: «en vivo»
}

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 tu webhook siguiendo las instrucciones que aparecen a continuación:

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

Cada entrada de la lista muestra qué era el evento y cuándo se envió. Haz clic en un evento para ver la carga útil que se envió y la respuesta que se recibió de tu webhook.

Los eventos de webhook y sus respuestas se guardan durante 30 días.