시작하기
이 가이드는 클라우드 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 계정을 만들 수 있습니다.