Este guia ajuda você a conectar Fin Voice, o agente AI da Intercom para suporte telefônico, com sua conta CXone. Seguindo estes passos, você pode responder chamadas de clientes instantaneamente usando o conteúdo do seu Help Center, garantindo que questões complexas sejam transferidas para sua equipe humana com um resumo e transcrição completos gerados por AI.
Dica profissional: Esta integração usa a API da 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 do Fin Voice comprado na 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, encaminha o chamador de volta para um número dedicado de escalonamento do CXone.
Transferência de contexto: CXone Studio usa a API do Fin Voice para recuperar o resumo e a transcrição da chamada para seus colegas.
Antes de começar
Certifique-se de atender aos seguintes requisitos:
Requisito | Descrição |
Intercom Workspace | Fin Voice ativado e hospedado nas regiões US, EU ou AU. |
Acesso de administrador | Necessário tanto para Intercom quanto para CXone para gerenciar roteamento e tokens da 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 a aba Voice Testing para simular chamadas no seu navegador.
Navegue até Fin AI Agent > Deploy > Phone > Voice testing.
Clique em Play e comece a falar para ouvir as respostas do Fin.
Use Settings (canto superior direito) para trocar vozes ou pré-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 da Intercom.
Navegue até Fin AI Agent > Deploy > Phone > Set Fin live.
Clique em + New line.
Selecione External Provider e clique em Next.
Nomeie sua linha, selecione From a phone number (PSTN) e clique em Next.
Clique em Purchase para adquirir um número local dos US.
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:
Ative Enable recordings, Transcripts e Call transcription summaries.
Personalize as Configurações do Fin
Na aba Set Fin live, você pode ajustar como o Fin se comporta:
Horário de atendimento: Defina quando o Fin deve atender (padrão é 24/7).
Voz e idioma: Escolha uma voz que combine com sua marca.
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 da 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 da Intercom no seu Developer Hub.
Defina a versão da API para Unstable.
Copie o Access Token—você precisará dele para os scripts no CXone.
5. Configure a Campanha e as Skills do 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 | Media Type | Inbound/Outbound | Campaign | Screen Pops |
Forward to Fin Skill | Phone Call | Inbound | Fin Voice | Marcado
|
Call from Fin Skill | Phone Call | Inbound | Fin Voice | Marcado
|
Human agents | Phone Call | Inbound | Fin Voice | Marcado
|
Crie a skill Human agents
Atribua users à skill Human agents
Uma vez que a skill "Human agents" esteja criada, você deve adicionar os colegas que responderão às chamadas escaladas.
Clique na aba Users dentro da skill "Human agents".
Procure os colegas relevantes e selecione-os.
Clique em Add Users.
6. Crie o Script "Forward to Fin"
Este script registra a chamada com a API do 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 o 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:
Service address:
https://api.intercom.io/fin_voice/registerVerb: POST
Headers:
{jsonHeaderString}Parameters:
{jsonParamString}
Adicione um bloco Transfer conectado ao ramo de sucesso:
Destination: Insira o número de telefone provisionado no Intercom que o Fin atende.
Caller ID:
{ANI}(Isso passa o número do cliente para o Fin).
7. Crie o Script "Call from 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:
Endereço do serviço:
https://api.intercom.io/fin_voice/phone_number/{ANI}Verbo: GET 27
Headers:
{jsonHeaderString}Conjunto de resultados:
collectResponse
Adicione um segundo bloco Snippet para extrair o resumo:
ASSIGN callSummary = collectResponse.call_summaryAdicione um bloco Assign para exibir o resumo para o colega de equipe:
Variável:
fin_call_summary
Valor:
{callSummary}ScreenPop: Ligado
Adicione um bloco Reqagent para direcionar a chamada:
Skill: Agentes humanos
Fonte do Screen Pop: Padrão
8. Atribuir Pontos de Contato
Por fim, mapeie seus números de telefone para os scripts que você acabou de criar.
Nota: Você precisará de dois números dedicados do seu gerente de conta CXone para esta etapa: um para encaminhar chamadas para Fin e outro para receber chamadas de Fin.
Navegue até ACD > Configurações de Contato > Pontos de Contato e configure os dois números que você solicitou ao seu gerente de conta.
1. Encaminhar para o número Fin
Nome: Encaminhar para Fin
Skill: Skill de encaminhar para Fin
Script: Script de encaminhar para Fin
2. Número de chamada de Fin
Nome: Chamada de Fin
Skill: Skill de chamada de Fin
Script: Script de chamada de Fin
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 skill 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.
