1. Integrações
  2. 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

Transferência: uma conversa urgente vira um ticket de alta prioridade

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.

Os tickets abertos de um cliente

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.

O agente adiciona uma nota interna

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

  1. 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.
  2. 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.
  3. 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ções

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.

Teste a conexão com Freshdesk na sua própria conta

A Agenola e seus parceiros usam cookies para melhorar o site e mostrar anúncios relevantes para você. Contamos quais anúncios trazem visitantes sem usar seu nome ou e-mail; qualquer coisa além disso só acontece se você permitir. Política de Privacidade(abre em uma nova aba)