Como configurar um agente de IA de voz no Freshcaller e conectá-lo ao Freshdesk

Escolha a arquitetura antes de mexer em qualquer número de telefone

A expressão “agente de IA de voz do Freshdesk” abrange três funções diferentes:

  1. Freshcaller: números de telefone, chamadas recebidas, IVR, ações durante o horário comercial e roteamento.
  2. Provedor de voz: conversa, reconhecimento de fala, respostas, instruções ao agente e contexto de transferência.
  3. Freshdesk: registros de tickets, anotações, acompanhamento e o fluxo de trabalho de suporte da equipe.

Da Freshworks’ Guia de integração do Agente de IA de Voz descreve integrações de terceiros, como o Synthflow e o Squawkvoice. Além disso, lista separadamente o IVR com reconhecimento de voz no plano Enterprise. A IA de voz conversacional e o IVR com reconhecimento de voz não são intercambiáveis: um lida com um diálogo e pode transferir a chamada mantendo o contexto; o outro, principalmente, direciona os chamadores por meio de uma experiência de IVR.

Antes de alterar um número, verifique se há acesso de administrador ao Freshworks, um número de teste aprovado, um destino alternativo com atendimento e uma política de suporte que permita o uso de detalhes fictícios para testes. Não comece pela linha principal de atendimento ao cliente. Uma saudação de IA bem-sucedida comprova apenas que a conexão de áudio foi estabelecida; ela não comprova o repasse da chamada, o tempo de criação do ticket nem a automação pós-chamada.

Para uma visão geral da análise estruturada do apoio, Privacidade de dados em IA é um recurso útil, mas o conteúdo do GlobalGPT não faz parte da documentação do Freshworks.

O chat de voz para consumidores também possui uma arquitetura diferente. O Lançamento do serviço de voz ChatGPT pode ajudar a explicar como funcionam as interfaces conversacionais, mas não fornece um número do Freshcaller, uma rota SIP, um contexto de transferência nem um ticket do Freshdesk.

Instale e conecte o provedor de serviços de voz

O caminho oficial de integração do Synthflow foi projetado com base em uma instalação do Freshworks Marketplace. O atual Documentação do Synthflow Freshworks indica que a conta deve ser criada por meio desse fluxo; uma conta independente do Synthflow já existente não pode ser migrada para uma conta conectada ao Freshworks.

Passo 1: Instale o aplicativo

No Freshworks, abra Configurações de administração → Marketplace e integrações → Aplicativos do Marketplace e procure por Agentes de IA de voz da Synthflow (ou a alternativa compatível exibida na sua conta). Instale-o e siga as instruções de configuração.

Etapa 2: Use a chave da API do telefone

Tanto o Freshworks quanto o Synthflow diferenciam as credenciais do telefone de outras chaves de API. Abra o perfil ou a área de configurações da API e localize Detalhes da API para telefone. Copie essa chave, e não uma chave do CRM ou do chat. Insira o domínio do Freshworks no formulário de configuração do aplicativo e utilize a ação “Verificar/Salvar”.

Mantenha as credenciais no formulário de configuração autorizado. Não cole uma chave de API em uma mensagem da equipe, em uma captura de tela ou no prompt do Coding Agent. Após salvar, use Abrir o Portal Synthflow a partir do aplicativo Freshworks. O portal vinculado mantém a associação de contas exigida pelo Freshcaller.

Etapa 3: Criar o agente de voz

No portal indicado no link, abra Meus agentes e crie o agente piloto. Defina um escopo de suporte restrito, o conhecimento aprovado e resultados explícitos de escalonamento. Cada novo agente recebe um URI SIP; o Freshcaller mantém o número de telefone, enquanto o fluxo de trabalho de chamadas direciona a chamada para o agente por meio da conexão com a operadora.

O primeiro agente deve responder a uma pergunta conhecida e reconhecer um caminho de solicitação humana. Evite uma instrução genérica do tipo “lidar com qualquer coisa”. Anote os nomes exatos dos contextos que o agente enviará, pois o Freshcaller associa esses nomes às ações posteriormente.

