Gestionando webhooks en tu aplicación

Cuando el evento del webhook se realiza, como cuando se crea una cita, se envía una petición POST a la URL del mismo. Tu aplicación recibe datos acerca del evento y puede actuar en consecuencia.

Funcionamiento de un webhook

Un webhook devuelve la misma información que una petición GET realizada a la API. El webhook siempre enviará una petición con el método POST y con la información acerca del objeto creado en el cuerpo.

Por ejemplo, pongamos que se ha creado una cita y existe un webhook al crear una cita. En este caso, el webhook enviará una petición POST como si fuera una respuesta al endpoint de recuperar una cita, solo que Koibox lo envía automáticamente al crear una nueva cita.

Respondiendo al webhook

Una vez recibas el webhook en tu aplicación puedes responder inmediatamente a la petición, puedes dar una respuesta vacía con cualquier código de estado. Esta respuesta no se procesará por parte de Koibox, por lo que no impedirá cualquier acción por parte del usuario en caso de error.