A API de email permite definir propriedades de tickets ao adicionar comandos ao corpo de uma resposta de email para uma notificação. Apenas os agentes podem usar a API de email. Se esses comandos forem usados por usuários finais, o Zendesk vai ignorá-los.
Segue um exemplo de um agente configurando o status e a atribuição de um ticket em resposta a uma notificação por email:
Um agente também pode usar os comandos em um novo email enviado para o endereço de suporte. Este tipo de email cria um novo ticket.
Sintaxe
A API de email apenas examina o topo de seu email para obter a lista de comandos que você deseja executar.
Os comandos devem estar em texto simples, não em HTML, e conforme o seguinte padrão:
#command value
Se, por exemplo, você quiser definir o status de um ticket, use este comando:
#status solved
Cada linha deve ser separada por uma nova linha. Por exemplo, se você quiser definir o status e para quem ele foi atribuído, escreva os comandos da seguinte maneira:
#status solved
#assignee jake@zendesk.com
Insira o corpo do email após o bloco de comandos.
Referência de comandos
Abaixo, está uma lista de todos os comandos suportados que podem ser adicionados, em uma linha de cada vez, ao corpo de um email válido. A lista também inclui comandos curtos, ou seja, comandos de uma palavra para comandos utilizados regularmente que não precisam de valores. Por exemplo, você pode usar o comando curto#solvedao invés de#status solved.
Comando | Descrição |
---|---|
#status |
Os valores válidos são open (aberto), pending (pendente) e solved (resolvido). Observação: o #assignee (atribuído) deve ser definido para que se possa definir um ticket como solved (resolvido). Sintaxe curta:#open #pending #solved Observação: o comando#solvedsó funciona para tickets que não têm campos obrigatórios que o agente deve preencher antes de o ticket ser resolvido. |
#requester | Define o solicitante do ticket. Pode ser a ID do usuário em sua conta ou apenas o endereço de email dele. Caso ainda não existam em sua conta, o Zendesk irá criá-los para você. |
#group |
Atribui o ticket a um grupo. Os valores válidos são o nome do grupo ou a ID de um grupo. |
#assignee | Atribui o ticket a um agente. Os valores válidos são o endereço de email do atribuído ou a ID do Zendesk Support do atribuído (obtido, por exemplo, por meio de uma integração REST). A utilização deste comando o torna, automaticamente, um colaborador (cc) no ticket. |
#priority |
Define a prioridade do ticket. Os valores válidos são low (baixa), normal (normal), high (alta) e urgent (urgente). Observação: para definir uma prioridade, é necessário também definir um tipo de ticket (veja abaixo) Sintaxe curta:#low #normal #high #urgent |
#type |
Os valores válidos são incident (incidente), question (pergunta), task (tarefa) e problem (problema). Sintaxe curta:#incident #question #task #problem |
#tags |
Define quaisquer tags no ticket, que podem ser separadas por espaços ou vírgulas. Observação: a definição das tags remove todas as tags definidas anteriormente no ticket. |
#public |
Define se uma atualização de comentário em um ticket é pública. Utilizável apenas ao atualizar um ticket. O valor padrão é true (verdadeiro), indicando que todas as outras informações inseridas no corpo do email serão visualizadas pelo solicitante. Sintaxe curta:#note(indicando um comentário privado) |
Comandos inválidos
Se você inserir qualquer comando ou valor inválidos, eles serão ignorados pelo Zendesk.
Exemplo
Neste exemplo, o agente usa todos os comandos.
O email faz o seguinte com o ticket #178:
- Define o status para open (aberto)
- Define o grupo para "Support" (Suporte) e o atribui para o agente com o endereço de email “jake@zendesk.com”
- Define a prioridade como "normal" (normal)
- Define o tipo para "question" (pergunta)
- Define as tags para "help" (ajuda) e "api"
- Define a visibilidade do comentário como "private" (privado)
- Adiciona um novo comentário com "Olá Mundo!" ao ticket que, combinado com o comando acima, não será visível para o solicitante.
0 Comentários
Por favor, entre para comentar.