🌐 Advanced Opt-Out 설정 가이드 (한글 번역)
✨ Advanced Opt-Out란?
Advanced Opt-Out 기능을 사용하면, 고객이 SMS 수신을 동의하거나 거부하는 키워드와 응답 메시지를 전 세계 언어와 국가별로 맞춤 설정할 수 있습니다. 이 기능은 Messaging Service에 포함된 발신번호 전체에 적용됩니다.
✅ 기본 제공되는 키워드
Twilio는 다음의 기본 키워드를 인식합니다:
- 수신 거부 (Opt-Out):
STOP,UNSUBSCRIBE,END,QUIT,STOPALL,CANCEL - 수신 동의 (Opt-In):
START,UNSTOP - 도움말 (Help):
HELP
2025년 4월 29일부터는 REVOKE, OPTOUT도 기본 Opt-Out 키워드로 포함됩니다.
🛠 설정 순서
1. Messaging Service 생성
const service = await client.messaging.v1.services.create({
friendlyName: "My First Messaging Service",
});2. SMS 발신 가능한 번호 구매 및 연결
- Twilio Console에서 구매
- 번호의 SID (
PNxxx)를 Messaging Service에 연결
await client.messaging.v1.services("MGxxx").phoneNumbers.create({
phoneNumberSid: "PNxxx"
});3. Advanced Opt-Out 활성화
- Twilio Console > Messaging > Services > Opt-Out Management 섹션
- "Enable Advanced Opt-Out" 클릭
⚠ 활성화 이후 비활성화는 Support 요청 필요
🔤 키워드 커스터마이징 방식
▪ 표준 키워드(Standard Keywords)
- 모든 국가에 공통 적용되는 키워드와 응답 메시지
▪ 언어별 키워드(Language-specific)
- 예: 스페인어 사용자에게는
SALIR입력 시 스페인어 응답 전송
▪ 국가 코드별 키워드(Country-specific)
- 특정 국가 번호(예:
+82)에만 다른 키워드와 메시지 지정 - 언어별 중복 키워드는 허용되지 않음
📌 Toll-Free 번호 주의사항
- Toll-Free 번호는 항상
STOP으로 수신 거부 처리됨 (커스텀 메시지 무시) START또는UNSTOP으로만 차단 해제 가능
🧾 사용자 상태 추적하기
- 사용자 메시지가 키워드와 일치하면 Twilio는 webhook으로
OptOutType포함하여 알림 OptOutType값:START,STOP,HELP- Twilio가 이미 응답했기 때문에, 별도 메시지를 다시 보내는 것은 권장되지 않음
📚 다음 단계
SoftwareEngineer