Handy soporte la integración para enviar los eventos como pedidos, visitas con o sin formulario y nuevos clientes a través de mensajes vía AWS SQS, de esta manera podemos obtener todos los beneficios de la tecnología SQS y no perder ningún mensaje.
Para activarlos basta con activar las casillas de los módulos que te interesa recibir en configuración de compañía en la parte de Integraciones. Debes contar con una cuenta de AWS y enviarnos tu número de cuenta de este servicio a hola@handy.la, para leer los mensajes de la queue no es necesario contar con un plan de paga en la plataforma de AWS.
Utilizando el AWS SDK de lenguaje de programación de tu preferencia, podrás suscribirte a la cola a través de la URL señalada en Handy y realizar pollling de los mensajes de esa cola.
Recomendamos crear un job que revise cada cierto tiempo a través de AWS SDK si la cola tiene mensajes nuevos, si los tienes procesarlos de acuerdo a su tipo.
Tip: Al utilizar AWS SDK de NodeJS no es necesario contar con un job que realiza poll a los mensajes de la cola.
Los mensajes tendrán la siguiente estructura:
- Un atributo llamado "type" que indicará que tipo de información tiene el mensaje. Pueden ser "visit", "new-customer", "sales-order".
- El mensaje a leer será tipo String y vendrá estructurado formato JSON. Para manejar la información deberás convertir el String en formato JSON.
{"id":450146,"createdBy":"angel.y@handy.la","result":{"id":1,"description":"Venta registrada","enabled":true,"effective":true,"formGroupVersion":0},"dateCreated":1477334642372,"start":"2016-10-24T18:43:46Z","end":"2016-10-24T18:44:00Z","latitude":20.66704750061035,"longitude":-103.43767547607422,"accuracy":50,"comment":"11-8","geofenceExit":null,"formResponse":null,"calendarEvent":null,"customer":{"id":2205231,"code":"2205231","description":"Cliente Enrique","enabled":true,"latitude":20.6670329,"longitude":-103.4377228,"accuracy":21.355,"zone_id":5253,"zone_description":"Zona 1","address":"Calle Santo Tomas de Aquino 5748 ","city":"Zapopan","postal_code":"","owner":"","phone_number":"","comments":"","date_created":1475864430000,"last_updated":1475864430000,"is_prospect":true,"mobile":false,"email":"","priceList":null,"discount":0,"created_by":"temo@handy.la","balance":0,"credit":0,"customerFather":0}}
--------------------------------------------------------------------------------------------------------
Atributo type: sales-order
Mensaje en tipo String:
{"id":204674,"items":[{"id":958799,"product_code":"P002","product_id":1081464,"price":12,"quantity":4,"comments":null},{"id":958800,"product_code":"P001","product_id":1081463,"price":12.5,"quantity":3,"comments":null},{"id":958801,"product_code":"P003","product_id":1081465,"price":9.5,"quantity":2,"comments":null}],"customer_code":"2205232","customer_id":2205232,"type":null,"delivery_scheduled_date":null,"created_by":{"username":"angel.y@handy.la","name":"Angel Yolando"},"comment":null,"date_created":1477334713675,"total":104.5,"price_list":null}
--------------------------------------------------------------------------------------------------------
Atributo type: new-customer
Mensaje en tipo String:
{"id":2205268,"code":"2205268","description":"Cliente X","enabled":true,"latitude":20.6670475,"longitude":-103.4376756,"accuracy":50,"zone_id":5253,"zone_description":"Zona 1","address":"Calle Santo Tomas de Aquino 5748 ","city":"Zapopan","postal_code":"","owner":"","phone_number":"364525407961","comments":"","date_created":1477335119548,"last_updated":1477335119548,"is_prospect":true,"mobile":false,"email":"","priceList":null,"discount":0,"created_by":"angel.y@handy.la","balance":0,"credit":0,"customerFather":0}
--------------------------------------------------------------------------------------------------------