Durante a conexão de um agente de IA avançado aos e-mails, você pode criar um gatilho de automação que controla como o agente de IA responde às solicitações de clientes no canal de e-mail. Depois de criado, esse gatilho pode ser gerenciado na Central de administração.
Este artigo contém os seguintes tópicos:
Sobre o gatilho de automação de e-mail
Quando você cria o gatilho de automação para um agente de IA avançado para e-mails, o gatilho tem esta configuração padrão:
-
Atende TODAS as condições a seguir:
-
Ticket > Comentário | É | Público
Essa condição garante que o agente de IA seja notificado sobre a resposta de cada cliente, agente ou agente de IA.
-
Ticket > Canal | É | E-mail
Essa condição assegura que o agente de IA seja notificado sobre comentários apenas no canal de e-mail.
-
Detalhes do ticket > Usuário atual | Não é | <seu agente de IA>
Essa condição evita loops. Como o agente de IA é notificado sobre todas as respostas no canal de e-mail, você precisa excluir as respostas dele para que ele não responda a si mesmo.

-
Ticket > Comentário | É | Público
-
Atende QUALQUER condição a seguir:
-
Ticket > Ticket | É | Criado
Essa condição assegura que o agente de IA responda ao primeiro comentário em um ticket.
-
Ticket > Ticket | É | Atualizado
Essa condição assegura que o agente de IA responda aos comentários subsequentes em um ticket.

