계정
/v1/account
WhatsApp에서는 온프레미스 API를 사용 중단하고 있습니다. 이 엔드포인트는 더 이상 비즈니스 전화번호를 등록하는 데 사용되지 않으며 다음과 같은 오류를 반환합니다.
{
"code": 1005,
"title": "Access denied",
"details": "Unknown error: biz_link_on_prem_reg_blocked"
}
account 노드는 WhatsApp Business API 클라이언트를 등록하는 데 사용됩니다.
이미 다른 전화번호가 등록되어 있는 클러스터에 새 전화번호를 등록하면 Coreapp이 다시 시작되므로 유의하시기 바랍니다.
에지
이 노드와 연결되는 에지는 다음과 같습니다.
| 에지 | 설명 |
|---|---|
지정된 방법으로 등록 코드를 받은 다음에는 이 에지를 사용하여 계정 등록을 완료합니다. |
시작하기 전에
다음과 같은 항목이 필요합니다.
- 서비스에 로그인할 수 있는 인증 토큰
- 해당 전화번호와 연결된 WhatsApp에서 승인한 표시 이름
Base64 인코딩 인증서 복사
Base64 인코딩 인증서 문자열이 생성되어 WhatsApp Business API 클라이언트 등록 시 유효성 검증에 사용됩니다.
- Meta 비즈니스 관리자의 비즈니스 설정으로 이동합니다.
- 계정 메뉴의 WhatsApp 계정을 클릭한 후 WhatsApp 계정 리스트에서 WhatsApp 계정이 선택되지 않은 경우 해당 계정을 선택합니다.
- 설정 탭으로 이동하여 WhatsApp 관리자 버튼을 클릭합니다.
- 전화번호 탭에서 전화번호가 등록된 것을 확인할 수 있습니다. 인증서를 얻으려는 전화번호의 보기 버튼을 클릭합니다.
인증서 가져오기 - 팝업 대화 상자의 회색 상자에 인증서 문자열이 표시됩니다. 인증서 가져오기를 클릭합니다.
인증서 문자열 다운로드 account엔드포인트로 등록할 때cert매개변수에서 이 인증서 문자열을 사용합니다.
자세한 내용은 표시 이름 문서를 참조하세요.
제약 사항
- 앱에 등록하려면
admin계정을 사용해야 합니다. - 계정을 다시 등록할 경우, 등록이 완료되면 Coreapp을 다시 시작해야 합니다.
요청
이 엔드포인트로 POST 호출을 보내서 등록 코드를 요청합니다. 호출에 전화번호와 base64 인코딩 인증서 문자열을 추가합니다. SMS 또는 음성 통화로 코드를 수신할 수 있습니다.
예
POST /v1/account
{
"cc": "COUNTRY_CODE",
"phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
"method": "sms" or "voice",
"cert": "VERIFIED_NAME_CERT_IN_BASE64",
"pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}
수신한 응답에 따라 등록 절차는 완료된 것으로 간주하거나 완료하는 데 다른 절차가 필요할 수도 있습니다. 성공하면 다음 HTTP 상태 코드 중 하나를 수신하게 됩니다. 수신한 응답과 일치하는 지침을 따르세요.
201 Created— 계정이 이미 존재합니다. 등록되어 있으므로 다른 절차가 필요하지 않습니다.202 Accepted— 계정이 존재하지 않습니다. 요청에서 선택한 방법에 따라 SMS 또는 음성 통화로 등록 코드를 확인하세요. 이 응답에서 반환하는 페이로드는 적절한 표시 이름이 설정되었는지 확인하기 위한cert매개변수에서 디코딩한vname이 포함됩니다. 적절한 이름이 설정되었다면 계정 등록 완료로 넘어가 등록을 완료하세요.
{
"account": [{
"vname": "decoded-vname-from-cert"
}]
}
오류가 반환될 경우 자세한 내용은 오류 및 상태 메시지를 참조하세요.
매개변수
| 이름 | 설명 |
|---|---|
| 필수 항목. 등록하려는 전화번호의 숫자로 된 국가 번호 |
| 필수 항목. 등록하려는 전화번호(국가 번호 또는 플러스( |
| 필수 항목. 등록 코드를 수신하는 방법 |
| 필수 항목. Base64 인코딩 인증서 |
| 선택 사항. 기존 6자리 PIN — 이 계정에서 2단계 인증이 활성화되었을 때만 필요합니다. |
2단계 인증 PIN 변경
비즈니스 전화번호의 2단계 인증 PIN을 변경하는 방법은 다음과 같습니다.
- WhatsApp 관리자에서 비즈니스 포트폴리오를 읽어들입니다.
- 전화번호 패널을 자동으로 읽어들이지 않을 경우 계정 도구(도구 상자 아이콘) > 전화번호로 이동합니다.
- 전화번호의 설정(톱니바퀴) 아이콘을 클릭합니다.
- 2단계 인증을 클릭합니다.
- PIN 변경을 클릭하고 플로를 완료합니다.
PIN을 변경하려면 현재의 PIN을 입력해야 합니다. Meta의 API를 사용하여 새로운 PIN을 설정할 수도 있습니다.
2단계 인증 비활성화
2단계 인증을 비활성화하려면 PIN 변경 단계를 따르되, 대신 마지막 단계에서 2단계 인증 비활성화 버튼을 클릭하세요. 링크가 포함된 이메일이 비즈니스 포트폴리오와 연결된 이메일 주소로 전송됩니다. 이 링크를 사용하여 2단계 인증을 비활성화합니다. 2단계 인증을 비활성화한 후에 새로운 PIN을 설정하여 다시 활성화할 수 있습니다.
FAQ
예, 운영을 시작할 때 새 전화번호를 설정하거나 인증된 이름을 변경할 수 있습니다.
국가 번호가 포함되어 있다면 수신자 부담 전화번호를 사용할 수 있습니다. 국가 번호가 없는 수신자 부담 번호는 고유하게 식별할 수 없기 때문입니다(같은 번호가 두 국가에 해당될 수 있음).
또한 수신자 부담 번호와 관련된 부가적인 복잡성 문제가 있다는 점도 유의해야 합니다. 일반적으로, 국가 번호를 포함한 수신자 부담 번호로 해당 국가의 국내에서 전화를 걸면 연결되지 않습니다. 이것은 다시 말해 국내 고객이 비즈니스 연락처에 표시된 번호(국가 번호 포함)로 전화할 때 연락이 닿지 않을 가능성이 있다는 뜻입니다. 이런 상황이 우려되는 경우, 그러한 사실을 확실히 알려야 합니다.
수신자 부담 번호에 대한 자세한 내용은 여기를 참조하세요.
현재 설정을 백업하고 새 기기에서 복원할 경우, 구현과 함께 등록 정보도 이동합니다. 자세한 내용은 백업 및 복원 설정 문서를 참조하세요.
Facebook 비즈니스 관리자의 WhatsApp 계정에서 새 전화번호를 등록하고 기존 전화번호를 삭제할 수 있습니다.
- WhatsApp 계정에서 설정으로 이동합니다.
- WhatsApp 관리자를 클릭합니다.
- 전화번호 탭을 클릭합니다. 여기에서 이 계정의 모든 전화번호를 관리할 수 있습니다.
시도 횟수를 초과해서 "sms" 등록이 실패하고 "access denied" 메시지가 나왔다면 "음성" 등록을 시도하세요.