Esta página foi traduzida pela API Cloud Translation.

Integração de voz do Salesforce com o Twilio Flex

Essa integração de voz usa a integração do Twilio Open CTI para trazer um call center do Twilio Flex para sua instância do Salesforce.

O Agent Assist usa o fluxo de mídia da chamada do Twilio Flex para dar sugestões aos agentes no Salesforce Lightning Service Console.

Antes de começar

Para integrar os módulos da interface da Assistente de IA ao Salesforce, você precisa de acesso aos seguintes recursos:

Node.js

Siga as instruções de instalação recomendadas para seu sistema operacional.
CLI do Salesforce

Siga as instruções de instalação recomendadas para seu sistema operacional.
CLI do Google Cloud

Instale o comando gcloud conforme as instruções e faça a autenticação usando gcloud auth login.
Salesforce
1. Faça login no URL da sua instância ou na página de login do Salesforce e observe o seguinte:
2. O URL do Meu domínio do Salesforce. Siga estas etapas para encontrar o URL do meu domínio:
  1. Navegue até a barra de menus > menu Configuração.
  2. Clique em Configurar.
  3. Na caixa Pesquisa rápida, digite Meu domínio. O nome de domínio está no seguinte formato: MY-DOMAIN-NAME.develop.my.salesforce.com.
3. Seu ID da organização do Salesforce. Siga estas etapas para encontrar o ID da organização:
  1. Navegue até a barra de menus > menu Configuração.
  2. Clique em Configurar.
  3. Na caixa Pesquisa rápida, digite Informações da empresa. Observação: essas etapas de integração foram testadas apenas com a edição para desenvolvedores do Salesforce. Se você usar outra edição, poderá haver diferenças nas licenças de recursos e na interface do Salesforce.
Back-end de integração do Agent Assist
1. Siga as instruções para configurar a integração.
2. Antes de executar o script de implantação, configure as seguintes variáveis de ambiente com deploy.sh ou em um arquivo .env na raiz do projeto:
3. AUTH_OPTION: defina como SalesforceLWC.
4. SALESFORCE_DOMAIN: um nome de domínio semelhante a YOUR_SUBDOMAIN.develop.lightning.force.com. Você observou esse valor no pré-requisito do Salesforce. Não inclua https://.
5. SALESFORCE_ORGANIZATION_ID: você anotou esse valor no pré-requisito do Salesforce.
6. APP_AUTH_OPTION: defina como Twilio.
7. TWILIO_ACCOUNT_SID: defina como seu SID da conta do Twilio.

Etapa 1: configurar o Twilio Flex

O Twilio Flex serve como o softphone nessa integração. Faça login no console do Twilio para configurar uma conta do Flex. Acesse a página de configuração do Twilio para instruções detalhadas sobre como criar uma conta do Flex.

Instalar o complemento do conector SIPREC

Com o complemento do conector SIPREC, sua conta do Twilio Flex pode fazer forks SIPREC de fluxos de mídia de chamadas de voz para o Assistente de agente. Siga estas etapas para instalar o complemento do conector SIPREC.

Acesse Página inicial do Twilio > Marketplace > Catálogo > Twilio > Conector Siprec.
Clique em Instalar > a caixa de seleção Confirmação dos termos e condições > Instalar.
Na guia Configurar, configure o plug-in da seguinte maneira:
1. Nome exclusivo: SipRec1
2. Servidor de gravação de sessão:
```
sip:+<GTP-provisioned-phone-number>@216.239.36.145:5672;transport=tls;secure=true;edge=umatilla
```
3. Consulte a documentação de integração de telefonia para mais detalhes sobre o provisionamento de um número GTP. Você pode ignorar as etapas de configuração e validação do SBC porque elas estão concluídas para o conector Siprec da Twilio.
Acesse Página inicial do Twilio > Funções e recursos.
- Se Funções e recursos não estiver visível na barra lateral, fixe-o em Conheça os produtos.
Clique em Criar serviço.
Nomeie o novo serviço como ui-connector-auth.
No editor que aparece, clique em Adicionar + > Adicionar função.
Nomeie a função como conversation-name.
Clique em e mude a visibilidade da função para Pública.
Copie e cole todo o conteúdo de ui-connector-auth.js do repositório do GitHub no editor.
Clique em Salvar.
Clique em Implantar tudo.

