Esta página documenta as etapas necessárias para configurar um Google Cloud projeto para integração de telefonia.
Selecionar ou criar um Google Cloud projeto
Os entroncamentos SIP são conectados a um projeto apenas por motivos de comunicação, mas o impacto deles não se limita a um projeto específico.
Por exemplo, você pode ter três projetos diferentes (desenvolvimento, teste e produção). Se o mesmo entroncamento SIP for usado para toda a comunicação SBC para GTP, apenas a primeira solicitação para criar o entroncamento SIP será bem-sucedida, e o restante das solicitações para criar o entroncamento SIP na mesma região/nome de host falhará.
Recomendamos que um projeto diferente seja usado com o único propósito de gerenciar entroncamentos SIP. Isso permite que uma equipe diferente seja responsável pelos entroncamentos e, na interface do usuário do entroncamento, eles possam 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 Google Cloud console do, na página do seletor de projetos, escolha ou crie um Google Cloud projeto do.
Papéis necessários para selecionar ou criar um projeto
- Selecionar um projeto: a seleção de um projeto não exige um papel específico do IAM. Você pode selecionar qualquer projeto em que tenha recebido um papel.
-
Criar um projeto: para criar um projeto, você precisa do papel de criador de projetos
(
roles/resourcemanager.projectCreator), que contém aresourcemanager.projects.createpermissão. Saiba como conceder papéis.
Permissões
- No console do Google Cloud, acesse IAM e administrador -> IAM. Google Cloud
- Selecione uma conta de serviço atual ou crie uma nova e verifique se ela tem o papel
Dialogflow API Adminatribuído. Esse papel é necessário para a integração de telefonia.
Acesso à API Phone number
O uso dos métodos da API Phone number exige acesso especial. Entre em contato com o representante do Google para mais informações.
Configurar o Dialogflow, o perfil de conversa e o número de telefone
Esta seção orienta você no processo de criação de um perfil de conversa de IA de conversação com um número de telefone associado da Google Telephony Platform (GTP, na sigla em inglês).
- Acesse o Colab Enterprise Se solicitado, ative as APIs Compute Engine, Dataform e Vertex.
- Clique em Importar notebooks e selecione URL como a fonte de dados. Insira este URL do repositório do GitHub, e clique em IMPORT.
- No campo
PROJECT_ID, insira o Google Cloud ID do projeto que você quer associar à integração. Seus projetos atuais podem ser encontrados no menu suspenso na parte de cima da página no console do Cloud. - Insira a região escolhida no campo
REGION. Todas as regiões do Dialogflow são aceitas. - Deixe o campo
JWTno estado em que se encontra ou insira o valorJWTaqui. Se deixado em branco, o SSO será usado por padrão. - Clique no botão de reprodução na seção Projeto na parte de cima para executar essa seção do código. Quando solicitado, permita que o notebook acesse suas credenciais do Google.
- Expanda a seção Configurar a IA de conversação para SIP/SIPREC. Em Criar um agente de teste do Dialogflow ES..., clique em Mostrar código e execute o código sem fazer alterações. Isso cria um agente de teste do Dialogflow ES e define o nível dele como Enterprise. Um agente de teste do Dialogflow ES é necessário para acessar os endpoints da API Dialogflow. Cada Google Cloud projeto pode ter um único agente do Dialogflow ES.
- Expanda para mostrar 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 o seu.SECURITY_SETTINGS: pode ser qualquer string. Você pode usar o valor padrão ou inserir o seu.PHONE_NUMBER_COUNTRY_CODE: insira o código do país que você quer associar ao número de telefone do GTP.CX_AGENT_NAME: insira o nome do agente 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 Configurações para verificar se o agente está associado ao Google Cloud projeto correto e se ele foi atualizado para a edição Essentials. - Acesse o
console do Agent Assist.
Clique em Perfis de conversa no menu à esquerda 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 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, por exemplo, apenas o Agent Assist, a transcrição ou a gravação de chamadas, sua cota padrão será a mesma da cota do Dialogflow ES Essentials.
Você tem a opção de solicitar um aumento de cota, se necessário, 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 execução exigem um aumento. Consulte a página de cotas do Dialogflow para ver detalhes da cota e instruções para solicitar um aumento.
(Opcional) Ativar o registro de auditoria da API Dialogflow
Você pode ativar opcionalmente o registro de auditoria para a API Dialogflow (dialogflow.googleapis.com) para leitura de administrador, leitura de dados e gravação de dados. Isso permite que você veja todas as chamadas individuais da API de IA de conversação feitas e as credenciais usadas para autorização e consumo. Isso pode ser útil para solução de problemas e depuração.
A seguir
Saiba como configurar um SBC.