Crie o fluxo de trabalho de transferência no Freshcaller

Da Freshworks’ guia do fluxo de chamadas para transferência de atendimento trata contextos e ações como elementos distintos. Um contexto é um gatilho definido no provedor de voz, como, por exemplo, escalonamento_de_faturamento ou solicitações_do_chamador_para_atendimento_humano. Uma ação é o que o Freshcaller faz quando esse contexto ocorre.

Aberto Configurações de administração → Configuração e fluxos de trabalho → Fluxos de trabalho de chamadas, escolha Transferência de atendimento do agente de IA de voz, nomeie o fluxo de trabalho e selecione o agente de voz. Insira os nomes dos contextos exatamente como foram configurados no provedor. Em seguida, mapeie cada contexto a uma ação compatível:

Definir Se não for recebido nenhum contexto ou se o contexto for desconhecido para um plano alternativo explícito. Não deixe isso implícito. Um plano alternativo faz parte do comportamento do produto, não é um detalhe de implementação: ele determina o que acontece quando a formulação da IA e a lista de contexto do Freshcaller divergem.

Utilize o editor de contexto/ação do Freshcaller como fonte de referência para os nomes configurados. Um modelo de texto pode sugerir um mapeamento, mas não pode confirmar se o fluxo de trabalho de produção contém a mesma grafia.

Mapeie cada contexto de voz a uma ação explícita

escalonamento_de_faturamento

Fila de chamadas
Envie uma solicitação verificada relacionada a cobrança para o Suporte de Cobrança

solicitações_do_chamador_para_atendimento_humano

Fila de chamadas ou IVR
Deixe que quem ligar escolha o time certo

fora do horário comercial

Correio de voz
Registrar uma mensagem fora do horário comercial

precisa-se de especialista

Automação de roteamento
Aplicar uma regra de roteamento existente

agente_incerto

Outro agente de IA de voz ou fila
Mude para um fluxo mais restrito

contexto_desconhecido

Correio de voz ou desligar a ligação
Entrar em modo de falha segura quando o contexto estiver ausente
Resumo: Mapa de transferência do Freshcaller que conecta contextos de voz a filas, IVR, correio de voz e rotas alternativas
Gráfico de apoio editorial para transições de contexto para ação; verifique os nomes exatos dos contextos no produto ativo.

Atribuir o fluxo de trabalho a um número de teste

A criação de um fluxo de transferência não o ativa em uma linha. No Freshcaller, acesse Configurações de administração → Canais → Telefone, selecione um número aprovado e abra seus controles de edição. Em Ações de chamada:

  1. Escolha o horário de funcionamento.
  2. Definir Ação durante o horário comercial para Enviar para o agente de IA de voz.
  3. Selecione o agente de atendimento por voz desejado e o fluxo de trabalho exato para o repasse.
  4. Verifique a ação de chamadas efetuadas e salve.

Faça um teste durante o horário comercial e outro fora desse horário. Verifique o destino real e o resumo da transferência na tela do agente receptor. Não confie apenas no que o agente de atendimento diz: “Estou transferindo sua ligação”. O Documentação de transferência do Freshcaller afirma que o agente que recebe a chamada deve ver um breve resumo, com o contexto detalhado da transferência e a conversa subsequente, a transcrição e a gravação disponíveis na Caixa de Entrada, quando permitido pela configuração.

Entenda o faturamento do Freshcaller e do provedor de serviços de voz

O Freshcaller e o provedor de serviços de voz medem coisas diferentes. O atual da Freshworks Página de preços do Freshcaller apresenta os preços anuais das assentos, além das tarifas por minuto:

PlanoPreço anual do assentoMinutos de chamadas recebidas incluídos por conta/mêsCaracterísticas notáveis da voz
Gratuito$0/agente/mêsNão há subsídio listadoIdentificação básica de chamadas, notas, mensagens de saudação, métricas
Crescimento$15/agente/mês2,000Portabilidade de números, filas de espera, correio de voz, transferências, gravação
Prós$39/agente/mês3,000Automação de roteamento, conferências, escalonamentos inteligentes
Empresa$69/agente/mês5,000IVR com reconhecimento de voz e monitoramento do nível de serviço

