WebHook TaxiCaller

taxicaller_webhook_image_feature
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.

COMO CONFIGURAR EL WEBHOOK DE TAXI CALLER

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.

TAXICALLER

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.

Flujo en taxiCaller

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

Taxicaller_conductor

En el flujo de despacho tenemos:

Taxicaller_despacho

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

Configurando el webhook

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.

taxicaller_webhook_cambio_admin

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

taxicaller_webhook_seleccion_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.

Lista de eventos 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.

taxicaller_webhook_grabar_webhook

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.

EVENTOS DESDE EL CONDUCTOR

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

Iniciar la conducción .

taxicaller_webhook_iniciar_conduccion

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

taxicaller_webhook_seleccionar_coche

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

taxicaller_webhook_nuevo_servicio

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

taxicaller_webhook_lista_eventos_aplicativo

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

Leave a Reply

Your email address will not be published. Required fields are marked *