Configurar a URA com o Flex Studio

A URA consiste em configurar um fluxo de chamadas programático com o Studio do Twilio para fazer o fork SIPREC do fluxo de mídia para o Agent Assist. Ele também faz uma postagem HTTP para compartilhar o número de telefone e o ID da conversa com o Agent Assist. Siga estas etapas para configurar a URA com o Flex Studio.

Navegue até o console da Twilio.
Clique em Desenvolver > Números de telefone > Gerenciar > Números ativos. Deve haver uma linha na tabela com o número padrão do Twilio provisionado para sua conta do Flex.
Na seção Voz – fluxo de trabalho do Studio, clique em Resposta de voz interativa.
Arraste um widget Fazer solicitação HTTP para o fluxo.
Desconecte Incoming Call da entrada do widget SendCallToAgent.
Conecte Chamada recebida à entrada do widget Fazer solicitação HTTP.
Configure o widget Fazer solicitação HTTP com os seguintes detalhes:
- Nome do widget: register_twilio
- Método de solicitação: POST
- URL da solicitação: <your-ui-connector-cloud-run-url>.run.app/register-app
- Tipo de conteúdo: application/json
- Corpo da solicitação:
```
{
"accountSid": "<yourTwilioAccountSid>",
"authToken": "<yourTwilioAccountAuthToken>"
}
```
Arraste um widget Executar função para o fluxo.
Conecte as saídas Success e Fail do widget register_twilio à entrada do widget Run Function.
Crie um widget com os seguintes detalhes:
- Nome do widget: conversation_name
- Serviço: ui-connector-auth
- Ambiente: ui
- Função: conversation-name
- Parâmetros da função:
  - token:
```
{{ widgets.register_twilio.parsed.token }}
```
  - endpoint: <your-ui-connector-cloud-run-url>.run.app/conversation-name
  - phone:
```
{{ trigger.call.From | replace_first:'+','' }}
```
  - conversationName:
```
projects/<project>/locations/<location>/conversations/TW-{{ trigger.call.From | replace_first:'+','' }}-{{ trigger.call.CallSid }}
```
Arraste um widget Fork Stream da barra lateral para o fluxo.
Conecte as saídas Sucesso e falha do widget Fazer solicitação HTTP à entrada do widget Bifurcar stream.
Conecte o nó Próximo do widget Bifurcar stream ao widget SendCallToAgent.
Configure o widget Fork Stream da seguinte maneira:
- Ação de stream: iniciar
- Tipo de transmissão: Siprec
- Nome do conector: Siprec1
- Opções: ambas as opções
- Parâmetros de evento:
  - Chave: conversation
  - Valor:
```
projects/<gcp-project-id>/conversations/TW-{{trigger.call.From | replace_first:'+','' }}-{{trigger.call.CallSid}}
```
Clique em Salvar > Publicar.

Detalhes da conta

Siga esta etapa para coletar os detalhes da sua conta do Twilio Flex. Você vai precisar dessas informações para configurar a CTI do Flex no Salesforce mais tarde.

Acesse Twilio Home > Painel da conta e anote as seguintes informações:
- SID da conta
- Meu número de telefone do Twilio

Etapa 2: configurar seu projeto de desenvolvimento

Para começar a integrar módulos da interface da Assistente de IA, siga estas etapas.

