Programmable Messaging에서 Verify API로 마이그레이션하기

Twilio의 Programmable Messaging API로 자체 OTP 솔루션을 운영하던 서비스가 Verify API로 전환하는 방법을 코드 예시와 함께 설명한다. Verify는 OTP 전송·검증을 위한 전용 API로, 전화번호 구매, 토큰 생성, DB 저장·만료 관리를 내부에서 처리해 개발자가 직접 구현할 코드를 크게 줄인다.

핵심 포인트

Verify API는 토큰 생성·저장·만료를 자체 처리해, 기존 Programmable Messaging 대비 직접 작성해야 할 코드가 대폭 줄어든다.
전화번호 풀을 Verify가 관리하므로 A2P 10DLC 등록이 면제되고 글로벌 컴플라이언스도 자동으로 처리된다.
Fraud Guard로 SMS 트래픽 펌핑을 자동 차단하며, SMS·RCS·WhatsApp·이메일·TOTP 멀티채널을 단일 API로 지원한다.
전환 후 전화번호 포맷이 Programmable Messaging보다 엄격해 반드시 E.164 형식이 필요하다.
검증 코드 유효 시간은 10분이며 이 기간 중 재전송해도 동일 코드가 반환된다.

상세 정리

기존 Programmable Messaging 흐름: 전화번호 구매 -> Math.random()으로 6자리 토큰 생성 -> DB에 저장(storeToken) -> 발송 -> 만료 확인 순서로 수동 처리가 많다.
Verify send 코드: client.verify.services(SERVICE_SID).verifications.create({to, channel: 'sms'}) 한 줄로 대체, from 번호 불필요.
Verify check 코드: client.verify.services(SERVICE_SID).verificationChecks.create({to, code}) 후 check.status === 'approved' 확인. DB에서 토큰을 꺼낼 필요 없다.
Verify Service 생성: API 또는 콘솔에서 1회 생성하며 코드 길이(4~10자), 발신자 이름, "공유 금지 경고" 등을 설정할 수 있다.
커스텀 코드 옵션: customCode 파라미터로 자체 OTP 코드를 사용할 수 있으나 Verify 내장 생성을 권장한다.
전화번호 포맷 주의: Programmable Messaging은 공백 등 비표준 포맷을 허용했지만 Verify는 E.164(+15552317654) 필수. Lookup API로 정규화를 권장한다.
국가 허용/차단 리스트: 글로벌 서비스는 전체 허용, 지역 제한이 필요하면 allowlist/blocklist를 서비스 설정에서 적용한다.
에러 코드 차이: PM과 다른 에러 코드 체계. 60200(잘못된 파라미터), 60203(최대 발송 시도 초과) 등을 별도 매핑해야 한다.
속도 제한: 전화번호당 10분 내 5회 발송, 5회 확인이 기본값이며 서비스 레벨에서 추가 제한을 설정할 수 있다.
가격: 확인된 검증 1건당 $0.05, 전화번호 풀과 Fraud Guard 비용이 포함된 가격이다.