Índice:
- Condición de salida
- Acción para cerrar el ticket
- Cerrar el ticket de los clientes mediante el canal MS Teams
Actualmente tienen dos formas nativas de cerrar tickets: por el asistente a través del Blip Desk o por inactividad del usuario o del asistente.
Si desea ofrecer la opción para que su cliente elija finalizar un ticket, se deben realizar las siguientes configuraciones en su bot de servicio humano:
Condición de salida
Se debe agregar una condición de salida en el bloque de asistencia humana, por ejemplo, puede salir del bloque cuando el usuario escribe "Salir".
Sin embargo, al salir del bloque, el ticket permanece abierto y será necesario cerrarlo manualmente.
Acción para cerrar el ticket
Para cerrar el ticket, en el bloque al que se dirigirá al usuario, agregue una acción de entrada del comando Procesar con el comando para cerrar un ticket con la siguiente solicitud: https://docs.blip.ai/#close-a-ticket-as-user (Si la opción "Usar contexto de enrutador" está habilitada, será necesario reemplazar las acciones "Comando de proceso" con Solicitudes HTTP, paso a paso al final del artículo).
Para obtener la identificación del boleto, simplemente envíe el siguiente comando:
Para: postmaster@desk.msging.net
método: get
URL: /tickets?$filter=(status%20eq%20'open'%20or%20status%20eq%20'waiting')%20and%20(CustomerIdentity%20eq%20'{{contact.identity}}')&$skip=0&$take=100
Aquí hay un ejemplo:
Para filtrar el ticket deseado, cree una acción Ejecutar script:
Agregue la variable de entrada de ticket que tendrá el número de ticket que se encontró en la acción Comando de proceso ejecutada antes de la acción Ejecutar script.
Luego ingrese el siguiente script:
function run(ticket) {
try {
let ticket = JSON.parse(ticket);
return ticket.resource.items[0].id;
} catch (error) {
return 'script error';
}
}
Agrega una variable para guardar la devolución, por ejemplo: ticketId. Aquí hay un ejemplo:
Después de ejecutar la acción del script, agregue una acción más del tipo comando Procesar para cerrar el ticket:
Para: postmaster@desk.msging.net
Método: set
URL: /tickets/change-status
Tipo: application/vnd.iris.ticket+json
Recurso: {"id":"{{ticketId}}","status":"ClosedClient"}
Guardar respuesta: responseClose
Las acciones de entrada del bloque al que se dirigirá el usuario al teclear “salir”, por ejemplo, serán en el siguiente orden:
Si usa una estructura de enrutador y la opción Usar contexto de enrutador está habilitada, deberá usar acciones de solicitud HTTP en lugar de acciones de "comando de proceso".
La primera solicitud debe contener los siguientes parámetros:
OBS: use la URL con la identificación del contrato para consumir los puntos finales informados a continuación, su el rendimiento y el funcionamiento pueden verse afectados si no tiene la identificación del contrato, por lo tanto, es esencial ¡use la URL con la identificación del contrato para usar solicitudes http!
Método: Post
URL: https://{{contractid}}.http.msging.net/commands
Encabezados:
Tipo de contenido: application/json
Autorización: API KEY de tu bot
Cuerpo:
{
"id": "{{random.guid}}",
"to": "postmaster@desk.msging.net",
"method": "get",
"uri": "/tickets?$filter=(status%20eq%20'open'%20or%20status%20eq%20'waiting')%20and%20(CustomerIdentity%20eq%20'{{contact.identity}}')&$skip=0&$take=100"
}
Guarde las respuestas en variables.
Se verá así:
La segunda solicitud anulará la acción del comando de proceso para finalizar el ticket.
Método: Post
OBS: use la URL con la identificación del contrato para consumir los puntos finales informados a continuación, su
el rendimiento y el funcionamiento pueden verse afectados si no tiene la identificación del contrato, por lo tanto, es esencial
¡use la URL con la identificación del contrato para usar solicitudes http!
URL: https://{{contractid}}.http.msging.net/commands
Encabezados:
Tipo de contenido: application/json
Autorización: API KEY de tu bot
Cuerpo:
{
"id": "{{$guid}}",
"to": "postmaster@desk.msging.net",
"method": "set",
"uri": "/tickets/change-status",
"type": "application/vnd.iris.ticket+json",
"resource": {
"id": "{{ticketId}}",
"status": "ClosedClient"
}
}
Guarde las respuestas en variables.
El orden será el siguiente:
Finalmente, en el bloque donde se ejecutarán las acciones para finalizar el ticket, defina una condición de salida para el usuario que finalizó el ticket:
Cerrar el ticket de los clientes mediante el canal MS Teams
Para cerrar el ticket para los clientes que utilizan el canal MS Teams, en el bloque al que se dirigirá al usuario, agregue una acción de entrada del comando Procesar con el comando para cerrar un ticket con la siguiente solicitud: https://docs.blip.ai/#close-a-ticket-as-user
(Si la opción "Usar contexto de enrutador" está habilitada, será necesario reemplazar las acciones "Comando de proceso" con Solicitudes HTTP, paso a paso al final del artículo).
Paso 1:
Para buscar todos los tickets que están abiertos o en espera, usamos el comando:
Por: postmaster@desk.msging.net
Método: get
URL: /tickets?$filter=status%20eq%20'open'%20or%20status%20eq%20'waiting'&$skip=0&$take=100
Aquí hay un ejemplo:
Paso 2:
Para filtrar el ticket deseado, cree una acción Ejecutar script:
Agregue la variable de entrada de ticket que tendrá el número de ticket que se encontró en la acción Comando de proceso ejecutada antes de la acción Ejecutar script.
El cuerpo del script se verá así:
function run(ticketvar) {
var jsonVar = JSON.parse(ticketvar);
jsonVar.resource.items.forEach(item => {
if (item.customerIdentity == "{{contact.identity}}") {
jsonVar.resource.items = [];
jsonVar.resource.items.push(item);
}
});
return jsonVar.resource.items[0].id;
};
Nota: Recuerde presionar CTRL+S después de escribir el script para guardar.
Paso 3:
Después de ejecutar la acción del script, agregue una acción más del tipo comando Procesar para cerrar el ticket:
Por: postmaster@desk.msging.net
Para: postmaster@desk.msging.net
Método: set
URI: /tickets/change-status
Tipo: application/vnd.iris.ticket+json
Resource: {"id":"{{ticketId}}","status":"ClosedClient"}
guardar respuesta: responseClose
Las acciones de entrada del bloque al que se dirigirá el usuario al teclear “salir”, por ejemplo, serán en el siguiente orden:
Para obtener más información, visite la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😊