
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:
- Freshcaller: números de telefone, chamadas recebidas, IVR, ações durante o horário comercial e roteamento.
- Provedor de voz: conversa, reconhecimento de fala, respostas, instruções ao agente e contexto de transferência.
- 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
Envie uma solicitação verificada relacionada a cobrança para o Suporte de Cobrança
solicitações_do_chamador_para_atendimento_humano
Deixe que quem ligar escolha o time certo
fora do horário comercial
Registrar uma mensagem fora do horário comercial
precisa-se de especialista
Aplicar uma regra de roteamento existente
agente_incerto
Mude para um fluxo mais restrito
contexto_desconhecido
Entrar em modo de falha segura quando o contexto estiver ausente
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:
- Escolha o horário de funcionamento.
- Definir Ação durante o horário comercial para Enviar para o agente de IA de voz.
- Selecione o agente de atendimento por voz desejado e o fluxo de trabalho exato para o repasse.
- 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:
| Plano | Preço anual do assento | Minutos de chamadas recebidas incluídos por conta/mês | Características notáveis da voz |
|---|---|---|---|
| Gratuito | $0/agente/mês | Não há subsídio listado | Identificação básica de chamadas, notas, mensagens de saudação, métricas |
| Crescimento | $15/agente/mês | 2,000 | Portabilidade de números, filas de espera, correio de voz, transferências, gravação |
| Prós | $39/agente/mês | 3,000 | Automação de roteamento, conferências, escalonamentos inteligentes |
| Empresa | $69/agente/mês | 5,000 | IVR 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:
| Palco | O que verificar |
|---|---|
| Transferência de chamada de voz | A chamada chegou à fila humana pretendida ou ao plano alternativo documentado |
| Criação de ticket | Existe um ticket no Freshdesk com o contexto da chamada esperado |
| Qualidade do contexto | O status da identidade, a solicitação e os fatos não esclarecidos permanecem explícitos |
| Escopo da automação | Apenas o bilhete do piloto foi processado |
| Rascunho do destino | O acompanhamento aparece como uma nota interna confidencial |
| Resposta do cliente | O 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:
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.
A chave da API não passou na verificação.
A ligação é encaminhada para a equipe errada.
O ticket não possui um resumo final.
Notas privadas duplicadas.
A estimativa de custo está muito baixa.
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.








