업데이트: 출시 노트에서 새로운 기능 및 제품 업데이트를 확인하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

RBM 문제 해결 가이드

이 가이드에 따라 RBM 문제를 해결하는 데 필요한 정보를 제공하세요.

RBM 메시지를 보낼 수 없음

더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.

타임스탬프가 있는 샘플 메시지 ID
파트너 ID (스크린샷 참고)
영향을 받은 상담사 수
상담사 ID (쉼표로 구분)
영향을 받거나 영향을 받을 수 있는 예상 메일 수
문제가 있는 API 메서드 (예: 파일 업로드, 사용자 메시지에 대한 상담사 생성, 사용자 이벤트에 대한 상담사 생성, 사용자 메시지에 대한 상담사 삭제, 기능 가져오기, 일괄 가져오기)
실패한 요청의 샘플 JSON 페이로드
고객 문제의 경우: 고객 버그 신고

오류 코드 및 오류 메시지를 포함한 오류 로그 (RBM API를 호출할 때 터미널에 표시되는 오류) 예를 들면 다음과 같습니다.

"error": {
"code": 403,
"message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
"status": "PERMISSION_DENIED",
}

RBM 작업 실행 지연 시간

먼저 다음 사항을 확인하세요.

질문	권장사항
지연 시간이 `<5s`인가요?	이 경우 허용되는 범위 내에 있습니다.
지연 시간이 회귀했나요?	그렇다면 언제부터 그런 증상이 있었나요? 이전과 비교해 현재 일반적인 지연 시간은 얼마인가요?
파일 업로드 API를 사용하고 계신가요?	직접 URL을 전송하는 대신 파일 ID를 사용해 보세요. 새 미디어 URL을 처리하는 데는 다운로드, 처리, 썸네일, 악용 방지, 바이러스 방지가 포함되며, 이 중 바이러스 방지에 약 50% 의 시간이 소요됩니다.
메시지 미디어를 미리 업로드하셨나요?	처리 속도를 높이려면 다음 API 호출을 사용하는 것이 좋습니다. `https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create`
기능 확인을 실행하셨나요?	RCS를 통해 연결할 수 없는 사용자에게 메시지를 보낼 때 지연 시간을 줄이려면 먼저 기능 검사를 실행하세요.

문제가 계속되면 더 빠르게 문제를 해결할 수 있도록 최대한 많은 세부정보를 제공해 주세요.

영향을 받은 메일 수
지연 시간의 소스 (예: 파일 업로드, 사용자 메시지에 대한 상담사 생성, 사용자 이벤트에 대한 상담사 생성, 사용자 메시지에 대한 상담사 삭제, 기능 가져오기, 일괄 가져오기)
서비스 엔드포인트
지연 시간 분포 (p50, p95, p99)
지연 시간 변경 및 기간
파트너 ID
영향을 받은 상담사 ID
타임스탬프가 포함된 메시지 ID
JSON 페이로드

Webhook에서 이벤트 또는 메시지를 수신하지 못함

원활한 메시지 전송을 위해 모든 파트너 계정의 상담사 Webhook이 올바르게 작동하고 Google의 메시지를 처리할 수 있는지 확인합니다. 파트너 계정의 모든 상담사는 수신 메시지 및 이벤트에 대해 단일 채널을 공유하므로 웹훅이 제대로 작동하지 않으면 모든 상담사의 전송이 중단될 수 있습니다.

문제가 지속되면 더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.

언제 문제가 발생했나요? 그 전에는 메시지와 일정을 정상적으로 수신하셨나요?
파트너 ID
상담사 ID
웹훅 URL
타임스탬프가 포함된 메시지 ID

캐러셀 및 리치 카드 렌더링 문제

이 문제의 예로는 로드 실패, 검은색 화면 표시, 자르기, 추천 작업이 표시되지 않는 문제가 있습니다.

더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.

타임스탬프가 포함된 메시지 ID
JSON 페이로드
기기 재현 단계(알고 있는 경우)
메시지를 수신하는 기기의 버그 신고
사용된 기기 및 메시지 앱 버전에 관한 세부정보
문제의 스크린샷 또는 동영상 녹화

JSON으로 전송되거나 SMS로 변환된 RBM 메시지

더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.

타임스탬프가 포함된 메시지 ID
JSON 페이로드
기기 재현 단계(알고 있는 경우)
메시지를 수신하는 기기의 버그 신고
사용된 기기 및 메시지 앱 버전에 관한 세부정보
문제의 스크린샷 또는 동영상 녹화

P2A URL 또는 QR 코드 생성 실패

더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.

에이전트 ID
비즈니스 커뮤니케이션 개발자 콘솔에 표시된 JavaScript 오류의 세부정보

RBM 딥 링크를 열 수 없음

더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.

에이전트 ID
전화번호
재현 단계(알려진 경우)
버그 신고 (링크가 열렸던 기기에서)
문제의 스크린샷 또는 동영상 녹화

RCS 지원 기기에서 메시지를 수신할 수 없음

더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.

RBM 메시지를 수신하지 못하는 기기의 버그 신고
전화번호
기기 및 OS에 관한 세부정보
사용된 메시지 앱 버전
재현 단계(알려진 경우)
RCS 상태를 보여주는 스크린샷
문제의 스크린샷 또는 동영상 녹화
이동통신사 이름 및 국가

테스터를 추가할 수 없음

테스트 기기 설정의 단계를 따릅니다.

문제가 지속되면 더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.

에이전트 ID
전화번호
이동통신사 이름 및 국가

테스트 기기에 테스터 초대 또는 메시지가 수신되지 않음

테스트 기기 설정의 단계를 따릅니다.

문제가 계속되면 더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.

에이전트 ID
전화번호
타임스탬프가 포함된 메시지 ID
테스트 초대를 보낸 후 5분 이내에 버그 신고

기능 확인 관련 문제

더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.

국가 코드가 포함된 전화번호 목록(CSV 파일)
상담사 ID
오류 로그
기기의 RCS 상태

결제 이벤트 보고서에 정보 누락

더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.

파일이 누락된 날짜
상담사 ID

이동통신사에서 상담사 실행을 승인할 수 없음

RBM 관리 콘솔에서 문제를 신고합니다(스크린샷 참고).

긴급 출시의 경우 다음 정보를 제공해 주세요.

이동통신사 이름 및 국가
실행할 상담사 ID
출시에 대한 이동통신사 승인

상담사 세부정보 업데이트 요청

더 빠른 업데이트를 위해 다음 세부정보를 공유하세요.

에이전트 ID
업데이트할 메타데이터 세부정보 (예: 이름, 로고, 배너, 설명, 연락처 세부정보, 개인정보처리방침 링크 또는 서비스 약관 링크)

상담사를 다른 파트너 계정으로 이전해 달라는 요청

더 빠른 업데이트를 위해 다음 세부정보를 공유하세요.

상담사 ID 목록
이전 파트너 ID
새 파트너 ID