Este documento ajuda você a configurar e validar o SBC.
Fornecedores e firmware compatíveis
Antes de iniciar a configuração, consulte a tabela de fornecedores ou modelos de SBC e versões de firmware compatíveis.
Protocolos de mídia e sinalização de SBC compatíveis
Encontre os protocolos de sinalização e mídia compatíveis na documentação de protocolos de sinalização e mídia do SBC.
Configuração de TLS do SBC
Solicite um certificado TLS para o SBC de um fornecedor de autoridade certificadora aprovado. Não há suporte para certificados curinga.
No certificado TLS, é preciso apresentar o nome de domínio totalmente qualificado (FQDN, na sigla em inglês) do SBC no atributo de nome comum (CN, na sigla em inglês) ou no atributo de nome alternativo do sujeito (SAN, na sigla em inglês). Se você solicitar um certificado TLS para vários SBCs, o SAN do certificado precisará incluir todos os FQDNs dos SBCs.
Fornecedores de autoridade certificadora aprovados:
- DigiCert
- Entrust DataCard
- GlobalSign
- GoDaddy
- Sectigo (anteriormente conhecida como Comodo)
Configurar o TLS do SBC
- Instale o certificado TLS solicitado com o certificado de CA raiz associado à cadeia de confiança do SBC.
- Instale a CA raiz confiável do Google na cadeia de confiança do SBC. Para receber o
certificado raiz do Google, siga estas etapas:
- Faça o download das CAs raiz confiáveis do Google.
- Extraia os certificados raiz.
- Faça upload do pacote raiz completo para seu keystore do SBC.
- Se necessário, ative as listas de revogação de certificados (CRLs).
- Ative a autenticação mútua para o SBC.
- Configure as versões do TLS e os pacotes de criptografia compatíveis. As versões 1.2 ou mais recentes são
compatíveis, além dos seguintes pacotes de criptografia:
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_AES_256_GCM_SHA384TLS_CHACHA20_POLY1305_SHA256TLS_AES_128_GCM_SHA256
Criar um entroncamento SIP no GTP
- Acesse o Console unificado {:.button .button-primary} e selecione seu projeto.
- Acesse a guia Entroncamentos SIP e clique em Adicionar um entroncamento SIP.
- Preencha todos os campos obrigatórios.
- Clique em Criar.
Analisar os requisitos de rede de conectividade de telefonia
Consulte a página de conceitos e solução de problemas para ver uma tabela de requisitos de rede e conectividade.
Configurar o SBC para conexão SIP com o GTP
Se o SBC estiver configurado usando um dos fornecedores de SBC compatíveis e certificados, consulte a documentação de protocolos de mídia e sinalização de SBC para instruções detalhadas específicas para esse fornecedor.
Configure o perfil SIP para usar TLS na porta TCP 5672, visando
servidores SIP GTP regionalizados específicos (por exemplo, us.telephony.goog).
Configure a integração de SIP e SIPREC da seguinte maneira:
- Para o caso de uso de conexão com agentes virtuais do Dialogflow, configure a integração SIP no SBC.
- Para o caso de uso do Agent Assist ou do Insights de IA de conversação, configure a integração do SIPREC no SBC para que cópias do stream de mídia sejam bifurcadas para o GTP. O uso do SIPREC com determinados fornecedores de SBC pode ser um recurso licenciado separado que você precisa comprar e ativar.
Teste de conectividade SIP com ping SIP OPTIONS
Faça um teste de ping SIP OPTIONS do SBC do cliente para o GTP para garantir que
seu SBC receba um SIP 200 OK do GTP. Se SIP 200 OK não for recebido, consulte
a seção de solução de problemas
do SIP.
Configuração do cabeçalho SIP para conversas da IA de conversação
- Defina o ID da conversa da IA de conversação configurando o cabeçalho SIP
(
Call-Infoou UUI) durante o SIP INVITE. - Use o cabeçalho SIP
Call-Info. Se isso não for compatível, use o cabeçalho SIP de informações de usuário para usuário (UUI, na sigla em inglês). Para mais informações sobre cabeçalhos SIP, consulte Cabeçalhos SIP. - Opcional: configure os papéis dos participantes (
END_USEReHUMAN_AGENT) e a ordem do stream de mídia. Para mais informações sobre papéis de participante, consulte papéis de participante. - Opcional: configure outros parâmetros para uma determinada conversa chamando a API
MatchIntentRequest. Para mais informações sobre outros parâmetros, consulte parâmetros adicionais.
Fazer chamadas de teste
Faça uma chamada de teste e verifique se o SIP e a mídia são transmitidos para os servidores SIP do GTP
(74.125.88.128/25) e os servidores de mídia RTP (74.125.39.0/24). Você deve receber uma
mensagem de resposta SIP 200 OK.
Se você receber um código de resposta de erro SIP 400, é provável que o GTP tenha rejeitado
o cabeçalho SIP ou a configuração do SDP de mídia SIP. Consulte a
seção de solução de problemas
para mais detalhes. Se você receber um código de resposta de erro SIP 600, é provável que
tenha um problema relacionado à cota.
Analisar o histórico de conversas do Dialogflow
Esta seção se aplica apenas se você implantar um agente virtual do Dialogflow.
Se a chamada de teste anterior resultou em uma resposta SIP 200 OK, verifique o
histórico de conversas do Dialogflow do projeto da IA de conversação Google Cloud
para garantir que as novas conversas sejam registradas e incluam o ID
especificado no cabeçalho de informações da chamada.
(Opcional) Analisar a Google Cloud Análise de registros
Verifique a atividade do Dialogflow no registro "incoming_call" da Análise de registros do projeto de IA de conversação Google Cloud:
Use a consulta a seguir para analisar as atividades de chamadas recebidas do Dialogflow e clique em Executar consulta:
logName="projects/PROJECT_ID/logs/dialogflow.googleapis.com%2Fincoming_call"PROJECT_ID: o ID do projeto do Google Cloud que você usou para configurar a integração de telefonia.
Como alternativa, acesse a lista Todos os nomes de registro da Análise de registros e pesquise o nome do registro
incoming_call. Selecione-a e clique em Aplicar.Se a geração de registros de auditoria estiver ativada para a API Dialogflow, verifique se o Dialogflow criou uma conversa na Análise de registros do projeto da IA de conversação Google Cloud . Use a consulta a seguir para analisar os eventos de criação de conversa do Dialogflow de um projeto e perfil de conversa específicos do Google Cloud e, em seguida, clique em Executar consulta.
protoPayload.serviceName=~"dialogflow" protoPayload.methodName=~"google.cloud.dialogflow.*.Conversations.CreateConversation" protoPayload.request.conversation.conversationProfile="projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID"PROJECT_ID: o ID do projeto do Google Cloud definido quando você configurou a integração.CONVERSATION_PROFILE_ID: o ID do perfil de conversa que você criou ao configurar a integração.