A Freshworks afirma que o Freshcaller cobra pelo tempo total em que a linha telefônica permanece ativa, incluindo a parte atendida por um agente humano após a transferência para a IA. O provedor de serviços de voz cobra pela duração do atendimento realizado pela IA de acordo com seu plano. Para uma chamada de dez minutos, sendo seis minutos atendidos pela IA e quatro minutos por um agente humano, a Freshcaller pode cobrar pelos dez minutos inteiros, enquanto o provedor cobra apenas pelos seis. O preço por licença, por si só, não é, portanto, uma estimativa completa do custo da chamada.

Os planos e a capacidade dos provedores podem sofrer alterações. Mantenha a tabela do Freshcaller separada dos termos específicos de cada conta do Synthflow e verifique ambas as fontes na data da publicação. Para um contexto geral de comparação de planos, ferramentas e plataformas de IA completas pode ser vinculado, mas não substitui a página de preços de nenhum dos fornecedores.

Verifique o caminho do ticket do Freshdesk separadamente

A rota de chamadas e a rota de tickets podem apresentar falhas em momentos diferentes. Um atendente pode criar um ticket no Freshdesk assim que a chamada começar e, em seguida, adicionar o resumo mais tarde. Uma automação acionada por um “novo ticket” pode ser executada antes que o contexto relevante da chamada esteja disponível. Uma automação acionada por uma “atualização de ticket” pode ser executada repetidamente à medida que o atendente adiciona notas.

Para a camada pós-chamada, resumos automáticos de conversas de suporte oferece uma estrutura útil para análise. Isso não constitui prova de que a Freshcaller tenha criado ou atualizado o ticket nessa configuração.

Utilize uma chamada de teste fictícia autorizada e, em seguida, verifique manualmente o ticket gerado:

PalcoO que verificar
Transferência de chamada de vozA chamada chegou à fila humana pretendida ou ao plano alternativo documentado
Criação de ticketExiste um ticket no Freshdesk com o contexto da chamada esperado
Qualidade do contextoO status da identidade, a solicitação e os fatos não esclarecidos permanecem explícitos
Escopo da automaçãoApenas o bilhete do piloto foi processado
Rascunho do destinoO acompanhamento aparece como uma nota interna confidencial
Resposta do clienteO envio permanecerá desativado até que seja aprovado separadamente

Somente depois que o formato do ticket for definido é que você deve configurar uma automação específica no Freshdesk. Mantenha Enviar resposta ao ticket desativado. Exigir aprovação para Deixar uma nota interna, e deixe de fora as ações não relacionadas. Distinga um gatilho de “novo ticket” de um gatilho de “atualização de ticket” e crie um novo evento de teste correspondente após a automação existir. Não espere que uma regra recém-criada processe retroativamente um ticket de inspeção anterior.

Ao escolher um modelo específico de avaliação de textos, compare a rubrica em si, em vez de se basear em uma marca conhecida. A Comparação de assistentes de IA testados pode influenciar essa escolha, mas a opção do Freshcaller ainda precisa passar por seu próprio teste de chamadas autorizado.

Um tema seguro para uma reflexão ficcional após o plantão

O texto a seguir é uma instrução para revisão de texto do GlobalGPT, e não um comando da API do Freshdesk. Ele exclui deliberadamente as respostas dos clientes e as anotações nos tickets do escopo:

texto

O resultado gerado pelo modelo serve apenas como um rascunho para análise. Ele não comprova que o Freshcaller tenha transferido a chamada, que o Freshdesk tenha criado um ticket ou que a nota privada tenha sido publicada. Para uma perspectiva mais ampla da automação, Como usar o ChatGPT Agent fornece contexto, mas não é uma interface de controle do Freshworks.

