- Integrações
- Zendesk
Integração com o Zendesk: uma conversa que o agente não consegue resolver vira um ticket no Zendesk
A integração da Agenola com o Zendesk abre um ticket no Zendesk para cada conversa que o agente de IA não consegue resolver, com a transcrição e uma nota de transferência, lê o status do ticket de volta do Zendesk e executa operações de tickets, usuários e organizações a partir das etapas do fluxo. Conexão com um clique, sem chaves para copiar.
Como funciona
Quando um cliente quer falar com uma pessoa ou o agente não tem certeza, uma solicitação é registrada: assunto, detalhes, contato. Ela chega ao seu painel e abre no Zendesk. A nota de transferência (resumo e primeiro passo sugerido) fica no topo do texto, seguida do nome do cliente, contato, agente de origem e transcrição. O agente que recebe pode ler as três primeiras linhas e continuar.
O e-mail do solicitante só é definido quando é real: o Zendesk envia as respostas para lá, e com um endereço inventado um agente escreveria uma resposta que não chega a ninguém. Um número de telefone fica no texto.
O status é lido de volta: quando a tela Solicitações do painel abre, os status são consultados no Zendesk, e um ticket resolvido lá aparece como resolvido no painel. Você não configura webhooks.
- A conexão usa o app do Zendesk da Agenola: você digita seu endereço do Zendesk e concede acesso no Zendesk. A conta que concede deve ser agente ou administrador; os tickets e as etapas do fluxo agem em nome dessa pessoa.
- Uma central de ajuda por espaço de trabalho.
- Se a conexão ficar sem uso por 90 dias, o Zendesk revoga a permissão; você então reconecta.
- Remover a conexão também revoga o acesso da Agenola no Zendesk.
O que ele faz
Esta lista é gerada da mesma fonte que a página de Zendesk no painel: se não está listado aqui, não fazemos com Zendesk. As etapas de fluxo ficam no editor de fluxos, em Adicionar etapa → Integrações → Zendesk.
TicketAção · Etapa do fluxo6
Criar ticket
Abre um ticket no Zendesk; sem solicitante, ele é aberto como a pessoa que conectou o Zendesk.
Excluir ticket
Move o ticket para os tickets excluídos.
Obter ticket
Lê o assunto, o status e a prioridade do ticket.
Obter tickets
Retorna como lista os 100 tickets atualizados mais recentemente (opcionalmente por status).
Recuperar ticket suspenso
Transforma um ticket suspenso em um ticket normal.
Atualizar ticket
Altera o status, a prioridade ou as tags; opcionalmente adiciona um comentário ou nota interna.
Campo do ticketAção · Etapa do fluxo2
Obter campo do ticket
Lê o nome e o tipo de um campo do ticket.
Obter campos do ticket
Retorna como lista os campos de ticket do sistema e personalizados.
UsuárioAção · Etapa do fluxo8
Criar usuário
Cria um usuário; usuário final se nenhuma função for escolhida.
Excluir usuário
Exclui o usuário.
Obter usuário
Lê o nome, o e-mail e a função do usuário.
Obter usuários
Retorna como lista os 100 primeiros usuários (opcionalmente por função).
Obter organizações do usuário
Retorna como lista as organizações às quais o usuário pertence.
Obter contagens de tickets do usuário
Lê quantos tickets o usuário solicitou, em quantos está em cópia e quantos tem atribuídos.
Buscar usuários
Encontra usuários com uma consulta de busca do Zendesk (por exemplo, e-mail).
Atualizar usuário
Altera o nome, o e-mail ou o telefone.
OrganizaçãoAção · Etapa do fluxo7
Contar organizações
Lê quantas organizações a conta tem.
Criar organização
Cria uma organização.
Excluir organização
Exclui a organização.
Obter organização
Lê o nome da organização.
Obter organizações
Retorna como lista as 100 primeiras organizações.
Obter contagens da organização
Lê as contagens de tickets e usuários da organização.
Atualizar organização
Altera o nome ou os nomes de domínio.
GatilhoGatilho · Consulta periódica1
Status do ticket alterado
Quando a tela Solicitações abre, os status são obtidos da sua central de ajuda; uma mudança feita lá também aparece no painel.
Exemplos de conversas
Visitante: O nome da empresa na minha fatura está errado, precisa ser corrigido.
Agente: Nossa equipe financeira cuida de correções de faturas. Pode me passar o número do pedido e seu e-mail?
Visitante: 1187, ben@example.com
Agente: Já encaminhei; a equipe responderá por e-mail.
Nos bastidores: Um ticket abre no Zendesk: assunto, nota de transferência ("Correção do nome na fatura, pedido 1187; primeiro passo sugerido: cancelar e reemitir"), solicitante ben@example.com e transcrição.
Visitante: Qual é o status do ticket que abri ontem? Número 4821.
Agente: O ticket 4821 está "pendente"; nossa equipe aguarda mais informações suas.
Nos bastidores: A etapa "Obter ticket" lê o assunto, o status e a prioridade do ticket no Zendesk; o agente informa o status na frase.
Visitante: Tenho uma dúvida sobre um pedido em grande quantidade em nome da Acme Ltd.
Agente: Encontrei sua conta da Acme Ltd; vou abrir a solicitação nela.
Nos bastidores: A etapa "Buscar usuários" encontra o usuário por e-mail, "Obter organizações do usuário" lê a organização; tags e solicitante são preenchidos de acordo ao criar o ticket.
Configuração
Nosso app em Zendesk está em processo de aprovação. Até lá, a conexão não está aberta a todos; depois de aprovado, as etapas desta página valem como estão escritas.
- 1Na Agenola, abra Integrações → Zendesk, digite seu endereço do Zendesk (suaempresa.zendesk.com) e clique em "Conectar ao Zendesk".
- 2Conceda acesso na página que o Zendesk abrir. Você não copia nenhuma chave nem token; a conta que concede deve ser agente ou administrador.
- 3Pronto: as solicitações abertas no chat começam a chegar ao Zendesk. Opcionalmente, adicione etapas do Zendesk no editor de fluxos; tickets, usuários e organizações vêm ao vivo do Zendesk.
Configuração detalhada: Como conectar Zendesk, Intercom ou Freshdesk?
Permissões e para onde vão seus dados
- Enviado ao Zendesk: o assunto da solicitação, a nota de transferência, o nome e contato do cliente, o nome do agente de origem e a transcrição; nas etapas do fluxo, os campos que você escrever. Nenhuma gravação de voz (nenhuma é guardada).
- Lido do Zendesk: o status dos tickets encaminhados (quando a tela Solicitações abre, os 300 mais recentes) e tickets, usuários e organizações quando uma etapa do fluxo pedir.
- Acesso solicitado: leitura e escrita gerais (os escopos "read" e "write" do Zendesk). Os dados de conexão são armazenados criptografados no servidor; o token que expira é renovado sob bloqueio.
- Apenas proprietários e administradores do espaço de trabalho podem alterar a conexão; removê-la também revoga o acesso da Agenola no Zendesk.
Integrações relacionadas
Ver todas as integrações
Gorgias
Conversas transferidas são abertas como tickets de e-mail no Gorgias, com notas internas.
Intercom
As conversas que o agente transfere chegam à caixa de entrada do Intercom da sua equipe.