Execute o código a seguir para clonar o repositório de integração do Agent Assist e abrir seu projeto:
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd salesforce/aa-lwc
```
Execute os comandos a seguir para fazer o download dos arquivos JavaScript dos módulos da interface, que você vai implantar mais tarde como recursos estáticos. O Salesforce exige recursos estáticos para carregar JavaScript de terceiros.
```
npm run generate-static-resources
npm install
```

Etapa 3: configurar seu ambiente do Salesforce

É possível integrar módulos da interface da Assistente de IA em um ambiente específico, como produção ou desenvolvimento. O Salesforce chama esses ambientes de organizações (orgs).

Configurar sua organização com a CLI do Salesforce

Siga estas etapas para usar a CLI do Salesforce e configurar sua organização para a integração com o Assistente de IA.

Execute o código a seguir e autentique a CLI usando os detalhes de login do Salesforce que você usa normalmente.
```
npm run login
```
Execute o código a seguir para implantar o LWC na organização.
```
npm run deploy
```

Etapa 4: criar um app cliente externo

O LWC do Salesforce usa o fluxo de credenciais do cliente OAuth 2.0 para autenticar você. Um app cliente externo permite o fluxo de credenciais do cliente. Use a chave e o segredo do consumidor do app para configurar o LWC do Salesforce e autenticar usuários com o Salesforce.

Acesse a barra de menus > menu Configuração e clique em Configuração. Na caixa Pesquisa rápida, digite Gerenciador de apps de clientes externos.
1. Clique em Gerenciador de apps clientes externos > Novo app cliente externo > Criar e insira as seguintes informações.
2. Nome do app cliente externo: lwc auth
3. Nome da API: lwc_auth
4. E-mail de contato: your_email@example.com
5. API (ativar configurações do OAuth) > Ativar OAuth: selecionado
6. API (ativar configurações do OAuth) > URL de retorno de chamada: https://login.salesforce.com/services/oauth2/callback
7. API (ativar configurações do OAuth) > Escopos do OAuth selecionados: acesse o serviço de URL de identidade.
8. API (ativar configurações do OAuth) > Ativar fluxo de credenciais do cliente: selecionado
9. Clique em Criar.
Acesse a barra de menus > menu Configuração e clique em Configuração. Na caixa Pesquisa rápida, digite Gerenciador de apps de clientes externos.
1. Clique no nome do app cliente externo > Editar.
2. Acesse Políticas do OAuth > Fluxos do OAuth e melhorias no app cliente externo.
3. Verifique se a opção Ativar o fluxo de credenciais do cliente está selecionada.
4. Em Executar como, insira seu nome de usuário de login.
5. Clique em Salvar.
Acesse a barra de menus > menu Configuração e clique em Configuração. Na caixa Pesquisa rápida, digite Gerenciador de apps de clientes externos.
1. Clique no nome do app cliente externo > Editar.
2. Acesse Configurações do OAuth > Configurações do app > Chave e segredo do consumidor.
3. Digite o código de verificação enviado para seu e-mail.
4. Copie a chave e o secret do consumidor em um lugar seguro. Você vai precisar deles em uma etapa posterior.

Estabelecer políticas de segurança de conteúdo e CORS

Acesse a barra de menus > menu "Configuração" e clique em Configuração.
Na caixa Pesquisa rápida, digite CORS e clique em Editar.
1. Selecione Ativar o CORS para endpoints OAuth.
2. Clique em Salvar.
Acesse a barra de menus > menu "Configuração" e clique em Configuração.
Na caixa Pesquisa rápida, digite URLs confiáveis e clique em Novo URL confiável.
Insira o Nome da API: ui_connector
1. Insira o URL do endpoint do serviço do Cloud Run do conector da interface que você implantou com o back-end de integração do Assistente de IA. O URL está no console do Cloud Run. Por exemplo: https://<var>UI_CONNECTOR_SUBDOMAIN</var>.<var>GCP_REGION</var>.run.app.
2. Marque todas as caixas de seleção em Diretivas de CSP.
3. Clique em Salvar e novo.
Insira o Nome da API: ui_connector_wss
1. Insira o URL do endpoint do serviço do Cloud Run do conector da interface que você implantou com o back-end de integração do Assistente de IA. O URL está no console do Cloud Run. Mude o protocolo para wss, para tráfego de WebSockets. Por exemplo: wss://<var>UI_CONNECTOR_SUBDOMAIN</var>.<var>GCP_REGION</var>.run.app.
2. Marque todas as caixas de seleção em Diretivas de CSP.
3. Clique em Salvar e novo.
Insira o Nome da API: salesforce_domain
1. Insira o URL do seu domínio do Salesforce no seguinte formato: https://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
2. Marque todas as caixas de seleção em Diretivas de CSP.
3. Clique em Salvar.

Etapa 5: instalar o plug-in CTI do Twilio Flex

O Salesforce oferece o Salesforce Open CTI (em inglês) para permitir a integração de softphones de terceiros com sua instância do Salesforce.

O Twilio Flex CTI usa o Salesforce Open CTI para permitir que você use o Flex diretamente na sua instância do Salesforce. Siga as instruções da Twilio para configurar a CTI do Twilio Flex na sua instância do Salesforce.

Etapa 6: instalar o componente da Web do Salesforce Lightning

Siga estas etapas para usar o Editor do Lightning Experience e adicionar o componente da Web do Salesforce Lightning à página de contato em que o Twilio Flex CTI é aberto quando uma nova chamada é recebida.

Navegue até o Console de serviços e selecione Contatos.
Selecione um registro de contato.
Clique no menu "Configuração" > Editar página.
Clique em Modelo > Mudar.
1. Selecione Cabeçalho e Duas regiões iguais.
2. Clique em Próxima.
3. Mapeie cada região para uma nova região.
4. Clique em Concluído.
Na barra lateral Componentes, mova o agentAssistContainerModule para a barra lateral. Observação: o comando npm deploy forneceu esse componente.
Clique no componente que você colocou na etapa anterior e preencha os campos do formulário da seguinte maneira para adicionar detalhes de configuração.
- endpoint: o URL do conector de interface do backend de integração. Por exemplo, um URL do console do Cloud Run, como: https://<var>UI_CONNECTOR_ENDPOINT</var>.<var>GCP_REGION</var>.run.app.
- recursos: Recursos do Agent Assist a serem incluídos. Eles precisam estar ativados no seu perfil de conversa. Alguns recursos disponíveis incluem CONVERSATION_SUMMARIZATION, KNOWLEDGE_ASSIST_V2 e AGENT_COACHING. Alguns recursos, como SMART_REPLY, não estão disponíveis para voice.
- channel: indica que a integração é para voice.
- platform: indique que a plataforma é twilio.
- conversationProfile: o nome do recurso do seu perfil de conversa do Agent Assist. Por exemplo, projects/<var>GCP_PROJECT_ID</var>/locations/<var>GCP_REGION</var>/conversationProfiles/<var>CONVERSATION_PROFILE_ID</var>
- consumerKey: a chave de consumidor do cliente externo da etapa 3.
- consumerSecret: a chave secreta do cliente externo da etapa 3.

Etapa 7: testar a integração

Você pode testar a integração de voz com uma chamada de teste para a central de atendimento do Salesforce.

Faça login no Twilio Flex pelo Service Console.
Ligue para seu número do Twilio Flex. Você anotou isso na etapa 1.
No Console de serviços, atenda a chamada. A tela vai abrir uma página de contato nova ou existente para o número que ligou.
Se for uma nova página de contato, salve o contato. Quando a página de contato for carregada, o componente da Web do Salesforce Lightning vai aparecer na barra lateral.
Teste os dois lados da conversa, garantindo que os recursos do Assistente do agente estejam funcionando conforme você os configurou.

Integração de voz do Salesforce com o Twilio Flex Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.