Para trabalhos de revisão em equipe, uma ferramenta de IA completa para equipes pode centralizar as comparações entre versões preliminares. Um arquivo separado Visão geral dos modelos de IA “tudo em um” ajuda a explicar a escolha do modelo; nenhum dos dois consegue verificar a transferência por telefone.

Solução de problemas antes de expandir o projeto-piloto

Seis verificações antes de ampliar o projeto-piloto

O agente de voz não aparece no menu suspenso do Freshcaller.

Confirme se ela foi criada no portal do provedor vinculado ao Freshworks, e não em uma conta independente.

A chave da API não passou na verificação.

Verifique novamente se a mensagem veio de Detalhes da API para telefone, e não uma credencial de CRM ou de chat, e verifique o domínio do Freshworks.

A ligação é encaminhada para a equipe errada.

Compare a grafia exata do contexto fornecida pelo provedor com o fluxo de trabalho do Freshcaller e verifique a opção alternativa para contextos desconhecidos.

O ticket não possui um resumo final.

Verifique se o provedor gera o resumo após a criação do ticket; teste um gatilho de atualização em vez de presumir que um evento de novo ticket contenha todas as informações.

Notas privadas duplicadas.

Restrinja o filtro de automação, verifique quais atualizações de tickets fazem com que ele seja acionado e mantenha o evento piloto separado do tráfego de produção.

A estimativa de custo está muito baixa.

Some o tempo total de linha do Freshcaller, as taxas de uso, os custos dos números, os minutos de IA do provedor e quaisquer taxas de licença ou de capacidade. Não considere os minutos de IA como a única duração faturável.

Conclusão

A configuração confiável da IA de voz do Freshdesk consiste em um repasse em etapas: o Freshcaller é responsável pelo número e pelo encaminhamento, o provedor é responsável pela conversa e o Freshdesk é responsável pelo ticket e pelo acompanhamento. Instale por meio do caminho compatível no Marketplace, use a chave da API de telefone, mapeie contextos exatos a ações explícitas, atribua o fluxo de trabalho a um número de teste e verifique o ticket antes de ativar qualquer automação de resposta. Use GlobalGPT para revisão de texto fictício, não como prova de que ocorreu uma transferência de chamada ou um registro no Freshdesk.

Analise uma lista de verificação fictícia para o pós-plantão no GlobalGPT antes do seu próximo teste autorizado do Freshcaller.

Perguntas frequentes

O Freshdesk é o sistema de telefonia nessa configuração?

Não. O Freshcaller é responsável pelo número de telefone, pelo IVR e pelo roteamento de chamadas. O Freshdesk é onde se analisa o contexto dos tickets e se realiza o acompanhamento.

Posso usar uma conta independente já existente do Synthflow?

A documentação sobre a integração do Synthflow com o Freshworks indica que a conta deve ser criada por meio do fluxo do Freshworks Marketplace. A migração de contas independentes não é suportada.

Qual chave de API a integração precisa?

Use a chave do Freshcaller na seção **Detalhes da API para telefone**, e não a chave do CRM ou do chat. Insira o domínio do Freshworks no formulário de integração.

Como o recurso de transferência de chamadas do Agente de IA por Voz decide para onde encaminhar uma chamada?

O provedor envia um contexto configurado. O Freshcaller associa esse contexto a uma ação, como uma fila, IVR, correio de voz, outro agente, automação de roteamento ou desligamento, com uma opção alternativa para contextos desconhecidos.

O Freshcaller continua cobrando após uma transferência para a IA?

A Freshworks afirma que a Freshcaller cobra pelo tempo total em que a linha telefônica permanece ativa, incluindo o tempo atendido por um agente humano. A operadora de serviços de voz fatura separadamente o tempo em que o atendimento é feito pela IA.

Cada chamada concluída irá gerar um ticket completo no Freshdesk?

Não presuma isso. Verifique quando o ticket é criado, quais campos e notas são inseridos e quando o resumo final ou o registro fica disponível.

Compartilhe a postagem:

Publicações relacionadas