온프레미스 API 지원 종료

WhatsApp Business 플랫폼은 향후 2년에 걸쳐 차세대 클라우드 API로 완전히 전환합니다.

온프레미스 API 클라이언트의 최종 지원 버전은 2025년 10월 23일에 만료됩니다. 이 API는 그 시점까지 계속 사용할 수 있지만, 클라우드 API로 더욱 원활하게 전환하고 새로운 클라우드 API 전용 기능을 활용할 수 있도록 최대한 이른 시일 내에 온프레미스 API를 클라우드 API로 마이그레이션하시는 것이 좋습니다.

이 문서는 지원 종료와 관련된 정보가 공개되는 대로 업데이트될 예정이므로, 정기적으로 확인하시기 바랍니다.

클라우드 API를 사용해야 하는 이유

클라우드 API는 2022년에 출시된 이후로 적극적으로 채택되고 온프레미스 API보다 더 나은 성능을 보여주었습니다. 그 이유는 다음과 같습니다.

비용 효율성: 설정, 호스팅 및 유지관리 비용이 감소했습니다. 예를 들어 일부 파트너는 클라우드 API로 이동한 후 인프라 비용이 90% 이상 절감되었습니다.
확장성 향상: 클라우드 API는 가장 처리 속도가 빠른 플랫폼으로, 초당 최대 1,000건의 메시지를 처리합니다(온프레미스 API의 4배 수준).
안정성 향상: 클라우드 API는 가동 시간 99.9%와 5초 미만 p99 지연 시간을 일관되게 제공합니다. 가동 시간 및 지연 시간 상태는 WhatsApp Business API 상태 페이지를 참조하세요.
보안 및 인증: 클라우드 API는 GDPR 및 LGPD 규정 준수, SOC2 및 SOC3 인증과 같은 엔터프라이즈급 보안 기능과 인증을 획득하였으며, 현재 ISO 27001 인증을 추진 중입니다. 클라우드 API 규정 준수 센터와 보안 및 암호화 백서를 참조하세요.
로컬 스토리지 옵션: 이제 클라우드 API는 로컬 스토리지를 지원함으로써 저장 상태의 메시지 데이터가 저장되는 위치를 제어하는 옵션을 제공합니다.
클라우드 전용 기능: 클라우드 API는 새로 출시된 기능과 클라우드 API 전용으로 예정된 기능을 제공하므로, 온프레미스 API보다 기능성이 더욱 우수합니다.

WhatsApp에서는 이러한 엔터프라이즈급 메시지 기반을 구축했으므로, 완전히 클라우드에서 호스팅되는 WhatsApp Business 플랫폼으로 전환하기로 결정하였습니다.

지원 종료 일정

2024년 1월 9일

2024년 1월에 온프레미스 API v2.53이 출시된 이후부터 모든 새로운 기능 업데이트는 클라우드 API에만 적용됩니다. 온프레미스 API 클라이언트는 앞으로도 분기별 버전 릴리스가 적용되겠지만 버그 수정 사항 및 보안 패치만 제공됩니다.

2024년 7월 1일

비즈니스 전화번호는 클라우드 API에만 사용하도록 등록할 수 있습니다. 온프레미스 Premises API에 사용할 번호를 등록하려고 시도하면 오류 코드 1005가 반환됩니다.

2025년 10월 23일

온프레미스 API의 최종 버전(v2.63)이 만료됩니다. 아직 온프레미스 API에 사용하도록 등록되어 있는 비즈니스 전화번호와 주고받은 메시지는 전달되지 않습니다.

클라우드 API로의 마이그레이션

마이그레이션 지침과 두 API의 차이에 대한 자세한 내용은 온프레미스 API에서 클라우드 API로 마이그레이션 문서를 참조하세요.

마이그레이션 지원

궁금한 점이 있거나 마이그레이션에 도움이 필요한 경우, 다음과 같이 기술 지원 티켓을 제출하세요.

주제: WABiz: 클라우드 API
요청 유형: 온프레미스 API -> 클라우드 API 마이그레이션 문제

이용 약관

클라우드 API 약관을 참조하세요.