Freshdesk
Os pedidos são abertos no Freshdesk, e as etapas de fluxo trabalham com tickets e contatos.
Shopify
Responde a perguntas sobre produtos, estoque e pedidos da sua loja e adiciona produtos ao carrinho.
WooCommerce
Responde a perguntas sobre produtos, estoque e pedidos da sua loja WordPress.
Perguntas frequentes
Preciso criar um app ou uma chave de API no Zendesk?
Não. A conexão é feita com o próprio app do Zendesk da Agenola: você digita seu endereço e concede acesso no Zendesk. A política de desenvolvedores do Zendesk também proíbe pedir que clientes criem o próprio app.
Em nome de quem o ticket é aberto?
O solicitante é o cliente quando o e-mail dele é real. Caso contrário, o ticket é aberto em nome da pessoa que conectou o Zendesk, com o telefone deixado pelo cliente no texto.
Um ticket resolvido no Zendesk também fecha no painel?
Sim. Quando a tela Solicitações abre, os status são lidos do Zendesk e refletidos; um ticket fechado que o cliente respondeu também aparece. Nenhum webhook ou gatilho para configurar.
Posso conectar Gorgias ou Intercom ao mesmo tempo?
Não. Uma central de ajuda por espaço de trabalho: a mesma solicitação em duas filas enviaria ao cliente duas respostas diferentes.