Introducción
El conector Zendesk de Bizagi está disponible en Connectors Xchange de Bizagi.
A través de este conector, podrá conectar sus procesos de Bizagi a una cuenta en Zendesk para usar los servicios API de su propio subsitio de tickets en línea.
Para más información de las capacidades de este conector, visite Connectors Xchange de Bizagi.
Antes de iniciar
Para probar y usar este conector, necesita:
1.Bizagi Studio previamente instalado.
2.Éste conector previamente instalado a traves de Connectors Xchange, tal como se describe en https://help.bizagi.com/platform/es/index.html?Connectors_Xchange.htm, o a través de el manual de instalación descrito en https://help.bizagi.com/platform/es/index.html?connectors_setup.htm
3.Una cuenta en www.Zendesk.com, con un subdominio registrado (por ejemplo https://[your_subdomain].zendesk.com/).
Configurar el conector
Para configurar el conector siga los pasos presentados en el capítulo de configuración en https://help.bizagi.com/platform/es/index.html?connectors_setup.htm.
Para esta configuración, considere los siguientes parámetros de autenticación:
•Método de autenticación: Custom.
•User_Name: Las credenciales de acceso a su subdominio en Zendesk (como cuenta de servicio).
•Password: La contraseña para dicha cuenta.
|
Note que para crear los tickets mediante los servicios del API, necesita asegurarse de que se cuenta permita el uso de credenciales con nombre de usuario y contraseña (como fueron configurados en https://[subdominio].zendesk.com/agent/admin/api) y que las cuentas registradas de sus clientes también estén autorizadas (en la configuración en https://subdominio].zendesk.com/agent/admin/customers). |
Usar el conector
Éste conector permite el uso de 34 métodos disponibles para el uso de servicios de Zendesk.
Para aprender en general como y donde configurar el uso de un conector, por favor visite el artículo https://help.bizagi.com/platform/es/index.html?Connectors_Studio.htm.
Al usar el conector, asegúrese de considerar los siguientes detalles de cada uno de los métodos disponibles:
Create new ticket (Crear nuevo ticket)
Este método le permite crear un nuevo ticket en representación de un cliente registrado en su subdominio de Zendesk, mientras lo asigna a un ingeniero de soporte.
Para configurar sus inputs, mapee de la siguiente manera:
•Requester_name: El nombre del remitente del nuevo ticket.
•Requester_email: El correo electrónico del remitente del nuevo ticket.
•Subject: El encabezado principal del nuevo ticket.
•Comment: El detalle del nuevo ticket. Es el cuerpo del mensaje.
•Assignee_id: El id del usuario que será inicialmente asignado al nuevo ticket.
Note que puede verificar el id de un usuario dado al editar sus detalles (el enlace de edición muestra su id única):
Para configurar sus outputs e iniciar pruebas, puede mapear los Id de los tickets creados.
Obtener tiquete (Get ticket)
Obtener un ticket en específico.
Para configurar las entradas, considere:
•id: ID del ticket que desea obtener.
Para configurar las salidas, considere:
Actualizar ticket (Update ticket)
Cambiar la información de un ticket.
Para configurar las entradas, considere:
•id: ID del ticket que desea modificar.
•Requester_name: Nombre del creador del ticket.
•Requester_email: Correo electrónico del creador del ticket.
•Subject: Título principal del ticket.
•Comment: Detalle del ticket.
•Assignee_id: ID del usuario que se asigna al ticket.
•Status: Estado del ticket.
Para configurar las salidas, considere:
Eliminar ticket (Delete ticket)
Eliminar un ticket específico.
Para configurar las entradas, considere:
•id: ID del ticket a eliminar.
Para configurar las salidas, considere:
Listar tickets (List tickets)
Obtener una lista de todos los tickets.
Para configurar las salidas, considere:
Listar tickets recientes (List recent tickets)
Obtiene una lista de los tickets vistos recientemente por el agente que hace la petición.
Para configurar las salidas, considere:
Listar tickets suspendidos (List suspended tickets)
Obtiene la lista de los tickets suspendidos.
Para configurar las salidas, considere:
Crear petición (Create request)
Crea una nueva petición.
Para configurar las entradas, considere:
•Requester_name: Nombre de quien crea la petición.
•Requester_email: Correo electrónico de quien crea la petición.
•subject: Asunto de la petición.
•comment: Comentarios adicionales de la petición.
Para configurar las salidas, considere:
Obtener petición (Get request)
Obtener una petición en específico.
Para configurar las entradas, considere:
•id: ID de la petición a obtener.
Para configurar las salidas, considere:
Obtener métricas de tickets (List ticket metrics)
Obtiene una liste de tickets con sus métricas.
Para configurar las salidas, considere:
Obtener métricas de ticket (Get ticket metrics)
Obtiene las métricas de un ticket en específico.
Para configurar las entradas, considere:
•id: ID del ticket cuyas métricas desea obtener.
Para configurar las salidas, considere:
Listar eventos de métricas de ticket (List ticket metric events)
Obtiene una lista de métricas del ticket, que ocurrieron dentro de cierto intervalo de tiempo.
Para configurar las entradas, considere:
•unixTime: Tiempo Unix (número de segundos transcurridos desde la media noche del 1 de enero de 1970) desde donde quiere obtener los eventos. El intervalo es desde la fecha provista hasta el momento de la invocación del servicio.
Para configurar las salidas, considere:
Obtener ticket suspendido (Get suspended tickets)
Obtiene un ticket suspendido dado.
Para configurar las entradas, considere:
•id: ID del ticket que desea obtener.
Para configurar las salidas, considere:
Eliminar ticket suspendido (Delete suspended ticket)
Elimina un ticket suspendido especificado.
Para configurar las entradas, considere:
•id: ID del ticket que desea eliminar.
Para configurar las salidas, considere:
Crear identidad (Create identity)
Añadir una nueva identidad a un perfil de usuario.
Para configurar las entradas, considere:
•user_id: ID del usuario al que le desea agregar la identidad.
•type: tipo de la identidad. Sus posibles valores son:
oemail
ox
ofacebook
ogoogle
ophone_number
oagent_forwarding
osdk
•value: El verdader valor de la identidad (por ejemplo, el correo electrónico del usuario).
Para configurar las salidas, considere:
Actualizar identidad (Update identity)
Modificar una identidad de un usuario.
Para configurar las entradas, considere:
•user_id: ID del usuario cuya identidad desea modificar.
•id: ID de la identidad a modificar.
•value: El verdader valor de la identidad (por ejemplo, el correo electrónico del usuario). Tenga en cuenta que las identidades de x no se pueden modificar.
Para configurar las salidas, considere:
Eliminar identidad (Delete identity)
Eliminar una identidad de un usuario.
Para configurar las entradas, considere:
•user_id: ID del usuario cuya identidad se desea eliminar.
•id: ID de la entidad a eliminar.
Para configurar las salidas, considere:
Listar identidades (List identities)
Obtiene una lista de identidades.
Para configurar las entradas, considere:
•user_id: ID del usuario cuyas identidades desea obtener.
Para configurar las salidas, considere:
Crear usuario (Create user)
Crea un nuevo usuario.
Para configurar las entradas, considere:
•name: Nombre a asignar al nuevo usuario.
•email: Correo electrónico del nuevo usuario.
•phone: Teléfono del nuevo usuario.
Para configurar las salidas, considere:
Obtener usuario (Get user)
Obtiene información de un usuario en específico.
Para configurar las entradas, considere:
•id: ID del usuario cuya información se desea obtener.
Para configurar las salidas, considere:
Actualizar usuario (Update user)
Modificar la información de un usuario en específico.
Para configurar las entradas, considere:
•id: ID del usuario que se desea modificar.
•name: Nuevo nombre del usuario.
•email: Nuevo correo electrónico del usuario.
•phone: Nuevo teléfono del usuario.
Para configurar las salidas, considere:
Eliminar usuario (Delete user)
Eliminar un usuario en específico.
Para configurar las entradas, considere:
•id: ID del usuario a eliminar.
Para configurar las salidas, considere:
Listar usuarios(List users)
Obtener una lista de usuarios.
Para configurar las salidas, considere:
Crear organización (Create organization)
Crea una nueva organización.
Para configurar las entradas, considere:
•name: Nombre de la organización.
•details: Cualquier detalle de la organización, como dirección o descripción.
•notes: Cualquier anotación adicional sobre la organización.
•external_id: ID externo de la organización para asociarla con otro sistema.
Para configurar las salidas, considere:
Obtener organización (Get organization)
Obtener información sobre una organización en específico.
Para configurar las entradas, considere:
•id: ID de la organización que desea obtener.
Para configurar las salidas, considere:
Actualizar organización (Update organization)
Modificar información de una organización.
Para configurar las entradas, considere:
•id: ID de la organización a modificar.
•name: Nombre de la organización.
•details: Cualquier detalle de la organización como dirección o descripción.
•notes: Cualquier anotación adicional sobre la organización.
•external_id: ID externo de la organización para asociarla con otros sistemas.
Para configurar las salidas, considere:
Eliminar organización (Delete organization)
Eliminar una organización en específico.
Para configurar las entradas, considere:
•id: ID de la organización a eliminar.
Para configurar las salidas, considere:
Listar organizaciones (List organizations)
Obtiene una lista de organizaciones.
Para configurar las salidas, considere:
Buscar organización por ID externo (Search organization by external ID)
Obtener una organización por su ID externo.
Para configurar las entradas, considere:
•external_id: ID externo de la organización.
Para configurar las salidas, considere:
Crear encuesta de satisfacción (Create a satisfaction rating)
Crear una encuesta de satisfacción de un ticket. Tenga en cuenta que para que el método sea válido, el estado del ticket debe ser "Solved" y el correo electrónico de quien solicita la encuesta debe ser el mismo de quien creó el ticket.
Para configurar las entradas, considere:
•ticket_id: ID del ticket sobre el que se creará la encuesta.
•score: Calificación. Los valores posibles son: "offered", "unoffered", "good" o "bad".
•comment: Comentario recibido con la calificación.
•requester_email: Correo electrónico de quien creó el ticket.
Para configurar las salidas, considere:
Obtener calificación de satisfacción (Get satisfaction rating)
Obtener información acerca de una calificación de satisfacción.
Para configurar las entradas, considere:
•id: ID de la encuesta que desea obtener.
Para configurar las salidas, considere:
Listar encuestas de satisfacción (List satisfaction ratings)
Obtener una lista de encuestas de satisfacción.
Para configurar las salidas, considere:
Añadir comentario a una petición (Add comment to request)
Añade un comentario a una petición existente.
Para configurar las entradas, considere:
•id: ID de la petición a la que desea añadirle un comentario.
•Comment: Comentario a añadirle a la petición.
Para configurar las salidas, considere:
Listar peticiones abiertas (List open requests)
Obtiene una lista de todas las peticiones abiertas.
Para configurar las salidas, considere:
Para más información acerca del uso de este método, consulte la documentación oficial de Zendesk en https://developer.zendesk.com/rest_api/docs/core/tickets.
Last Updated 8/2/2024 4:33:16 PM