자주 묻는 질문

이 문서에서는 SMS, MMS, RCS 메시징에 대해 자주 묻는 질문에 대한 답변을 제공합니다.

일반

SMS API 오브젝트의 app_id는 무엇인가요?

앱 식별자 API 키, 즉 app_id는 활동을 워크스페이스의 특정 앱과 연결하는 매개변수입니다. 워크스페이스 내에서 어떤 앱과 상호작용하는지를 지정합니다. 예를 들어 iOS 앱, Android 앱, 웹 통합마다 각각 app_id가 있습니다.

SMS의 경우, API(예: /messages/send 엔드포인트)로 SMS 메시지를 보낼 때 app_id 매개변수가 필요합니다. 이 매개변수는 SMS 활동이나 API 호출이 워크스페이스의 어떤 앱과 연결되는지를 지정합니다. 사용자의 프로필에 해당 앱이 있는지와 관계없이, SMS 메시징용으로 워크스페이스에 설정된 앱의 유효한 app_id라면 무엇이든 사용할 수 있습니다.

app_id는 설정 > 앱 설정으로 이동한 다음 식별 섹션에서 확인할 수 있습니다.

여러 사용자가 같은 전화번호를 가지고 있으면 어떻게 되나요?

SMS가 활성화된 하나의 전화번호를 공유하는 여러 고객 프로필이 수신 SMS 이벤트로 트리거되는 실행 기반 Campaign 또는 Canvas 컴포넌트에 동시에 해당하는 경우, Braze는 Canvas 컴포넌트 수준에서 사용자 중복을 제거합니다. 이를 통해 여러 사용자가 같은 전화번호를 공유하더라도 사용자가 하나의 Canvas 컴포넌트에서 SMS 문자를 두 번 이상 받지 않도록 합니다.

Braze는 다음 흐름에 따라 수신자 프로필을 결정합니다.

• 가장 최근(최대 7일 전까지)에 SMS를 받은 프로필을 확인하고, 해당 프로필이 있으면 그 사용자에게 보냅니다.
• 7일 이내에 SMS를 받은 프로필이 없으면, 전화번호와 일치하는 “phone” 사용자 별칭을 가진 사용자에게 보냅니다.
• 두 경우 모두 해당하지 않으면, 사용 가능한 프로필 중 임의의 프로필에 보냅니다.

공유 전화번호에서 “START” 또는 “STOP” 키워드를 받으면, 모든 고객 프로필이 SMS에 구독 및 활성화되거나 구독 해지됩니다. 이는 API를 통한 상태 변경에도 적용됩니다. 예를 들어 외부 ID가 서로 다른 여러 프로필이 같은 전화번호를 가지고 있다면, API를 통해 구독 그룹 상태를 변경할 때 외부 ID를 하나만 지정하더라도 해당 전화번호를 가진 모든 프로필이 업데이트됩니다.

불필요하게 대규모 업데이트가 발생하지 않도록, Braze는 구독 업데이트 시 식별자를 공유하는 고객 프로필을 최대 100개까지 업데이트합니다. 같은 전화번호를 공유하는 고객 프로필이 100개를 넘으면 모든 프로필이 업데이트되지는 않습니다.

특정 소스에서 SMS 구독이 급증하는 이유는 무엇인가요?

구독 수가 예상보다 크게 증가했다면, 특히 Currents를 통해 /subscription/status/set 엔드포인트의 데이터를 검토할 때 이런 현상이 보인다면 중복 고객 프로필이 원인일 수 있습니다.

external_id 없이 전화번호만으로 /subscription/status/set 엔드포인트에 요청하면, Braze는 해당 전화번호를 공유하는 모든 고객 프로필을 업데이트합니다. 워크스페이스에 중복 프로필이 있으면 실제로는 전화번호 하나만 변경되었더라도 구독 상태를 업데이트한 사용자 수가 부풀려집니다.

Currents에서 데이터를 가져올 때 구독 데이터를 더 정확하게 분석하려면, 모든 구독 상태 변경 이벤트를 세는 대신 고유한 전화번호 수를 세도록 쿼리를 업데이트하세요.

