다른 비즈니스에서 사용할 앱을 개발하는 경우 기술 제공업체를 위한 시작하기 또는 솔루션 파트너를 위한 시작하기 가이드를 참조하세요.
시작하기
이 가이드는 클라우드 API를 사용하여 첫 메시지를 주고받는 데 도움을 줍니다. 샘플 앱과 함께 사용할 Webhooks를 구성하는 방법도 알아보게 됩니다.
이 가이드는 직접 앱을 개발하거나 조직을 위해 앱을 개발하는 개발자를 위해 작성되었습니다. 다른 비즈니스에서 사용할 앱을 개발하는 경우 솔루션 파트너를 위한 시작하기 또는 기술 제공업체를 위한 시작하기 문서를 참조하세요.
시작하기 전에
다음과 같은 항목이 필요합니다.
- Meta 개발자 계정 — Meta 개발자로 등록하는 방법에 대해 자세히 알아보세요.
- 비즈니스 앱 — 앱 만들기에 대해 자세히 알아보세요. 비즈니스 앱을 만드는 옵션이 보이지 않으면 기타 > 다음 > 비즈니스를 선택하세요.
1단계: WhatsApp 제품을 Product 앱에 추가
현재 이미 새 앱을 만들었다면 앱에 제품 추가라는 메시지가 표시됩니다. WhatsApp 아래로 스크롤하여 설정을 선택합니다. 혹은 내 앱 화면에서 앱을 선택하면 다시 동일한 지침에 따라 WhatsApp을 앱에 추가할 수 있습니다.
Meta Business 계정(MBA)이 있는 경우 앱에 WhatsApp 제품을 추가할 때 계정을 연결하라는 메시지가 표시됩니다. MBA가 없는 경우 계정을 만드는 데 도움이 되는 몇 가지 메시지에 따라 진행하게 됩니다. MBA가 앱에 연결되고 나면 테스트를 시작할 수 있습니다.
WhatsApp 제품을 앱에 추가하면 다음과 같은 몇 가지 장점이 있습니다.
- Meta Business 계정이 없을 경우 계정을 만들라는 메시지가 표시됩니다.
- 테스트 WhatsApp Business 계정이 자동으로 생성됩니다. 이 계정에는 제한 사항이 있고, 메시지 비용을 지불하지 않으므로 테스트 및 개발 목적으로 사용해야 합니다.
- WhatsApp Business 계정과 연결된 테스트 비즈니스 전화번호를 만듭니다. 이 번호를 사용하면 최대 5명의 받는 사람 전화번호로 무료 메시지를 보낼 수 있습니다.
- 사전 승인된 메시지 템플릿 세트를 만듭니다.
2단계: 받는 사람 전화번호 추가
테스트 메시지를 보낼 수 있는 유효한 WhatsApp 전화번호를 추가합니다.
앱 대시보드의 왼쪽 메뉴에서 WhatsApp > API 설정으로 이동합니다. 메시지 보내기 및 받기 아래에서 To 필드를 선택하고 전화번호 리스트 관리를 선택합니다.
유효한 WhatsApp 전화번호를 받는 사람으로 추가할 수 있습니다. 받는 사람 전화번호는 번호를 인증하는 데 사용할 수 있는 인증 코드를 WhatsApp에서 받게 됩니다.
받는 사람 전화번호를 인증하고 나면 이제 To 필드에서 선택할 수 있습니다. 다른 받는 사람을 추가하고 싶다면 이 과정을 반복하세요(최대 5회).
3단계: 테스트 메시지 보내기
사전 승인된 hello_world 템플릿 메시지를 자신이 선택한 받는 사람 전화번호로 보냅니다.
WhatsApp > API 설정 패널:
- 테스트 비즈니스 전화번호가 From 필드에서 선택되었는지 확인합니다.
- 메시지를 보내고자 하는 받는 사람 전화번호가 To 필드에서 선택되었는지 확인합니다. 여러 전화번호가 추가된 경우 한 번에 여러 개의 메시지를 보낼 수 있습니다.
- API를 통해 메시지 보내기 패널에서 메시지 보내기 버튼을 클릭합니다.
또는 cURL 명령을 복사한 다음, 새 터미널 창에 붙여넣고 실행합니다.
이 코드는 템플릿 메시지(”type”:”template”)를 보내고 있고, 사용할 특정 템플릿(”name”:”hello_world”)을 확인 중임을 나타냅니다.
4단계: 샘플 앱 복제 및 Webhooks 구성
Webhooks를 사용하면 특정 개체에 대한 변경 사항을 실시간 HTTP 알림으로 받을 수 있습니다. WhatsApp에서 Webhooks는 메시지 전달, 읽음 알림, 나아가 계정 변경 사항 등과 같이 앱에서 일어나는 여러 이벤트를 알릴 수 있습니다.
Webhooks 내용을 볼 수 있도록 콜백 URL을 추가합니다. Webhooks 테스트를 위한 샘플 콜백 URL 가이드에 따라 샘플 앱을 복제합니다. 이 앱이 Webhooks 알림을 수락하고 JSON 페이로드를 화면에 표시합니다.
Webhooks가 설정되고 나면 템플릿 메시지를 다시 보내고 답장을 보냅니다. 별도의 Webhooks 알림 4개(메시지 전송, 전달됨, 읽음 알림, 수신되는 메시지 내용)가 표시됩니다. 잘하셨습니다!
5단계: (선택 사항) 실제 비즈니스 전화번호 추가
테스트 비즈니스 번호와 테스트 WhatsApp 비즈니스 계정이 있으면 앱 개발을 시작할 수 있습니다. 이러한 테스트 자산을 사용할 경우 앱을 개발하는 동안 메시지 전송 비용을 지불하지 않습니다.
고객에게 메시지를 보낼 준비가 되면 API 설정 패널에 실제 비즈니스 전화번호를 추가하고 실제 WhatsApp Business 계정을 만들 수 있습니다.