Esta página documenta as etapas necessárias para configurar um projeto Google Cloud para integração de telefonia.
Selecione ou crie um projeto do Google Cloud
Os troncos 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 vai falhar.
Recomendamos que um projeto diferente seja usado exclusivamente para gerenciar troncos SIP. Isso permite que uma equipe diferente seja responsável pelos troncos e, na interface do usuário do tronco, ela pode 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 . Ele 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 os 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.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Permissões
- No console do Google Cloud , acesse IAM e administrador -> IAM.
- Selecione uma conta de serviço atual ou crie uma nova e verifique se ela tem a função
Dialogflow API Adminatribuída. Essa função é necessária para a integração de telefonia.
Acesso à API Phone Number
O uso dos métodos da API Phone Number requer 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
Nesta seção, você vai aprender a criar um perfil de conversa de IA conversacional com um número de telefone associado da plataforma de telefonia do Google (GTP, na sigla em inglês).
- Navegue até 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 ID do projeto Google Cloud que você quer associar à integração. Seus projetos atuais podem ser encontrados no menu suspenso na parte de cima da página do Console do Cloud. - Insira a região escolhida no campo
REGION. Todas as regiões do Dialogflow são aceitas. - Deixe o campo
JWTcomo está ou insira seu valor deJWTaqui. 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 de código. Quando solicitado, permita que o notebook acesse suas credenciais do Google.
- Expanda a seção Configurar a IA conversacional 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 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 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 seu número de telefone do GTP.CX_AGENT_NAME: insira o nome do agente de conversação (Dialogflow CX) a que você quer associar o 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 aoGoogle Cloud projeto correto e se ele foi atualizado para a edição Essentials. - Acesse o
console do Assistente de agente.
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 seu agente de conversa (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 dos agentes de conversação (Dialogflow CX) vêm com cotas padrão disponíveis. Se você não estiver usando o Dialogflow, por exemplo, apenas o Assistente de agente, a transcrição ou a gravação de chamadas, sua cota padrão será a mesma do Dialogflow ES Essentials.
Se necessário, você pode 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 testes, mas os aplicativos de tempo de execução exigem um aumento. Consulte a página de cotas do Dialogflow para detalhes e instruções sobre como solicitar um aumento.
(Opcional) Ativar o registro de auditoria para a 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. Assim, você pode conferir todas as chamadas individuais da API Conversational AI feitas e as credenciais usadas para autorização e consumo. Isso pode ser útil para solucionar problemas e depurar.
A seguir
Saiba como configurar um SBC.