공유 짧은 코드란 무엇인가요?

공유 짧은 코드를 사용하면 어떤 기업이나 조직이 보내든 모든 문자 메시지가 동일한 5~6자리 전화번호로 소비자의 모바일 기기에 도착합니다. 공유 짧은 코드는 비교적 저렴하고 바로 사용할 수 있지만, 기업 전용 짧은 코드를 갖지 못한다는 의미이기도 합니다.

이 방식의 단점은 다음과 같습니다.

• 고객이 짧은 코드를 공유하는 다른 기업의 메시지를 옵트아웃하면, 귀사의 메시지도 함께 옵트아웃됩니다.
• 한 기업이 규칙을 위반하면 모든 기업의 메시지가 중단됩니다.
• 보안 문제

청구 및 가격

SMS 요금은 어떻게 청구되나요?

짧은 코드 및 긴 코드 요금 외에도 Braze는 국가별로 SMS 메시지 할당량을 제공합니다. Braze는 고객과 협의하여 국가별 메시지 세그먼트 수를 정하고, 고객은 이 할당량으로 SMS Campaigns를 보냅니다. 요금은 국가별로 전송된 메시지 세그먼트 수를 기준으로 청구됩니다. 메시지 세그먼트 계산 방식은 메시지 세그먼트 및 문자 수 제한 가이드를 참조하세요. 최대 할당량에 가까워지면 계정 매니저가 연락하여 알려드리며, 상황을 파악하는 데 도움이 되는 관련 보고서도 제공합니다. 초과량에 대한 추가 문의는 Braze 담당자에게 연락하세요.

MMS와 SMS의 가격이 다른가요?

MMS와 SMS는 비용이 다르며, 발송량에 따라 별도로 청구됩니다. 가격 정보는 Braze 온보딩 팀에 문의하세요.

초과량을 방지하려면 어떻게 해야 하나요?

가끔 초과량이 발생하지 않는다고 보장할 수는 없지만, 다음 예방 조치를 따르면 할당량을 초과할 가능성을 줄일 수 있습니다.

• SMS의 글자 수에 주의하세요. 의도치 않게 두 개 이상의 세그먼트를 보내면 초과량이 발생할 수 있습니다. 자세한 내용은 세그먼트 구성을 참조하세요.
• Liquid 또는 연결된 콘텐츠를 고려하여 SMS 글자 수를 신중하게 계산하세요. 대시보드의 Braze SMS 작성기는 이러한 기능의 사용량을 예측하거나 반영하지 않습니다.
• 메시지에 사용되는 인코딩 유형을 고려하세요. 메시지가 GSM-7 인코딩을 사용하는 경우, 일반적으로 메시지 세그먼트당 160자로 예상할 수 있습니다(GSM-7 확장 테이블의 문자를 사용하면 더 적어집니다). 메시지가 UCS-2 인코딩을 사용하는 경우, 일반적으로 메시지 세그먼트당 67자로 예상할 수 있습니다.
• 테스트하고 또 테스트하세요! 특히 Liquid와 연결된 콘텐츠를 사용할 때는 출시 전에 항상 SMS 메시지를 테스트하세요.

유선 전화로 메시지를 보내도 SMS 발송 수에 포함되나요?

미국, 캐나다, 영국의 경우:

• SMS가 유선 전화로 전송되면 Undelivered로 표시됩니다. 청구 방식은 SMS 서비스 공급자에 따라 다릅니다. Twilio의 경우 전송 시도에도 요금이 부과되므로, 메시지 로그에 Sent, Delivered 또는 Undelivered로 표시된 메시지는 모두 청구됩니다.
• 영국에서는 일부 통신사가 SMS를 음성 메일로 변환하여 메시지를 전달합니다.

기타 국가의 경우:

• Twilio에서는 오류가 발생하며, 전송을 시도한 SMS 메시지에 대해 요금이 청구되지 않습니다.

메시지가 160자(GSM-7) 또는 67자(UCS-2) 미만인데도 Braze 대시보드에서 추가 메시지 세그먼트 요금이 부과될 수 있다는 경고가 표시되는 이유는 무엇인가요?

