Integrando Fin Voice com CXone usando encaminhamento de chamadas

Nota: Fin Voice está atualmente limitado a clientes selecionados em parceria com nossa equipe de Vendas. É suportado em workspaces hospedados nos EUA, UE e Austrália. Se desejar saber mais sobre preços, entre em contato com seu Gerente de Conta. Esperamos tornar Fin Voice mais amplamente disponível em breve.

Este guia ajuda você a conectar Fin Voice com sua conta CXone. Seguindo estes passos, você pode responder instantaneamente às chamadas dos clientes usando o conteúdo do seu Help Center, garantindo que questões complexas sejam encaminhadas perfeitamente para sua equipe humana com um resumo e transcrição completos gerados por AI.

Dica profissional: Esta integração usa a API do Intercom. Recomendamos que um colega técnico ou desenvolvedor auxilie na configuração do script no CXone Studio.

Como a integração funciona

Esta integração usa encaminhamento da Public Switched Telephone Network (PSTN) para rotear chamadas entre CXone e Intercom:

CXone → Fin Voice: CXone encaminha chamadas recebidas para um número dedicado Fin Voice comprado no Intercom.
Resolução Fin Voice: Fin responde instantaneamente, usando seu Help Center para resolver o problema.
Fin Voice → CXone: Se Fin não conseguir resolver a chamada, ela encaminha o chamador de volta para um número dedicado de escalonamento CXone.
Transferência de contexto: CXone Studio usa a API do Fin Voice para recuperar o resumo da chamada e a transcrição para seus colegas.

Antes de começar

Certifique-se de atender aos seguintes requisitos:

Requisito	Descrição
Intercom Workspace	Fin Voice habilitado e hospedado nas regiões dos EUA, UE ou AU.
Acesso de administrador	Necessário tanto para Intercom quanto para CXone para gerenciar roteamento e tokens de API.
Knowledge Base	Conteúdo atualizado do Help Center para referência do Fin.
Números CXone	Números ativos para roteamento principal de chamadas recebidas para encaminhar chamadas para Fin e uma linha dedicada de escalonamento para receber chamadas do Fin.

1. Teste o Fin Voice

Antes de entrar no ar, use o painel de visualização para simular chamadas no seu navegador.

Vá para Fin AI Agent > Deploy > Voice.
No painel de visualização à direita, clique em Iniciar chamada e comece a falar para ouvir as respostas do Fin.
Clique em ••• no cabeçalho do painel de visualização e selecione Configurações para alterar o idioma, sotaque e gênero, ou visualizar cumprimentos e regras de escalonamento.

2. Crie uma linha Fin Voice

Para passar do teste para uma linha ativa, você deve comprar um número dedicado dentro do Intercom.

Navegue até Fin AI Agent > Deploy > Voice > Ativar Fin ao vivo.
Clique em + Nova linha.
Selecione Provedor externo e clique em Próximo.
Nomeie sua linha, selecione De um número de telefone (PSTN) e clique em Próximo.
Clique em Comprar para adquirir um número local dos EUA.

3. Configure gravações e comportamento

Ative as Ferramentas de Contexto

Para permitir que os colegas vejam o que aconteceu durante a parte AI da chamada, ative as configurações globais:

Vá para Configurações > Canais > Telefone.
Ative Habilitar gravações, Transcrições e Resumos de transcrição de chamadas.

Personalize as Configurações do Fin

Na aba Ativar Fin ao vivo, você pode ajustar como o Fin se comporta:

Horário de atendimento: Defina quando o Fin deve atender (padrão é 24/7).
Idioma, sotaque e gênero: Escolha o idioma, sotaque e gênero que o Fin usa.
Conteúdo de suporte: Selecione quais artigos do Help Center o Fin deve consultar.
CSAT: Ative avaliações por teclado (1–5) para chamadas resolvidas.

4. Gere o Token de Acesso da API do Intercom

Para permitir que o CXone se comunique com o Fin, você precisa de um token privado da API.

No Intercom, crie um app privado do Intercom no seu Developer Hub.
Defina a versão da API para Unstable.
Copie o Access Token — você precisará disso para os scripts no CXone.

5. Configure a Campanha e as Skills no CXone

Você precisa de uma campanha e três skills específicas (filas) para gerenciar a lógica de roteamento.

Crie a campanha

No CXone, vá para ACD > Contact Settings > Campaigns.
Crie uma nova campanha chamada Fin Voice.
Defina o status como On.

