Esta página documenta os passos necessários para configurar um Google Cloud projeto para a integração de telefonia.
Selecione ou crie um Google Cloud projeto
Os troncos SIP estão associados a um projeto apenas por motivos de comunicação, mas o respetivo impacto não se limita a um projeto específico.
Por exemplo, pode ter três projetos diferentes (programação, testes e produção). Se o mesmo ramal de SIP for usado para toda a comunicação de SBC para GTP, apenas o primeiro pedido para criar o ramal de SIP vai ser bem-sucedido, e os restantes pedidos para criar o ramal de SIP na mesma região/nome de anfitrião vão falhar.
Recomendamos que use um projeto diferente apenas para gerir troncos SIP. Isto permite que uma equipa diferente seja responsável pelos troncos e, na IU do tronco, pode estabelecer diferentes grupos de SBCs para desenvolvimento, testes e produção.
Para usar os serviços fornecidos pela Google Cloud, tem de criar um projeto. Um projeto organiza todos os seus Google Cloud recursos. Um projeto consiste num conjunto de colaboradores, APIs ativadas (e outros recursos), ferramentas de monitorização, informações de faturação, e controlos de autenticação e acesso. Pode criar um projeto ou criar vários projetos e usá-los para organizar os seus Google Cloud recursos numa hierarquia de recursos. Quando criar um projeto, tome nota do ID do projeto. Precisa deste ID para fazer chamadas API. Para mais informações sobre projetos, consulte a documentação do Resource Manager.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
Autorizações
- Na Google Cloud consola, navegue para IAM e administrador -> IAM.
- Selecione uma conta de serviço existente ou crie uma nova e certifique-se de que lhe é atribuída a função
Dialogflow API Admin. Esta função é necessária para a integração de telefonia.
Acesso à API de número de telefone
A utilização dos métodos da API de números de telefone requer acesso especial. Contacte o seu representante da Google para receber mais informações.
Configure o Dialogflow, o perfil de conversa e o número de telefone
Esta secção explica o processo de criação de um perfil de conversa de IA conversacional com um número de telefone da Google Telephony Platform (GTP) associado.
- Navegue para Colab Enterprise Se lhe for pedido, ative as APIs Compute Engine, Dataform e Vertex.
- Clique em Importar blocos de notas e, de seguida, selecione URL como origem de dados. Introduza este URL do repositório do GitHub e, de seguida, clique em IMPORT.
- No campo
PROJECT_ID, introduza o ID do projeto Google Cloud que quer associar à integração. Pode encontrar os seus projetos existentes no menu pendente na parte superior da página na Cloud Console. - Introduza a região escolhida no campo
REGION. Todas as regiões do Dialogflow são suportadas. - Deixe o campo
JWTcomo está ou introduza o valorJWTaqui. Se deixar em branco, o SSO é usado por predefinição. - Clique no botão de reprodução na secção Projeto superior para executar essa secção de código. Quando lhe for pedido, permita que o bloco de notas aceda às suas credenciais da Google.
- Expanda a secção Configurar a IA de conversação para SIP/SIPREC. Em Crie um agente fictício do Dialogflow ES..., clique em Mostrar código e execute o código sem fazer alterações. Esta ação cria um agente Dialogflow ES fictício e define o respetivo nível como Enterprise. É necessário um agente Dialogflow ES fictício para aceder aos pontos finais da API Dialogflow. Cada Google Cloud projeto pode ter um único agente do Dialogflow ES.
- Expanda para apresentar o código na secção Script para criar um
ConversationProfile....CONVERSATION_PROFILE_NAME: pode ser qualquer string. Pode usar o valor predefinido ou introduzir o seu próprio valor.SECURITY_SETTINGS: pode ser qualquer string. Pode usar o valor predefinido ou introduzir o seu próprio valor.PHONE_NUMBER_COUNTRY_CODE: introduza o código do país que quer associar ao seu número de telefone do GTP.CX_AGENT_NAME: introduza o nome do agente de agentes de conversação (Dialogflow CX) ao qual quer associar o perfil de conversa gerado.
- Execute o código. O resultado inclui o nome do
ConversationProfilegerado, as definições de segurança e o número de telefone do GTP. - Navegue para a consola do Dialogflow ES
para verificar se foi criado um agente com o nome
Dummy_ES_agent. Clique em Definições para verificar se o agente está associado ao Google Cloud projeto correto e se foi atualizado para a edição Essentials. - Navegue para a consola do Agent Assist.
Clique em Perfis de conversa no menu do lado esquerdo para verificar se foi criado um perfil de conversa com o
CONVERSATION_PROFILE_NAMEque introduziu. - Navegue para a consola de estatísticas de IA conversacional. Verifique se todas as transcrições de conversas associadas ao seu agente de conversa (Dialogflow CX) foram importadas.
(Opcional) Peça um aumento da quota para a duração das chamadas do Dialogflow CX Phone Gateway
As subscrições do Dialogflow ES Essentials e dos agentes de conversação (Dialogflow CX) incluem quotas padrão disponíveis. Se não estiver a usar o Dialogflow, por exemplo, apenas o Agent Assist, a transcrição ou a gravação de chamadas, a sua quota predefinida é igual à quota do Dialogflow ES Essentials.
Tem a opção de pedir um aumento da quota, se necessário, com base no seu tráfego estimado. Na maioria dos exemplos de utilização, a quota padrão é suficiente para a configuração e os testes, mas as aplicações de tempo de execução requerem um aumento. Consulte a página de quotas do Dialogflow para ver detalhes das quotas e instruções para pedir um aumento.
(Opcional) Ative o registo de auditoria para a API Dialogflow
Opcionalmente, pode ativar o registo de auditoria para a API Dialogflow (dialogflow.googleapis.com) para leitura de administrador, leitura de dados e escrita de dados. Ao fazê-lo, pode ver todas as chamadas individuais da API Conversational AI feitas e as credenciais usadas para autorização e consumo. Isto pode ser útil para resolver problemas e depurar.
O que se segue?
Saiba como configurar um SBC.