Saltar al contenido principal

¿Cómo trabajar con webhooks?

Kay Endörfer
  • Actualización

1. Diferencia entre API y Webhooks

La principal diferencia entre cómo funcionan los Webhooks y las APIs generalmente es que, mientras que las APIs realizan llamadas sin saber si reciben alguna actualización de datos como respuesta o no, Los webhooks reciben llamadas a través de POSTs HTTP de sistemas externos sólo cuando tienen algunas actualizaciones de datos.

Luego, los Webhooks pueden "activar" todo el flujo de trabajo de integración para actuar en estas actualizaciones. El punto principal aquí es, sin embargo, que esta activación ocurre por una razón (i.e. porque hay una actualización real al proceso), y no sólo porque es hora de hacer otra comprobación de una actualización.
Otra buena cosa de Webhooks es que proporcionan otras aplicaciones y servicios con información (cercana) en tiempo real. Esto es posible solo a través de APIs también, pero involucra más esfuerzo y consume recursos extremadamente. Los webhooks hacen que el tiempo real sea muy simple.
Nota
Haga clic aquí para comenzar con la API de Regiondo

2. Crea su propio webhook

Para crear su propio webhook en su cuenta de Regiondo, vaya a Marketing > Webhooks.

2.1 nombre de Webhook

Nombra su webhook. Se trata de usted.
Ejemplo
Notificación de Google

2.2 Tipo de disparador

Elija entre los siguientes 3 disparadores: Reserva, Cliente y Ticket.
2.2.1 Reserva - Valores de respuesta
{
    "booking_key": "-2605248-44215-75508-1556874000",
    "product_id": "4215",
    "product_supplier_id": "9357",
    "option_id": "174184",
    "variation_id": "75508",
    "order_id": "2605248",
    " option_name": "Adulto",
    "variación_name": "Horas en Francia  ",
    "ticket_name": "La ruta de Burdeos",
    "product_name": "La ruta de Burdeos",
    "qty": "1",
    "qty_cancelled": "0",
    "event_date_time": "2019-05-03T09:00:00+02:00",
    "date_applied_for": "2019-05-03T09:00:00+02:00",
    "created_at": "2019-04-30T11:02:45+02:00",
    "tipo": "reserva",
    "estado": "aprobado " ,
    "external_id": null,
    "email": "cliente. om",
    "phone_number": nulo,
    "first_name": "Cliente",
    "último _name": "Nombre",
    "duration_type": "minuto",
    "duration_value": "50. 0",
    "order_number": "1556614985033893200",
    "distribution_channel_partner": "Nombre corto o nombre", 
    "contact_data": {
        "nombre": "Cliente",
        "apellido": "Nombre",
        "correo electrónico": "cliente.
2.2.2 Cliente - Valores de respuesta
{
    "customer_email": "customer.name@regiondo. om",
    "customer_firstname": "Cliente",
    "customer_apellido": "Nombre",
    "customer_phone": "",
    "customer_birth_date": nulo,
    "customer_street": "Neumarkter Str. 63",
    "customer_postcode": "81673",
    "customer_city": "Mucho nchen",
    "customer_country": "DE",
    "customer_newsletter_status": 0,
    "customer_newsletter_order": null,
    "customer_newsletter_datetime": null,
    "customer_newsletter_ip": null
}
{
    "customer_email": "customer.name@regiondo. om",
    "customer_firstname": "Cliente",
    "customer_apellido": "Nombre",
    "customer_phone": "",
    "customer_birth_date": nulo,
    "customer_street": null,
    "customer_postcode": null,
    "customer_city": null,
    "customer_country": null,
    "customer_newsletter_status": 0,
    "customer_newsletter_order": null,
    "customer_newsletter_datetime": null,
    "customer_newsletter_ip": null
}
2.2.3 Ticket - Valores de respuesta
{
    "código": "RE57WGQH0G6S",
    "estado": "procesamiento",
    "validation_status": "no validado",
    "data": {
        "validated_at": "2019-04-30T11:03:11+02:00",
        "product_info": {
            "product_name": "La ruta de Bordeaux",
            "variation_name": "Horas en Francia  ",
            "option_name": "Adulto",
            "ticket_datetime": "2019-05-03T09:00:00+02:00"
        },
        "customer_info": {
            "customer_name": "Mr. Nombre del cliente",
            "customer_email": "cliente. ame@regiondo.com"
        }
    }
}
{
    "código": "RE57WGQH0G6S",
    "estado": "enviado",
    "validation_status": "validado",
    "data": {
        "validated_at": "2019-04-30T11:09:09+02:00",
        "product_info": {
            "product_name": "La ruta de Bordeaux",
            "variation_name": "Horas en Francia  ",
            "option_name": "Adulto",
            "ticket_datetime": "2019-05-03T09:00:00+02:00"
        },
        "customer_info": {
            "customer_name": "Mr. Nombre del cliente",
            "customer_email": "cliente. ame@regiondo.com"
        }
    }
}

3. URL de Payload

Aquí debes introducir la URL para la que se llamará cuando el disparador de Webhook ocurra en el panel de mando.
Nota
No olvide probar la URL antes de guardar/activar el webhook.

4. Añadir código de descuento

Puede agregar información sobre la cantidad de descuento, la divisa y el código de descuento. También se le mostrará la cantidad total de la reserva.

4.1 Se utiliza un descuento

"cupon_code": "HALF_PRICE"
"total_paid": "249. 0"
"cupon_discount": "249. 0"
"total": "499.00"
"currency_code": "CHF"

4.2 No se utiliza un descuento

"cupon_code": null
"total_paid": "10. 0"
"cupon_discount": "0. 0"
"total": "10.00"
"currency_code": "EUR"

Artículos relacionados