Crie as skills

Vá para ACD > Contact Settings > ACD Skills e crie essas três skills:

Skills	Tipo de Mídia	Entrada/Saída	Campanha	Screen Pops
Encaminhar para a Skill Fin	Chamada Telefônica	Entrada	Fin Voice	Marcado
Chamada da Skill Fin	Chamada Telefônica	Entrada	Fin Voice	Marcado
Agentes humanos	Chamada Telefônica	Entrada	Fin Voice	Marcado

Crie a skill Agentes humanos

Atribua users à skill Agentes humanos

Depois que a skill "Agentes humanos" for criada, você deve adicionar os colegas que atenderão as chamadas escaladas.

Clique na aba Users dentro da skill "Agentes humanos".
Procure os colegas relevantes e selecione-os.
Clique em Add Users.

6. Crie o Script "Encaminhar para Fin"

Este script registra a chamada com a API Intercom e transfere o áudio para o Fin.

Abra o Studio e crie um novo script chamado Forward to Fin Script.

Adicione um bloco Snippet conectado ao Begin. Cole o código a seguir para configurar os cabeçalhos e corpo da API:


// 1. Setup the Headers 
DYNAMIC authHeader 
authHeader.Authorization = "Bearer {{Intercom API Access Token}}" ASSIGN jsonHeaderString = "{authHeader.asJSON()}"  

// 2. Setup the Parameters 
DYNAMIC queryParams 
params.call_id = ContactId 
params.phone_number = ANI  

// Convert to JSON string 
ASSIGN jsonParamString = "{params.asJSON()}"

Adicione um bloco Rest Api Action e configure-o:
- Endereço do serviço: https://api.intercom.io/fin_voice/register
- Verbo: POST
- Cabeçalhos: {jsonHeaderString}
- Parâmetros: {jsonParamString}
Adicione um bloco Transfer conectado ao ramo de sucesso:
- Destino: Insira o número de telefone provisionado no Intercom que o Fin atende.
- ID do chamador: {ANI} (Isso passa o número do cliente para o Fin).

7. Crie o Script "Chamada da Fin"

Este script aceita a chamada de retorno do Fin, busca o resumo da conversa e a direciona para um colega.

Crie um novo script chamado Call from Fin Script.

Adicione um bloco Snippet conectado ao Begin para configurar o cabeçalho de autenticação:


// 1. Setup the Headers 
DYNAMIC authHeader 
authHeader.Authorization = "Bearer {{Intercom API Access Token}}" ASSIGN jsonHeaderString = "{authHeader.asJSON()}"

Adicione um bloco Rest Api Action para buscar os dados da chamada:
- Service address: https://api.intercom.io/fin_voice/phone_number/{ANI}
- Verb: GET
- Headers: {jsonHeaderString}
- Result Set: collectResponse
Adicione um segundo bloco Snippet para extrair o resumo:
```
ASSIGN callSummary = collectResponse.call_summary
```
Adicione um bloco Assign para exibir o resumo para o colega de equipe:
- Variable: fin_call_summary
- Value: {callSummary}
- ScreenPop: Ligado
Adicione um bloco Reqagent para direcionar a chamada:
- Skill: Agentes humanos
- Screen Pop Source: Padrão

8. Atribuir Pontos de Contato

Finalmente, mapeie seus números de telefone para os scripts que você acabou de criar.

Note: Você precisará de dois números dedicados do seu gerente de conta CXone para esta etapa: um para forward calls to Fin e outro para receive calls from Fin.

Navegue até ACD > Contact Settings > Points of Contact e configure os dois números que você solicitou ao seu gerente de conta.

1. Forward to Fin Number

Name: Forward to Fin
Skill: Forward to Fin Skill
Script: Forward to Fin Script

2. Call from Fin Number

Name: Call from Fin
Skill: Call from Fin Skill
Script: Call from Fin Script

Verificação

Para testar a integração:

Disque o número Forward to Fin.
Fin deve atender usando o conteúdo do seu Help Center.
Solicite falar com um colega de equipe. Fin deve encaminhar a chamada para o número Call from Fin.
A chamada será direcionada para um colega de equipe na habilidade Human agents. Você pode verificar os detalhes da chamada no relatório Contact History. O relatório Contact History está disponível em relatórios pré-construídos.
O colega de equipe verá o fin_call_summary na tela dele.