# vendesk https://github.com/Induxsoft/vendesk Paquete para la gestión de ventas y atención a clientes. ## Variables ## Privilegios - `VC10` Atención a clientes. - `VC11` Agregar nota al cliente. - `VC12` Registrar atención. - `VC13` Activar alertas. - `VC14` Desactivar alertas. - `VC15` Administrar cliente. - `VC21` Crear caso. - `VC22` Editar caso. - `VC23` Anexar notas a un caso. - `VC24` Adjuntar archivos a un caso. - `VC25` Eliminar archivos adjuntos a un caso. - `VC26` Cerrar caso. - `VC27` Re-abrir caso. - `VC30` Administración de casos . - `VC40` Administración de tipos de casos. - `VC50` Administración de prioridades de casos. - `VC60` Configurar notificaciones de atención a clientes. - `VC61` Asignar Notificación. ## Tipos de elementos de datos - `DET014` Cliente. - `DET01C` Documento de venta. ## Servicios ## Tareas ## Bibliotecas ## Eventos - `VC13` Activar alertas. - `VC21` Crear caso. - `VC22` Editar caso. - `VC23` Anexar notas a un caso. - `VC24` Adjuntar archivos a un caso. - `VC26` Cerrar caso. - `VC27` Reabrir caso. ## Simple Integration service endpoint (SISE) #### Agregar prospecto - Punto final: /!/sise/lead-add/ ##### Campos esperados - **name -** Nombre del prospecto (requerido). - *email -* Correo electronico. - *phone -* Teléfono. - *organization -* Organización a la que pertenece el prospecto. - *position -* Puesto del prospecto en la Organización. - *subject -* Asunto o motivo por la cual está interesado en el producto o servicio. - *remarks -* Comentarios adicionales. - *agent_id -* Usuario a la que se asignará el prospecto. - *leadstatus -* Estado. - *pipeline -* Nombre o sys_guid del pipeline al que se añadirá el prospecto si el status es oportunidad. - *stage -* Nombre o sys_guid de la etapa del pipeline en la que se ubicará al prospecto. - *calendar -* objeto con la información necesaria para agendar un evento de calendario a través del SISE de PIM. - *idfield -* El nombre del campo usado como clave para actualizar al lead, si se omite siempre agregará, los campos para identificación posibles son: email, phone o lead_guid (devuelto en la respuesta) - *retention -* Días después de los que aunque exista la clave (a menos que sea lead_guid) se considera como nuevo (opcional) - *default_participant -* true/false, el valor predeterminado es true (aunque se omita), esto indica que se incluyan los datos del lead como participante si no está en la lista de participantes de un evento de calendario - *subject_iskeypart -* true/false si es true, el asunto se considera como parte de clave de identificación - *exclude_update_fields -* lista de campos a excluir en la actualización separado por comas - *exclude_update_status -* Arreglo de status en los que no se realiza la actualización (no genera un error, solo omite actualizar y no agrega) - *update_rem_as_note -* true/false si es true, en el caso de que corresponda actualizar que solo agregue remmarks como nota al lead ###### Estados - *0 -* Recibido. - *1 -* Atendido. - *2 -* Descartado. - *3 -* Oportunidad. - *4 -* Ganado. - *5 -* Perdido. ###### Retorno "Se ha registrado con éxito la información de contacto"" --- #### Agregar ticket - Punto final: /!/sise/open-ticket/ ##### Campos esperados - **customer_id -** Identificador del cliente `código` (requerido). - **ticket_type -** Tipo de ticket (requerido). - **description -** Descripción del ticket (requerido). - **subject -** Asunto por la cual se apertura el ticket (requerido). - *date_open -* Fecha de apertura (si se omite, se asigna la fecha actual). - *hour_open -* Hora de apertura (si se omite, se asigna la hora actual). - *user -* Usuario quien apertura el ticket. - *email_notif* - correo electrónico en la cual se notificarán las actualizaciones del ticket. ``` NOTA: Para que pueda recibir notificaciones de las actualizaciones del ticket vía correo electrónico, es necesario contar con la siguiente configuración: - Tener configurado al menos un canal de comunicación en su sistema V12.. - En Variables de configuración, dentro de la categoría `vendesk`, debe estar configurada la variable `vendesk_ext_notif`. ``` ##### Tipos de tickets - *611857F14E5611E3BA6975DAE5EEF70A -* Quejas - *AA8BF7234E5611E3BA6975DAE5EEF70A -* Sugerencias - *AD4732804E5611E3BA6975DAE5EEF70A -* Soporte técnico - *AFE659D64E5611E3BA6975DAE5EEF70A -* Garantías - *B31E7E504E5611E3BA6975DAE5EEF70A -* Logística y operaciones - *B70771D84E5611E3BA6975DAE5EEF70A -* Otros ##### Retorno "Se ha creado un nuevo caso con el id # Número de ticket" #### Listar tickets de un cliente - Punto final: /!/sise/list-tickets/ ##### Campos esperados - **customer_id -** Identificador del cliente `código` (requerido). ##### Retorno JSON ``` [ { "id_ticket":"Número de ticket", "id_unique":"Identificador único (sys_guid)", "opened_date":"Fecha de apertura", "opened_time":"Hora de apertura", "closed_date":"Fecha de cierre", "closed_time":"Hora de cierre", "user_opened":"Usuario quien aperturó el ticket", "user_closed":"Usuario quien cerró el ticket", "user_assign":"Usuario al que fue asignado", "subject":"Asunto de ticket", "description":"Descripción por la cual se aperturó", "ticket_type":"Tipo de ticket", "duration":"Tiempo de duración", "priority":"Prioridad", "status":"Estado" }, .... ] ``` #### Información de un ticket en especifico - Punto final: /!/sise/info-ticket/ ##### Campos esperados - **ticket -** Número de ticket. ##### Retorno JSON ``` { "id_ticket":"Número de ticket", "id_unique":"Identificador único (sys_guid)", "opened_date":"Fecha de apertura", "opened_time":"Hora de apertura", "closed_date":"Fecha de cierre", "closed_time":"Hora de cierre", "user_opened":"Usuario quien aperturó el ticket", "user_closed":"Usuario quien cerró el ticket", "user_assign":"Usuario al que fue asignado", "subject":"Asunto de ticket", "description":"Descripción por la cual se aperturó", "ticket_type":"Tipo de ticket", "duration":"Tiempo de duración", "priority":"Prioridad", "status":"Estado" } ``` ---