Neste documento, descrevemos as etapas necessárias para configurar um projeto doGoogle Cloud para integração de telefonia.
Selecione ou crie um projeto do Google Cloud .
Os entroncamentos SIP são conectados a um projeto apenas para fins de comunicação, mas o efeito deles não se limita a um projeto específico.
Por exemplo, é possível ter três projetos diferentes (desenvolvimento, teste, produção). Se o mesmo SIP trunk for usado para toda a comunicação entre o SBC e o GTP, somente a primeira solicitação para criar o SIP trunk será bem-sucedida, e as demais solicitações para criar o SIP trunk na mesma região e nome do host vão falhar.
É possível usar um projeto diferente com o único propósito de gerenciar SIP trunks. Isso permite que uma equipe diferente gerencie os troncos e, na UI do tronco, é possível estabelecer diferentes grupos de SBCs para desenvolvimento, teste e produção.
Para usar os serviços fornecidos pelo Google Cloud, crie um projeto. Um projeto organiza todos os seus recursos do Google Cloud . O projeto consiste em um conjunto de colaboradores, APIs ativadas (e outros recursos), ferramentas de monitoramento, informações de faturamento e controles de autenticação e acesso. Crie um ou vários projetos e use-os para organizar seus recursos do Google Cloud em uma hierarquia de recursos. Ao criar um projeto, anote o ID do projeto. Você precisará desse ID para fazer chamadas de API. Para mais informações sobre projetos, consulte a documentação do Resource Manager.
No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .
Papéis necessários para selecionar ou criar um projeto
- Selecionar um projeto: para selecionar um projeto, não é necessário ter um papel do IAM específico. É possível selecionar qualquer projeto em que você tenha um papel.
-
Criar um projeto: para criar um projeto, é preciso ter o papel de Criador de projetos
(
roles/resourcemanager.projectCreator), que contém a permissãoresourcemanager.projects.create. Saiba como conceder papéis.
Permissões
- No console do Google Cloud , acesse IAM e administrador > IAM.
- Selecione uma conta de serviço atual ou crie uma nova e atribua o papel
Dialogflow API Admina ela. Esse papel é necessário para a integração de telefonia.
Acesso à API de número de telefone
O uso dos métodos da API de número de telefone requer acesso especial. Entre em contato com seu representante do Google para mais informações.
Configurar o Dialogflow, o perfil de conversa e o número de telefone
Nesta seção, descrevemos como criar um perfil de conversa da IA de conversação com um número de telefone associado da plataforma de telefonia do Google (GTP, na sigla em inglês).
- Acesse o Colab Enterprise. Se solicitado, ative as APIs Compute Engine, Dataform e Vertex.
- Selecione Importar notebooks e escolha URL como a fonte de dados. Insira o URL do repositório do GitHub e selecione Importar.
- No campo
PROJECT_ID, insira o ID do projeto do Google Cloud que você quer associar à integração. Encontre seus projetos no menu na parte de cima da página no console doGoogle Cloud . - Insira a região escolhida no campo
REGION. Todas as regiões do Dialogflow são compatíveis. - Deixe o campo
JWTcomo está ou insira o valor deJWTaqui. Se deixado em branco, o SSO será usado por padrão. - Clique no botão de reprodução na seção Project na parte de cima para executar essa seção do código. Quando solicitado, permita que o notebook acesse suas credenciais do Google.
- Abra a seção Configurar a IA de conversação para SIP/SIPREC. Em Criar um agente fictício do Dialogflow ES..., clique em Mostrar código e execute o código sem fazer alterações. Isso cria um agente fictício do Dialogflow ES e define o nível dele como Enterprise. É necessário um agente fictício do Dialogflow ES para acessar os endpoints da API Dialogflow. Cada projeto do Google Cloud pode ter um único agente do Dialogflow ES.
- Expanda para exibir o código na seção Script para criar um
ConversationProfile....CONVERSATION_PROFILE_NAME: pode ser qualquer string. Você pode usar o valor padrão ou inserir um valor próprio.SECURITY_SETTINGS: pode ser qualquer string. Você pode usar o valor padrão ou inserir um valor próprio.PHONE_NUMBER_COUNTRY_CODE: insira o código do país que você quer associar ao seu número de telefone do GTP.CX_AGENT_NAME: insira o nome do agente de CX do Dialogflow CX que você quer associar ao perfil de conversa gerado.
- Execute o código. A saída vai incluir o nome do
ConversationProfilegerado, as configurações de segurança e o número de telefone do GTP. - Acesse o console do Dialogflow ES para
verificar se um agente chamado
Dummy_ES_agentfoi criado. Clique em Configurações para verificar se o agente está associado ao projeto Google Cloud correto e se foi feito upgrade para a edição Essentials. - Acesse o
console do Agent Assist.
Clique em Perfis de conversa no menu de navegação para verificar se um perfil de conversa com o
CONVERSATION_PROFILE_NAMEinserido foi criado. - Acesse o console do Conversational AI Insights. Verifique se todas as transcrições de conversa associadas ao seu agente do Dialogflow CX foram importadas.
(Opcional) Solicitar um aumento de cota para a duração da chamada do gateway telefônico do Dialogflow CX
As assinaturas do Dialogflow ES Essentials e do Dialogflow CX vêm com cotas padrão disponíveis. Se você não estiver usando o Dialogflow, como apenas o Agent Assist, a transcrição ou a gravação de chamadas, sua cota padrão será igual à cota do Dialogflow ES Essentials.
Se necessário, é possível solicitar um aumento de cota com base no tráfego estimado. Na maioria dos casos de uso, a cota padrão é suficiente para configuração e teste, mas os aplicativos de ambiente de execução exigem um aumento. Consulte a página de cotas do Dialogflow para ver detalhes sobre cotas e instruções para solicitar um aumento.
(Opcional) Ativar a geração de registros de auditoria para a API Dialogflow
Para ativar a geração de registros de auditoria para a API Dialogflow (dialogflow.googleapis.com) para leitura de administrador, leitura de dados e gravação de dados, use esse recurso para ver todas as chamadas de API de IA de conversação individuais feitas e as credenciais usadas para autorização e consumo. Isso permite resolver problemas e depurar problemas de maneira mais eficaz.
A seguir
- Saiba como instalar e configurar um SBC.