지원되고 인증된 SBC 공급업체 중 하나를 사용하여 SBC를 배포하는 경우 해당 공급업체에 관한 자세한 안내는 SBC 신호 및 미디어 프로토콜 문서를 참고하세요.
SIP 프로필이 특정 지역화된 GTP의 SIP 서버 (예: us.telephony.goog)를 타겟팅하는 TCP 포트 5672를 통해 TLS를 사용하도록 구성되어 있는지 확인합니다. SIP 및 SIPREC 통합 구성:
Dialogflow 가상 에이전트에 연결하는 사용 사례의 경우 SBC에서 SIP 통합을 구성합니다.
대화형 AI Agent Assist 또는 Insights 사용 사례의 경우 미디어 스트림 사본이 GTP로 포크되도록 SBC에서 SIPREC 통합을 구성합니다.
특정 SBC 공급업체와 함께 SIPREC를 사용하는 것은 별도의 라이선스 기능일 수 있으며, 이 경우 구매하고 활성화해야 합니다.
SIP OPTIONS 핑을 사용한 SIP 연결 테스트
고객 SBC에서 GTP로 SIP OPTIONS 핑 테스트를 실행하여 SBC가 GTP에서 SIP 200 OK를 수신하는지 확인합니다. SIP 200 OK가 수신되지 않으면 SIP 문제 해결 섹션을 참고하여 자세한 내용을 확인하세요.
대화형 AI 대화의 SIP 헤더 구성
SIP INVITE 중에 SIP 헤더 (Call-Info 또는 UUI)를 구성하여 대화형 AI의 대화 ID를 설정합니다.
Call-Info SIP 헤더를 사용합니다. 이 방법이 지원되지 않는 경우 User-to-User-Info (UUI) SIP 헤더를 사용할 수 있습니다. 자세한 내용은 SIP 헤더를 참고하세요.
(선택사항) 참여자 역할 (END_USER 및 HUMAN_AGENT)과 미디어 스트림 순서를 구성합니다. 자세한 내용은 참여자 역할 섹션을 참고하세요.
(선택사항) 특정 대화의 추가 매개변수를 설정하려면 MatchIntentRequest API를 호출합니다. 자세한 내용은 추가 매개변수 섹션을 참고하세요.
테스트 통화 수행
테스트 통화를 진행하고 SIP와 미디어가 GTP SIP 서버 (74.125.88.128/25) 및 RTP 미디어 서버 (74.125.39.0/24)로 이동하는지 확인합니다. SIP 200 OK 응답 메시지가 표시되어야 합니다.
SIP 400's 오류 응답 코드가 수신되면 GTP가 SIP 헤더 또는 SIP 미디어 SDP 구성을 거부한 것일 수 있습니다. 자세한 내용은 문제 해결 섹션을 참고하세요. SIP 600's 오류 응답 코드가 표시되면 할당량 관련 문제일 가능성이 높습니다.
Dialogflow 대화 기록 검토
이 섹션은 Dialogflow 가상 에이전트를 배포하는 경우에만 적용됩니다.
이전 테스트 호출에서 SIP 200 OK 응답이 반환된 경우 Conversational AI Google Cloud 프로젝트의 Dialogflow 대화 기록을 확인하여 새 대화가 로깅되고 호출 정보 헤더에 지정된 대화 ID가 포함되는지 확인합니다.
(선택사항) Google Cloud 로그 탐색기 검토
대화형 AI Google Cloud 프로젝트의 로그 탐색기 'incoming_call' 로그에서 Dialogflow 활동을 확인합니다.
다음 쿼리를 사용하여 Dialogflow의 수신 전화 활동을 검토한 다음 '쿼리 실행'을 클릭합니다.
$PROJECT_ID = 전화 통신 통합을 구성하는 데 사용한 Google Cloud 프로젝트 ID입니다.
또는 로그 탐색기의 모든 로그 이름 드롭다운 상자로 이동하여 로그 이름 incoming_call를 검색할 수 있습니다. 이 파일을 선택하고 적용을 클릭합니다.
Dialogflow가Google Cloud 프로젝트의 로그 탐색기에서 대화를 성공적으로 만들었는지 확인합니다 (이 단계는 감사 로깅이 Dialogflow API에 사용 설정된 경우에만 적용됨).
다음 쿼리를 사용하여 특정 Google Cloud 프로젝트 및 대화 프로필의 Dialogflow 대화 생성 이벤트를 검토한 후 쿼리 실행을 클릭합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# SBC configuration and validation\n\nThis page walks you through the process of configuring and validating the SBC.\n\nSupported vendors and firmware\n------------------------------\n\nBefore you begin the configuration, review the\ntable of\n[supported SBC vendors or models and firmware versions](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#supported_sbc_vendors_or_models).\n\nSupported SBC signaling and media protocols\n-------------------------------------------\n\nThe supported signaling and media protocols are specified in the\n[SBC signaling and media protocols documentation](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#supported_sbc_signaling_and_media_protocols).\nNote that `AES_CM_128_HMAC_SHA1_80` is the only SRTP cipher suite supported.\n\nSBC's TLS configuration\n-----------------------\n\nRequest a TLS certificate for the SBC from an approved certificate authority\nvendor. Wildcard certificates are not supported.\n\nWithin the TLS certificate, you must present the SBC's fully qualified domain\nname (FQDN) either in the common name (CN) attribute or in the subject\nalternative name (SAN) attribute. If you request one TLS certificate for\nmultiple SBCs, the certificate's SAN should include all SBC FQDNs.\n\nApproved certificate authority vendors\n\n- DigiCert\n- Entrust DataCard\n- GlobalSign\n- GoDaddy\n- Sectigo (Formerly known as Comodo)\n\n### Configure SBC TLS\n\n1. Install the requested TLS certificate along with the associated root CA certificate to the SBC's trust chain.\n2. Install Google's trusted root CA into SBC's trust chain. To get the Google\n Root certificate:\n\n 1. Download Google's [trusted root CAs](https://pki.goog/roots.pem).\n 2. Extract GTS Root R1 (GTSR1).\n 3. If required, extract the GlobalSign Root CA certificate.\n 4. Upload the root certificates to your SBC keystore.\n 5. Enable mutual authentication for the SBC.\n3. Configure supported TLS versions and cipher suites. TLS versions 1.2 or later\n are supported. Supported cipher suites:\n\n - `TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256`\n - `TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256`\n - `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256`\n - `HTLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256`\n - `TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384`\n - `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384`\n - `TLS_AES_256_GCM_SHA384`\n - `TLS_CHACHA20_POLY1305_SHA256`\n - `TLS_AES_128_GCM_SHA256`\n\nCreate a SIP trunk on GTP\n-------------------------\n\n1. Navigate to the [Unified Console](https://ccai.cloud.google.com/projects) and select your project.\n2. Navigate to the **SIP Trunks** tab, then click **Add a SIP Trunk**.\n3. Fill in all required fields.\n4. Click **Create**.\n\nReview telephony connectivity network requirements\n--------------------------------------------------\n\nSee the [concepts and troubleshooting page](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#telephony_network_requirements)\nfor a table of network and connectivity requirements.\n\nConfigure SBC for SIP connection to GTP\n---------------------------------------\n\nIf your SBC is deployed with one of the supported and certified SBC vendors,\nsee the [SBC signaling and media protocols documentation](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#supported_sbc_signaling_and_media_protocols)\nfor detailed instructions specific to that vendor.\n\nEnsure that the SIP profile is configured to use TLS over TCP port 5672\ntargeting specific regionalized GTP's SIP servers (for example,\n`us.telephony.goog`). SIP and SIPREC integration configuration:\n\n- For the use case of connecting to Dialogflow virtual agents, configure SIP integration on the SBC.\n- For the use case of Conversational AI Agent Assist or Insights, configure SIPREC integration on the SBC so copies of the media stream are forked to GTP. Note that using SIPREC with certain SBC vendors might be a separate licensed feature that you must purchase and activate.\n\nSIP connectivity test with SIP OPTIONS ping\n-------------------------------------------\n\nPerform a SIP OPTIONS ping test from customer SBC to GTP to ensure that your\nSBC receives a `SIP 200 OK` from GTP. If `SIP 200 OK` is not received, refer to\nthe SIP [troubleshooting section](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#troubleshooting)\nfor more details.\n\nSIP header configuration for Conversational AI conversations\n------------------------------------------------------------\n\n1. Set Conversational AI's Conversation ID by configuring the SIP header (`Call-Info` or UUI) during SIP INVITE.\n2. Use the `Call-Info` SIP header. If that is not supported, you can use the User-to-User-Info (UUI) SIP header. Refer to [SIP headers](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#sip_headers) for more details.\n3. (Optional) Configure participant roles (`END_USER` and `HUMAN_AGENT`) and media stream order. Refer to the [participant roles](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#configure_participant_roles_and_media_stream_order) section for details.\n4. (Optional) To set additional parameters for a given conversation, call the `MatchIntentRequest` API. Refer to the [additional parameters section](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#set_additional_parameters_on_a_given_conversation) for details.\n\nPerform test calls\n------------------\n\nConduct a test call and check to ensure SIP and media are traversing to GTP SIP\nservers (`74.125.88.128/25`) and RTP media servers (`74.125.39.0/24`). You\nshould get a `SIP 200 OK` response message.\n\nIf you receive a `SIP 400's` error response code it likely indicates that GTP\nrejected either the SIP header or SIP media SDP configuration. Refer to the\n[troubleshooting section](/dialogflow/cx/docs/concept/integration/sip-trunk/concepts-troubleshooting#troubleshooting)\nfor details. If you receive a `SIP 600's` error response code, it likely\nindicates a quota-related issue.\n\nReview Dialogflow conversation history\n--------------------------------------\n\nThis section applies only if you deploy a Dialogflow virtual agent.\n\nIf the previous test call resulted in a `SIP 200 OK` response, check the\nConversational AI Google Cloud project's Dialogflow\n[conversation history](/dialogflow/cx/docs/concept/conversation-history#browser)\nto make sure new conversations are being logged and include the conversation ID\nspecified in the call info header.\n\n(Optional) Review Google Cloud Logs Explorer\n--------------------------------------------\n\nCheck Dialogflow activity in the Conversational AI Google Cloud project's\nLogs Explorer \"incoming_call\" log.\n\n1. Use the following query to review Dialogflow's incoming call activities,\n then click \"Run query\":\n\n `logName=\"projects/$PROJECT_ID/logs/dialogflow.googleapis.com%2Fincoming_call`\n\n `$PROJECT_ID` = The Google Cloud project ID that you used to configure the\n telephony integration.\n2. Alternatively, you can navigate to the Logs Explorer's **All log names**\n drop down box and search for log name `incoming_call`. Select it and click\n **Apply**.\n\n3. Verify that Dialogflow created a conversation successfully in the\n Google Cloud project's Logs Explorer (this step only applies if audit\n logging is\n [enabled for the Dialogflow API](/dialogflow/cx/docs/concept/integration/sip-trunk/cloud-setup#audit-logging)).\n Use the following query to review Dialogflow's conversation creation\n events from a specific Google Cloud project and conversation profile, then\n click **Run query**.\n\n protoPayload.serviceName=~\"dialogflow\"\n protoPayload.methodName=~\"google.cloud.dialogflow.*.Conversations.CreateConversation\"\n protoPayload.request.conversation.conversationProfile=\"projects/$PROJECT_ID/locations/global/conversationProfiles/$CONVERSATION_PROFILE_ID\"\n\n - `$PROJECT_ID` = The Google Cloud project ID defined when you [configured the integration](/dialogflow/cx/docs/concept/integration/sip-trunk/cloud-setup#select-project).\n - `$CONVERSATION_PROFILE_ID` = The conversation profile ID you created when you [configured the integration](/dialogflow/cx/docs/concept/integration/sip-trunk/cloud-setup#configure-profile)."]]
