- Integrações
- Freshdesk

Integração com o Freshdesk: uma conversa transferida vira um ticket no Freshdesk
A integração da Agenola com o Freshdesk abre uma conversa que o agente de IA não consegue resolver como ticket no Freshdesk com a transcrição e uma nota de transferência (as urgentes com prioridade alta), lê o status de volta e executa operações de tickets, respostas, notas internas e contatos a partir das etapas do fluxo.
Como funciona
Quando um cliente quer falar com uma pessoa, uma solicitação é registrada e aberta no Freshdesk: o assunto e, no corpo, a nota de transferência, o nome e contato do cliente, o agente de origem e a transcrição. Se o agente marcou a conversa como urgente, o ticket abre com prioridade alta. O e-mail do solicitante só é definido quando é real.
A conexão usa uma chave de API: não há OAuth para a API do Freshdesk, e o OAuth da Freshworks não a cobre. Tickets, respostas e notas são escritos em nome do agente dono da chave; se essa pessoa sair, a conexão quebra, então use a chave de uma conta de suporte compartilhada.
O status é lido de volta: quando a tela Solicitações abre, os status são consultados no Freshdesk e refletidos no painel.
- As etapas do fluxo vão além das operações de contatos e tickets do n8n: resposta ou nota interna em um ticket, busca por e-mail, status, prioridade e tag, e obtenção do histórico da conversa.
- Status e prioridade são números no Freshdesk; na etapa, você os escolhe pelo nome (aberto, pendente, resolvido, fechado; baixa, média, alta, urgente).
- Uma central de ajuda por espaço de trabalho.
O que ele faz
Esta lista é gerada da mesma fonte que a página de Freshdesk no painel: se não está listado aqui, não fazemos com Freshdesk. As etapas de fluxo ficam no editor de fluxos, em Adicionar etapa → Integrações → Freshdesk.
ContatoAção · Etapa do fluxo5
Criar contato
Cria um contato no Freshdesk.
Excluir contato
Move o contato para os contatos excluídos.
Obter contato
Lê o nome, o e-mail e o telefone do contato.
Obter contatos
Retorna como lista os 100 primeiros contatos.
Atualizar contato
Altera o nome, o e-mail ou o telefone.
TicketAção · Etapa do fluxo8
Criar ticket
Abre um ticket para o e-mail informado; por padrão, prioridade baixa e status aberto.
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).
Obter conversa do ticket
Retorna como lista a primeira mensagem, as respostas e as notas do ticket, os mais antigos primeiro.
Responder ao ticket
Escreve uma resposta ao cliente ou uma nota interna, como o agente que conectou o Freshdesk.
Buscar tickets
Encontra até 100 tickets por e-mail, status, prioridade ou tag; filtros vazios são ignorados.
Atualizar ticket
Altera o status, a prioridade ou as tags.
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: Fui cobrado duas vezes, isso precisa ser resolvido hoje!
Agente: Estou passando a cobrança dupla para nossa equipe agora, como urgente. Seu e-mail?
Visitante: nora@example.com
Nos bastidores: O ticket abre no Freshdesk com prioridade alta; solicitante nora@example.com, corpo com a nota de transferência ("cobrança dupla; primeiro passo sugerido: verificar a transação no provedor de pagamento") e a transcrição.
Visitante: Abri um ticket mais cedo, qual é o status?
Agente: Há um ticket aberto no seu e-mail: "Frete de devolução", status pendente.
Nos bastidores: A etapa "Buscar tickets" lista tickets no Freshdesk por e-mail e status; o agente informa o assunto e o status do primeiro.
Agente: Anotei seu status de envio para nossa equipe; eles continuarão com você.
Nos bastidores: A etapa "Responder ao ticket" com a opção de nota interna escreve no ticket do Freshdesk o que o agente leu; a nota aparece em nome do dono da chave.
Configuração
- 1No Freshdesk, clique na sua foto de perfil → Configurações do perfil e copie a chave em "Your API Key" à direita. A chave de uma conta de suporte compartilhada é mais durável.
- 2Na Agenola, abra Integrações → Freshdesk, informe o endereço da sua conta (suaempresa.freshdesk.com) e a chave; a conexão é testada antes de salvar e a permissão da chave para abrir tickets é verificada.
- 3Pronto: as solicitações abertas no chat chegam ao Freshdesk. Opcionalmente, adicione etapas do Freshdesk no editor de fluxos; tickets e contatos vêm ao vivo do Freshdesk.
Configuração detalhada: Como conectar Zendesk, Intercom ou Freshdesk?
Permissões e para onde vão seus dados
- Enviado ao Freshdesk: o assunto da solicitação, a nota de transferência, o nome e contato do cliente, o agente de origem, a transcrição e a prioridade; nas etapas do fluxo, os campos que você escrever.
- Lido do Freshdesk: o status dos tickets encaminhados (quando a tela Solicitações abre) e tickets, históricos de conversa e contatos quando uma etapa do fluxo pedir.
- A chave de API é armazenada criptografada no servidor e nunca mais é mostrada; apenas proprietários e administradores do espaço de trabalho podem alterar a conexão.
- Os registros são escritos em nome do dono da chave; se esse agente gerar uma nova chave, você reconecta.
Integrações relacionadas
Ver todas as integraçõesZendesk
Conversas não resolvidas viram tickets do Zendesk com a transcrição e uma nota de transferência; o status é lido de volta.

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.
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
Por que uma chave de API em vez de OAuth?
Não há OAuth para a API do Freshdesk; o OAuth da Freshworks não a cobre. A chave é verificada antes de salvar, armazenada criptografada no servidor e nunca mais é mostrada.
Em nome de qual agente o ticket é aberto?
Do dono da chave. O solicitante é o cliente (quando o e-mail é real); respostas e notas internas também aparecem em nome do dono da chave. Por isso, recomenda-se a chave de uma conta de suporte compartilhada.
Como um ticket urgente é diferenciado?
Se o agente marcou a conversa como urgente (pagamento, pacote não entregue), o ticket abre no Freshdesk com prioridade alta; os demais com prioridade normal.