메시지에 Liquid 개인화가 포함되어 있으면 추가 메시지 세그먼트 요금이 부과될 수 있습니다. 콘텐츠 블록 템플릿은 메시지가 전송 준비 단계에 들어가야 적용됩니다. 콘텐츠 블록이 포함된 SMS를 편집할 때 Braze는 콘텐츠 블록에 어떤 내용이 들어갈지 알 수 없으므로 대략적인 추정치만 제공합니다. 테스트 창에서 메시지를 미리 보고 실제 결과를 더 정확하게 확인하는 것을 권장합니다.

발송 및 전달 가능성

SMS에 링크를 포함할 수 있나요?

모든 SMS Campaign에 원하는 링크를 포함할 수 있습니다. 다만 몇 가지 고려해야 할 사항이 있습니다.

• 링크가 SMS의 160자 제한 중 상당 부분을 차지할 수 있습니다. 링크와 텍스트를 함께 포함하면 SMS 메시지 1건이 아닌 2건으로 발송될 수 있습니다.
• 기업에서는 링크가 글자 수에 미치는 영향을 줄이기 위해 링크 단축 서비스를 자주 사용합니다. 하지만 단축 링크를 긴 코드로 발송하면 이동통신사에서 링크 리디렉션을 의심하여 메시지를 차단하거나 거부할 수 있습니다.
• 링크를 포함할 때 가장 안정적인 번호 유형은 짧은 코드입니다.

Braze에는 링크를 자동으로 단축하고 클릭률 분석을 제공하는 자체 링크 단축 기능도 있습니다. 자세한 내용은 링크 단축을 참조하세요.

SMS 메시지 발송 속도를 제한해야 하나요?

기본 동시 처리 속도와 처리량으로 짧은 코드 하나당 시간당 약 360,000건의 메시지를 발송할 수 있습니다. 처리량을 늘리려면 짧은 코드를 추가해야 합니다.

SMS용 URL을 허용 목록에 추가하려면 어떻게 해야 하나요?

특정 국가(예: 스웨덴 또는 북유럽 국가)의 사용자에게 URL이 포함된 SMS 메시지를 발송하기 전에 해당 URL을 이동통신사에 등록해야 합니다. Braze 고객 서비스 매니저에게 문의하여 도움을 받으세요. 이 과정은 약 5일 정도 소요됩니다.

SMS 스팸 감지를 피하기 위한 발송 모범 사례는 무엇인가요?

1. 옵트인 및 옵트아웃 안내가 명확한지 확인하세요.
2. 브랜드와 고객 간에 관계가 형성되어 있는지 확인하세요.
3. 콘텐츠가 고객과의 관계 및 사용자가 수신에 동의한 내용과 관련이 있는지 확인하세요.

스팸 감지를 피하기 위한 추가 가이드라인은 SMS 법률 및 규정 가이드라인을 참조하세요.

이모티콘은 몇 글자를 사용하나요?

이모티콘은 모든 이모티콘에 적용되는 표준 글자 수가 없기 때문에 까다로울 수 있습니다. Braze 작성기에서는 메시지 1건으로 표시되더라도 이모티콘이 글자 수 제한을 초과하여 SMS가 여러 메시지로 나뉠 위험이 있습니다. 메시지를 테스트할 때 세그먼트 계산기를 사용하면 메시지가 분할될지 더 정확하게 확인할 수 있습니다.

구독 그룹 및 옵트인/옵트아웃

사용자가 올바른 구독 그룹에 속하도록 SMS 선택적 옵트인 로직을 만들려면 어떻게 해야 하나요?

커스텀 키워드는 커스텀 이벤트로 기록되므로, 고객이 문자로 보낼 수 있는 키워드를 기준으로 Segments를 만들면 됩니다. 예를 들어 사용자가 VIP 메시지에 대해서는 SMS 옵트인을 했지만 알림에 대해서는 옵트인하지 않은 경우, VIP Segment와 알림 Segment를 만든 다음 해당 사용자를 적절한 Segment에 할당할 수 있습니다.

