이 가이드에 따라 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", }Webhook에서 이벤트 또는 메시지를 수신하지 못함
원활한 메시지 전송을 위해 모든 파트너 계정의 상담사 Webhook이 올바르게 작동하고 Google의 메시지를 처리할 수 있는지 확인합니다. 파트너 계정의 모든 상담사는 수신 메시지 및 이벤트에 대해 단일 채널을 공유하므로 웹훅이 제대로 작동하지 않으면 모든 상담사의 전송이 중단될 수 있습니다.
문제가 지속되면 더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.
- 언제 문제가 발생했나요? 그 전에는 메시지와 일정을 정상적으로 수신하셨나요?
- 파트너 ID
- 상담사 ID
- 웹훅 URL
- 타임스탬프가 포함된 메시지 ID
JSON으로 전송되거나 SMS로 변환된 RBM 메시지
더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.
- 타임스탬프가 포함된 메시지 ID
- JSON 페이로드
- 기기 재현 단계(알려진 경우)
- 메시지를 수신하는 기기의 버그 신고
- 사용된 기기 및 메시지 앱 버전에 관한 세부정보
- 문제의 스크린샷 또는 동영상 녹화
RCS 지원 기기에서 메시지를 수신할 수 없음
더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.
- RBM 메시지를 수신하지 못하는 기기의 버그 신고
- 전화번호
- 기기 및 OS에 관한 세부정보
- 사용된 메시지 앱 버전
- 재현 단계(알려진 경우)
- RCS 상태를 보여주는 스크린샷
- 문제의 스크린샷 또는 동영상 녹화
- 이동통신사 이름 및 국가
클라이언트 및 기기 설정/연결 문제
이러한 문제에는 클라이언트 측 설정, 연결, 플랫폼별 문제가 포함됩니다.
P2A URL 또는 QR 코드 생성 실패
더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.
- 에이전트 ID
- 비즈니스 커뮤니케이션 개발자 콘솔에 표시된 JavaScript 오류의 세부정보
RBM 딥 링크를 열 수 없음
더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.
- 에이전트 ID
- 전화번호
- 재현 단계(알려진 경우)
- 링크가 열렸던 기기의 버그 신고
- 문제의 스크린샷 또는 동영상 녹화
기능 확인 관련 문제
더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.
- 국가 코드가 포함된 전화번호 목록(CSV 파일)
- 상담사 ID
- 오류 로그
- 기기의 RCS 상태
- 테스트를 실행한 날짜 및 시간
테스트 기기에 테스터 초대 또는 메시지가 수신되지 않음
테스트 기기 설정의 단계를 따릅니다.
문제가 지속되면 더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.
- 에이전트 ID
- 전화번호
- 타임스탬프가 포함된 메시지 ID
- 테스트 초대를 보낸 후 5분 이내에 버그 신고
iOS 기기의 RCS/RBM 문제
Apple은 메시지에 RCS (Rich Communication Services) 표준을 채택했지만 자체 고유한 구현을 개발하기로 했습니다. 여기에는 RCS 비즈니스 메시지 (RBM)와 같은 기능이 포함됩니다.
iOS 기기에서 RBM과 관련된 문제가 발생하면 의견 어시스턴트 앱을 통해 Apple에 직접 신고하는 것이 좋습니다. 이렇게 하면 Apple에서 구현과 관련된 문제를 파악하고 해결하는 데 도움이 됩니다.
- iOS 기기에서 의견 어시스턴트 앱을 엽니다.
- 메시지 앱 문제와 관련된 적절한 시작 주제를 선택합니다.
- 의견을 작성하고 제출합니다.
- RBM 지원팀에 관련 정보를 제공하려면 조사 결과를 공유해 주세요. 모든 사용자를 위한 RCS 환경을 개선하는 데 도움을 주셔서 감사합니다.
iOS 기기에서 RCS/RBM 이동통신사 사용 가능 여부
Apple은 iOS에서 RCS/RBM을 출시할 이동통신사를 자체적으로 선택합니다. 전 세계 사용 가능 여부 또는 Apple의 향후 계획에 관해 문의하려면 Apple에 직접 문의하세요. 관심 있는 이동통신사에 연락하여 iOS의 RCS/RBM 출시 상태를 문의할 수도 있습니다.
국가별로 iPhone의 무선 이동통신사 지원 및 기능에 관한 정보를 확인하려면 Apple 지원 페이지를 참고하세요.
성능 및 디스플레이 문제
RBM의 성능 및 표시와 관련된 문제입니다.
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 페이로드
캐러셀 및 리치 카드 렌더링 문제
이 문제의 예로는 로드 실패, 검은색 화면 표시, 자르기, 추천 작업이 표시되지 않는 문제가 있습니다.
더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.
- 타임스탬프가 포함된 메시지 ID
- JSON 페이로드
- 기기 재현 단계(알려진 경우)
- 메시지를 수신하는 기기의 버그 신고
- 사용된 기기 및 메시지 앱 버전에 관한 세부정보
- 문제의 스크린샷 또는 동영상 녹화
계정, 상담사, 이동통신사 관리 문제
청구 쿼리를 비롯한 계정 관리 및 보고와 관련된 문제입니다.
테스터를 추가할 수 없음
테스트 기기 설정의 단계를 따릅니다.
문제가 지속되면 더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.
- 에이전트 ID
- 전화번호
- 이동통신사 이름 및 국가
이동통신사에서 상담사 출시를 승인할 수 없음
RBM 관리 콘솔에서 문제를 신고합니다(스크린샷 참고).
긴급 출시의 경우 다음 정보를 제공해 주세요.
- 이동통신사 이름 및 국가
- 실행할 상담사 ID
- 출시에 대한 이동통신사 승인
상담사 세부정보 업데이트 요청
더 빠른 업데이트를 위해 다음 세부정보를 공유하세요.
- 상담사 ID
- 변경하려는 세부정보
- 에이전트 실행 취소에 대한 확인
다음 필드의 경우 RBM 지원팀에서 상담사를 출시 취소합니다. 그런 다음 에이전트를 변경하고 출시를 위해 다시 제출할 수 있습니다.
- 표시 이름
- 설명
- 색상
- 로고 및 배너 이미지
- 상담사 연락처 정보(예: 전화번호, 웹사이트, 이메일 주소)
- 개인 정보 보호 및 서비스 약관
다음 필드의 경우 RBM 지원팀에서 상담사를 실행취소하고 필드를 수정합니다 (RBM 파트너는 이러한 필드를 직접 수정할 수 없음).
- 결제 카테고리
- 사용 사례
- 브랜드 이름
- 브랜드 연락처 이름
- 브랜드 담당자 이메일 ID
- 브랜드 웹사이트 URL
- 메시지 파트너 연락처 이름
- 메시지 파트너 연락처 이메일
상담사를 중지하지 않고 상담사 정보를 수정하려면 상담사가 현재 실행 중인 이동통신사 관리 네트워크의 담당자로부터 이메일 승인을 받습니다. 모든 승인 이메일을 수집한 후 필요한 수정사항의 세부정보와 함께 RBM 지원팀에 공유합니다.
RBM 지원팀에서 승인을 확인하고 모든 것이 정상인 경우 변경사항을 구현한 후 광고주 및 해당 이동통신사와 확인합니다. 이 절차는 국가별로 이동통신사별 절차에 따라 다를 수 있습니다.
RBM 파트너 계정 변경 요청
RBM 파트너가 이동통신사 관리 네트워크에서 실행 중인 상담사가 있는 경우 다음 단계를 따르세요.
- 상담사가 출시된 이동통신사 관리 네트워크의 담당자로부터 이메일 승인을 받습니다.
- RBM 지원팀에 다음 세부정보를 공유합니다.
- RBM 파트너 ID
- 변경하려는 세부정보
승인 및 세부정보를 확인한 후 RBM 지원팀에서 대기 중인 변경사항을 이동통신사에 알립니다. 이러한 변경사항은 이동통신사 알림 후 24시간 이내에 구현 및 확인됩니다.
RBM 파트너 A에서 파트너 B로 상담사를 이전해 달라는 요청
에이전트가 이미 이동통신사 관리 네트워크에서 실행 중인 경우 다음 단계를 따르세요.
- 브랜드 담당자 및 이동통신사 관리 네트워크의 담당자로부터 이메일 승인을 받습니다.
- 승인 이메일에 새 RBM 파트너가 참조로 추가되어 있는지 확인합니다.
- RBM 지원팀에 다음 세부정보를 공유합니다.
- 상담사 ID
- 브랜드 담당자 및 이동통신사의 이메일 승인
- 원래 RBM 파트너 ID 및 새 RBM 파트너 ID
승인 및 세부정보를 확인한 후 RBM 지원팀에서 대기 중인 변경사항을 이동통신사에 알립니다. 이러한 변경사항은 이동통신사 알림 후 24시간 이내에 구현 및 확인됩니다.
상담사를 다른 파트너 계정으로 이전해 달라는 요청
더 빠른 업데이트를 위해 다음 세부정보를 공유하세요.
- 상담사 ID 목록
- 이전 파트너 ID
- 새 파트너 ID
결제 이벤트 보고서에 정보 누락
더 빠르게 문제를 해결할 수 있도록 다음 세부정보를 공유해 주세요.
- 파일이 누락된 날짜
- 상담사 ID