WebHook TaxiCaller

TaxiCaller es una empresa que ofrece un servicio SaaS (Software como servicio) para el despacho de vehículos, así conductores pueden ofrecer muchos canales de reservas a los clientes.

Para iniciar el WebHook es una alteración al funcionamiento en una página web que nos permite crear Callbacks personalizados, en otras palabras es extender la funcionalidad de una Web tomando eventos de su flujo normal para realizar nuevas tareas.

Aquí en Taxicaller nos permite ejecutar tareas específicas cada que algún evento se presenta.

Es una aplicación que nos permite a propietarios de vehículos y conductores brindar un servicio de despacho a nuestros clientes o pasajeros mediante el uso de una aplicación móvil o web, ofrece herramientas como facturación, análisis de negocio simplificando las operaciones diarias de despacho de vehículos.

Para comprender como funciona el flujo lo detallamos rápidamente, para conductor tenemos:

En el flujo de despacho tenemos:

Ahora que comprendemos el flujo en TaxiCaller podemos comprender cuando utilizar los WebHooks.

Para configurar necesitamos ingresar como administrador a la url siguiente:

https://app-rc.taxicaller.net/dispatch/json-data

No olvidar cambiar a modo administrador en la consola.

En la siguiente pantalla vamos a escoger la opción para configurar el WebHook.

Aquí necesitamos definir nuestro WebHook vamos a crear un JSON, el sistema recibe un array de WebHooks en la siguiente configuración:

[
   {
      "webhook":{
         "headers":[
            {
               "name":"Content-Type",
               "value":"application/x-www-form-urlencoded"
            }
         ],
         "method":"POST",
         "body":"name=[driver.first_name]&last_name=[driver.last_name]&vehicle_num=[vehicle.num]&vehicle_plate=[vehicle.tags.plate]&vehicle_make=[vehicle.tags.make]&vehicle_color_name=[vehicle.tags.color_name]&phone_client=[job.client.phone]",
         "url":"url de nuestro servicio publico"
      },
      "event":"state_callout"
   }
]

Vamos detallando cada parámetro:

webhook: aquí va toda la configuración de nuestro webhook.

webhook-headers: define las cabeceras que se enviarán el momento de generarse el evento (Aquí debemos crear un servicio que reciba esas cabeceras).

webhook-method: es el método que debe aceptar su servicio.

webhook-body: es el cuerpo que va a recibir nuestro servicio esta parte es importante porque nos permite obtener los valores del evento de TaxiCaller como información de vehículo, chofer, teléfono de cliente.

webhook-url: es la url donde se aloja nuestro servicio al cual se comunicará TaxiCaller al darse el evento.

event: Es el evento que vamos a tomar de TaxiCaller.

Los eventos que podemos obtener desde TaxiCaller son:

state_callout.

state_delivered.

state_pob.

state_waiting.

state_assign_timeout.

state_cancel.

state_client_cancel.

state_created_asap.

state_created_prebook.

Luego de configurar los eventos y definir los datos que se va a recibir en el servicio se puede grabar el WebHook y generar los eventos desde el conductor para realizar las pruebas.

Luego de configurar los eventos y definir los datos que se va a recibir en el servicio se puede grabar el WebHook y generar los eventos desde el conductor para realizar las pruebas.

Para tener una idea mas clara de donde se dan los eventos veamos esto desde la aplicación como conductor.

Iniciar la conducción .

Se escoge el vehículo con el que se va a iniciar.

Ingresa solicitud de servicio donde el conductor puede aceptar, en este caso si el conductor acepta se genera el evento state_callout.

Luego aceptado el servicio se muestra la siguiente pantalla con los siguientes posibles eventos.

Con esto ya podemos tener claro como configurar el WebHook y en que ocasiones se presentan los diferentes eventos, y expandir la funcionalidad de estos servicios, si estás trabajando con TaxiCaller espero este post te sea de utilidad no olvides suscribirte a nuestro canal..