사용자가 짧은 코드로 “Stop”이라고 문자를 보내면 구독 그룹에서 탈퇴 처리되나요?

고객 프로필에서는 어떻게 표시되나요? 구독 그룹은 연락처 설정 아래에 탈퇴 상태로 표시되며, 구독 및 탈퇴에 대한 커스텀 이벤트가 생성됩니다.

옵트아웃한 사용자가 짧은 코드와 긴 코드로 키워드를 보내면 Braze에서 해당 키워드에 대해 구성한 응답을 받나요?

옵트아웃한 사용자가 기본 키워드 카테고리 중 하나에 해당하는 키워드를 보내면 해당 키워드에 대한 응답을 받습니다. 옵트아웃한 사용자가 커스텀 키워드를 보내면 해당 키워드에 대한 응답을 받지 않습니다.

SMS 이벤트 속성정보가 문장 속 키워드를 캡처하나요?

문장 안에서 키워드를 인식하려면(예: “please stop texting me”) 메시지에 Liquid 문을 사용하여 특정 단어를 인식하도록 해야 합니다. 이벤트 속성정보에는 256자의 글자 수 제한이 있으며, 그 외에는 글자 수 제한이 없습니다.

테스트

테스트 문자 메시지도 한도에 포함되나요?

네, 포함됩니다. 메시지를 테스트할 때 이 점을 고려하세요.

SMS 테스트 메시지를 받으려면 사용자가 SMS 구독 그룹에 속해 있어야 하나요?

네, 속해 있어야 합니다. 사용자는 유효한 전화번호가 있어야 하고, 테스트 전송에 사용하는 SMS 구독 그룹에 속해 있어야 하며, SMS의 지리적 권한에서 국가를 하나 이상 선택해야 합니다.

고객 프로필에 별칭이 있는지 확인하는 방법이 있나요?

별칭은 고객 프로필에 표시되지 않습니다. 별칭이 설정되었는지 확인하려면 사용자 데이터 내보내기 엔드포인트를 사용하세요.

MMS

MMS를 전송할 때 Currents 데이터에 변경 사항이 있나요?

아니요, MMS 메시지를 전송할 때도 동일한 수준의 인사이트가 제공됩니다.

MMS의 이미지와 메시지 본문의 전달 순서를 제어할 수 있나요?

Braze는 MMS 메시지에 메시지 본문과 이미지가 모두 포함된 경우 표시 순서를 제어할 수 없습니다. 이는 다음을 포함하되 이에 국한되지 않는 여러 요인에 따라 달라집니다:

• 메시지를 수신하는 통신사
• 메시지를 수신하는 기기
• 메시지의 전체 크기

MMS에는 별도의 온보딩 프로세스가 필요한가요?

아니요. MMS는 이제 SMS 온보딩 프로세스에 포함되어 있습니다. 이미 온보딩을 완료한 기존 고객은 다음 단계를 완료한 후 MMS Campaign을 전송할 수 있습니다:

1. MMS를 구매합니다.
2. Braze 온보딩 팀에 연락하여 MMS 기능 활성화를 요청합니다. 이렇게 하면 MMS가 활성화되고 SMS/MMS 구독 그룹이 생성되거나 업데이트됩니다.

다음으로, Braze 온보딩 팀이 짧은 코드와 긴 코드가 MMS에 대해 활성화되었는지 확인합니다(미국 및 캐나다). 또한 MMS에 추가되거나 활성화된 현재 번호를 표시하도록 구독 그룹을 업데이트합니다. 이 단계가 완료되면 기본 SMS 작성기에서 바로 MMS 메시지를 전송할 수 있습니다.

기능이 활성화되었는데 대시보드에서 MMS를 찾을 수 없는 이유는 무엇인가요?

MMS는 구독 그룹이 “MMS 활성화”로 간주될 때만 Braze 대시보드에 표시됩니다. 이는 SMS/MMS 메시지 작성기에서 구독 그룹을 선택할 때 MMS 태그로 반영됩니다. 이는 구독 그룹 내 하나 이상의 번호가 MMS 메시지를 전송할 수 있음을 의미합니다.

