La API de correo permite establecer las propiedades de los tickets agregando comandos al cuerpo de una respuesta por correo electrónico a una notificación o a un mensaje de correo electrónico que crea un nuevo ticket. Solo los agentes pueden usar la API de correo. Si los usuarios finales utilizan estos comandos, Zendesk los ignora.
El siguiente es un ejemplo de un agente que establece el estado y el agente asignado de un ticket en una respuesta a una notificación por correo electrónico:
Un agente también puede usar los comandos en un nuevo mensaje de correo electrónico que se envía a su dirección de soporte. Este tipo de correo electrónico crea un nuevo ticket.
Sintaxis
La API de correo simplemente busca en la parte superior del correo electrónico la lista de comandos que se deben ejecutar.
Los comandos deben estar en texto sin formato, no HTML, y deben seguir el siguiente patrón:
#command value
Por ejemplo, si desea establecer el estado de un ticket, utilice este comando:
#status solved
Cada comando debe estar en una línea separada. Por ejemplo, si desea establecer el estado y el agente asignado, escriba los comandos como sigue:
#status solved
#assignee jake@zendesk.com
Ingrese el cuerpo del mensaje de correo electrónico después del bloque de comandos.
Referencia de comandos
A continuación se muestra una lista de todos los comandos admitidos que se pueden agregar, una línea a la vez, al cuerpo de un mensaje de correo electrónico válido. La lista también incluye comandos cortos, que son comandos de una sola palabra para los comandos que se usan con frecuencia y que no necesitan un valor. Por ejemplo, se puede usar el comando corto #solved
en lugar de #status
solved
.
Comando | Descripción |
---|---|
#status
|
Los valores válidos son abierto, pendiente y resuelto. Para poder marcar un ticket como resuelto, el #assignee debe estar configurado. Sintaxis corta: #solved solo sirve para aquellos tickets que no tienen campos que el agente está obligado a llenar antes de que el ticket se considere resuelto. |
#requester
|
Establece el solicitante del ticket. Puede ser la ID del usuario en la cuenta o simplemente su dirección de correo electrónico. Si aún no existe en su cuenta, Zendesk lo creará. Este comando no está disponible para los agentes Light. |
#group
|
Asigna el ticket a un grupo. Los valores válidos son el nombre del grupo o la ID de un grupo.
Este comando es particularmente útil para los correos electrónicos reenviados. Cuando un agente reenvía un correo electrónico a Zendesk, de manera predeterminada el ticket resultante está sin asignar o bien está asignado al grupo predeterminado del agente. (Consulte Remitir correo electrónico a su dirección de soporte.) En lugar de eso, los agentes pueden usar este comando para asignar automáticamente el ticket reenviado al grupo especificado. |
#assignee |
Asigna el ticket a un agente. Los valores válidos son la dirección de correo electrónico del agente asignado o la ID de Zendesk Support del agente asignado (obtenida a través de una integración REST, por ejemplo). Si usa este comando, automáticamente se convertirá en un colaborador (cc) del ticket. |
#priority
|
Establece la prioridad del ticket. Los valores válidos son baja, normal, alta y urgente. Nota: Para establecer una prioridad, también es necesario establecer un tipo de ticket (ver a continuación) Sintaxis corta: |
#type |
Los valores válidos son incidente, pregunta, tarea y problema. Sintaxis corta: |
|
Establece las etiquetas del ticket, que pueden separarse con espacios o comas. Nota: Al establecer las etiquetas se eliminan todas las etiquetas establecidas anteriormente en ese ticket. |
#public
|
Establece la actualización del comentario de un ticket en pública. Solo se puede usar al actualizar un ticket. El valor predeterminado es “verdadero” para tickets públicos, lo que quiere decir que el solicitante podrá ver cualquier otra cosa que se incluya en el cuerpo del correo electrónico. El valor predeterminado para tickets privados, como los tickets que crean los agentes Light, es “falso”. Sintaxis corta: |
Comandos no válidos
Si se ingresan comandos o valores no válidos, Zendesk no los toma en cuenta.
Ejemplo
En este ejemplo, el agente usa todos los comandos.
El correo electrónico hace lo siguiente en el ticket n.º 178:
- Establece el estado en "abierto"
- Establece el grupo en "Soporte" y el agente asignado en el agente que tiene la dirección de correo electrónico “juan@zendesk.com”
- Establece la prioridad en "normal"
- Establece el tipo en "pregunta"
- Establece las etiquetas en "ayuda" y "api"
- Establece la visibilidad del comentario en "privado"
- Agrega un nuevo comentario que diga "¡Hola a todos!" al ticket, que si se combina con el comando de arriba no estará a la vista del solicitante.