이 가이드에 따라 RBM 문제를 해결하는 데 필요한 정보를 제공하세요.
메시지 전송 및 형식 문제
메시지 형식 문제 등 메시지의 실제 전송 및 수신과 관련된 문제입니다.
RBM 메시지를 보낼 수 없음
문제 해결을 더 빠르게 진행할 수 있도록 다음 세부정보를 최대한 많이 공유해 주세요.
- 타임스탬프가 포함된 샘플 메시지 ID
- 파트너 ID (스크린샷 참고)
- 영향을 받는 상담사 수
- 에이전트 ID (쉼표로 구분)
- 영향을 받거나 영향을 받을 수 있는 메일의 예상 수
- 문제가 있는 API 메서드 (예: 파일 업로드, 상담사-사용자 메시지 생성, 상담사-사용자 이벤트 생성, 상담사-사용자 메시지 삭제, 기능 가져오기, 일괄 가져오기)
- 실패한 요청의 샘플 JSON 페이로드
- 클라이언트 문제: 클라이언트 버그 신고
오류 코드와 오류 메시지를 포함한 오류 로그 (RBM API 호출 시 터미널에 표시되는 오류) 예를 들면 다음과 같습니다.
"error": { "code": 403, "message": "There was an error looking up the RBM agent (ID: [email protected]) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.", "status": "PERMISSION_DENIED", }웹훅에서 이벤트 또는 메시지를 수신하지 않음
원활한 메시지 전송을 위해 모든 파트너 계정의 에이전트 웹훅이 올바르게 작동하고 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은 메시지에 Rich Communication Services (RCS) 표준을 채택했지만 자체적인 고유한 구현을 개발하기로 했습니다. 여기에는 RCS 비즈니스 메시지 (RBM)와 같은 기능이 포함됩니다.
iOS 기기에서 RBM에 문제가 발생하는 경우 의견 도우미 앱을 통해 Apple에 직접 신고하는 것이 좋습니다. 이렇게 하면 Apple에서 구현과 관련된 문제를 파악하고 해결하는 데 도움이 됩니다.
- iOS 기기에서 Feedback Assistant 앱을 엽니다.
- 메시지 앱 관련 문제와 관련된 적절한 시작 주제를 선택합니다.
- 의견을 작성하고 제출합니다.
- 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
- 브랜드 담당자 및 이동통신사의 이메일 승인
- 새 파트너 ID
승인 및 세부정보를 확인한 후 RBM 지원팀에서 이동통신사에 대기 중인 변경사항을 알립니다. 이러한 변경사항은 운송업체 알림 후 24시간 이내에 적용되고 확인됩니다.
상담사를 다른 파트너 계정으로 이전 요청
더 빠른 업데이트를 위해 다음 세부정보를 공유하세요.
- 에이전트 ID 목록
- 이전 파트너 ID
- 새 파트너 ID
결제 이벤트 보고서에 정보가 누락됨
다음 세부정보를 공유하여 더 빠르게 문제를 해결할 수 있습니다.
- 파일이 누락된 날짜
- 에이전트 ID