또한, 원래 MMS가 활성화되지 않았던 짧은 코드의 활성화를 Twilio가 다시 승인해야 하는 특정 상황이 있습니다. 이 승인 프로세스는 몇 주가 걸릴 수 있습니다.

이미지가 포함된 MMS가 전송에 실패하는 이유는 무엇인가요?

일부 SMS 제공업체는 이미지 URL의 Content-Type 헤더를 검증합니다. 이미지가 포함된 MMS가 중단되면, 호스팅된 이미지 URL이 image/png 또는 기타 지원되는 이미지 유형을 반환하는지 확인하세요(예: curl -I <image-url>로 확인). Braze 미디어 라이브러리 또는 올바른 Content-Type을 제공하는 CDN에 에셋을 다시 호스팅하세요.

MMS에서 연락처 카드 이미지가 표시되지 않는 이유는 무엇인가요?

MMS 연락처 카드 사진은 연락처 카드 파일이 수신자의 기기에서 가져올 수 없는 이미지 URL을 참조할 때 렌더링에 실패할 수 있습니다. 휴대폰에서 연락처 카드를 생성하고, 파일을 내보낸 다음, MMS 메시지에서 사용할 수 있도록 미디어 라이브러리에 업로드하세요.

RCS

iOS 기기에서 RCS 메시지가 정확하게 렌더링되지 않는 이유는 무엇인가요?

RCS 메시지는 운영 체제 및 메시징 앱에 따라 iOS 기기에서 다르게 렌더링될 수 있습니다. iOS 기기에서는 다음과 같은 동작이 발생할 수 있습니다:

• 동일한 대화 스레드에 있는 서로 다른 RCS 메시지의 추천 동작이 함께 그룹화되어 잘못된 순서로 표시될 수 있습니다.
• 리치 카드 버튼이나 추천 동작을 탭한 후에도 리치 카드 버튼 및 리치 카드 외부에 있는 추천 동작이 계속 표시될 수 있습니다.
• 리치 카드의 GIF가 정적 이미지로 표시됩니다. 자세한 내용은 iOS에서 RCS 리치 카드의 GIF가 정적으로 표시되는 이유는 무엇인가요?를 참조하세요.

iOS에서 RCS 리치 카드의 GIF가 정적으로 표시되는 이유는 무엇인가요?

iOS에서는 RCS 리치 카드의 GIF가 정적 이미지(첫 번째 프레임)로 표시됩니다. Android에서는 예상대로 애니메이션이 재생됩니다.

이 동작은 iOS 메시징 클라이언트가 제어합니다. Braze 미리보기에서는 GIF가 여전히 애니메이션으로 재생될 수 있습니다. iOS 기기로 테스트 메시지를 전송하여 전달된 메시지가 어떻게 표시되는지 확인하세요.

iOS에 애니메이션 콘텐츠를 전송하려면:

• GIF를 파일로 전송하는 RCS 미디어 메시지를 사용합니다.
• 리치 카드에 비디오를 사용합니다.

RCS로 사전 녹음된 음성 메일을 보낼 수 있나요?

네, 미디어 메시지를 사용하여 오디오 파일을 지원할 수 있습니다.

REST API SMS 옵트인이 SMS/MMS/RCS 성과의 총 옵트인과 일치하지 않는 이유는 무엇인가요?

SMS/MMS/RCS 성과 대시보드의 총 옵트인 및 총 옵트아웃은 인바운드 SMS 키워드 처리에 의해 발생한 구독 변경을 집계합니다(예: 사용자가 짧은 코드로 옵트인 키워드를 문자로 보내는 경우). REST API, 대시보드 또는 기타 소스를 통해 이루어진 모든 구독 업데이트가 포함되는 것은 아닙니다.

소스별 옵트인 및 옵트아웃을 분석하려면 USERS_BEHAVIORS_SUBSCRIPTIONGROUP_STATECHANGE_SHARED에서 쿼리 빌더를 사용하고 STATE_CHANGE_SOURCE(예: Rest API 대 Inbound Message)로 필터링하세요.