-
Ticket > Ticket | É | Criado
-
Ações
- Categoria: Notificar por > Webhook ativo
- Valor: Webhook de automação do Ultimate.ai: <ID do seu agente de IA>
- Ponto de extremidade: https://zendesk-support-automation.us.ultimate.ai/v1/webhook
- Método: PUBLICAÇÃO
- Corpo do JSON:
{"botId": "YOUR_AI_AGENT_ID", "message": "**{{ticket.title}}** \n\n {{ticket.latest_comment_rich}}", "conversationId": "{{ticket.id}}", "type": "message", "tags": "{{ticket.tags}}", "channel": "{{ticket.via}}", "requester": "{{ticket.requester.id}}", "currentUser": "{{current_user.id}}", "submitterRole": "{{ticket.submitter.role}}", "authorRole": "{{ticket.comments.first.author.role}}",O corpo do JSON inclui detalhes que permitem ao agente de IA ignorar respostas do agente (embora você possa permitir isso se quiser) e não responder a tickets anteriores a três dias. O tipo também é alterado para fins de análise.

Reordenação do gatilho de automação de e-mail
É possível reordenar a lista de gatilhos de ticket do agente de IA para designar a ordem em que são disparados. Para obter mais informações sobre o possível impacto geral disso em seus fluxos de trabalho, consulte Reordenação de gatilhos.
Como reordenar o gatilho de automação de e-mail
- Na Central de administração, clique em
Objetos e regras na barra lateral e selecione Regras de negócios > Gatilhos. - Clique em Editar ordem no canto superior direito.
- Encontre o gatilho de automação de e-mail para seu agente de IA avançado.
Por padrão, o nome desse gatilho é Ultimate.ai Multitouch Ticket Automation: <ID do agente de IA>.
- Clique e mantenha pressionado o ícone de arrastar e soltar (
) do gatilho, arraste-o até a posição e solte o ícone. - Clique em Salvar.
Edição do gatilho de automação de e-mail
Você pode editar o gatilho de automação de e-mail quando necessário.
Como editar o gatilho de automação de e-mail
- No Agentes de IA - Avançado, selecione o agente de IA avançado com o qual você quer trabalhar.
- Clique em Configurações na barra lateral e selecione Integrações de CRM.
- Selecione a aba Integração.
- Clique em Editar gatilho de automação.
A página de configuração do gatilho é aberta na Central de administração.
- Edite o gatilho conforme a necessidade.
Estes são alguns exemplos de edições que você talvez queira fazer:
- Clique em Salvar.
Resposta a tickets enviados por agente
Por padrão, o gatilho da automação de e-mail é configurado para que o agente de IA não responda a tickets enviados por agentes. No entanto, talvez você queira permitir essa opção, em especial durante testes.
Como permitir que o agente de IA responda a tickets enviados por agentes
- Edite o gatilho de automação de e-mail.
- Remova a linha a seguir do corpo do JSON:
"submitterRole": "{{ticket.submitter.role}}", - Clique em Salvar.
Suporte ao canal de formulário web
Por padrão, o gatilho de automação de e-mail é configurado para funcionar apenas no canal de e-mail. No entanto, você pode adicionar o formulário web como um canal com suporte do seu agente de IA avançado.
Como adicionar o canal de formulário web como um canal com suporte
- Edite o gatilho de automação de e-mail.
- Em Atende TODAS as condições a seguir, apague esta condição:
- Ticket > Canal | É | E-mail
- Em Atende QUALQUER condição a seguir, adicione as condições a seguir:
- Ticket > Canal | É | E-mail
- Ticket > Canal | É | Formulário web
- Clique em Salvar.
Suporte ao canal de API
Por padrão, o gatilho de automação de e-mail é configurado para funcionar apenas no canal de e-mail. No entanto, você pode adicionar a API como um canal com suporte do seu agente de IA avançado.
Ao usar a API do Zendesk, os tickets são sempre criados com o ID do responsável pelo token de autenticação como currentUser. Por isso, o agente de IA interpreta esses tickets criados como enviados por um agente, o que ele deve ignorar com base na configuração. No entanto, você pode dar suporte ao canal de API clonando o gatilho de automação de e-mail e usando a cópia adicionalmente ao gatilho padrão.
Quando uma conversa é criada por meio da API, apenas a origem da primeira mensagem é marcada como API, enquanto o resto das mensagens vem por e-mail. Por isso, o gatilho precisa cobrir apenas o evento de criação dessas conversas. Além disso, os dois gatilhos não se sobrepõem porque o gatilho padrão não inclui API como uma condição de canal, mas a cópia inclui.
O corpo do JSON apresentado abaixo sobrescreve o campo currentUser com esse gatilho para conter o solicitante, fazendo parecer que o ticket foi enviado por um cliente. Por isso, tanto o solicitante quanto o currentUser serão iguais a {{ticket.requester.id}}.
Como clonar o gatilho e configurá-lo para dar suporte ao canal de API
- No Agentes de IA - Avançado, selecione o agente de IA avançado com o qual você quer trabalhar.
- Clique em Configurações na barra lateral e selecione Integrações de CRM.
- Selecione a aba Integração.
- Clique em Editar gatilho de automação.
A página de configuração do gatilho é aberta na Central de administração.
- Clique em Ações no canto superior direito e selecione Clonar.
Uma cópia do gatilho de automação é criada.
- Em Atende TODAS as condições a seguir, apague as condições existentes e adicione estas no lugar:
- Ticket > Canal | É | Serviço da web (API)
- Ticket > Ticket | É | Criado
- Em Atende QUALQUER condição a seguir, apague as condições existentes.
- Em Ações, substitua o corpo do JSON existente pelo seguinte:
{ "botId": "<YOUR_AI_AGENT_ID>", "message": "**{{ticket.title}}** \n\n {{ticket.latest_comment_rich}}", "conversationId": "{{ticket.id}}", "type": "message", "tags": "{{ticket.tags}}", "channel": "{{ticket.via}}", "requester": "{{ticket.requester.id}}", "currentUser": "{{ticket.requester.id}}", "submitterRole": "{{ticket.submitter.role}}", "createdAt": "{{ticket.created_at_with_timestamp}}", "updatedAt": "{{ticket.updated_at_with_timestamp}}" } - Clique em Criar gatilho.