클라우드 API

인증 템플릿 보내기

이 문서에서는 일회용 비밀번호 버튼이 있는 승인된 인증 템플릿을 보내는 방법을 설명합니다.

요청

WhatsApp Business 전화번호 > 메시지 엔드포인트를 사용하여 일회용 비밀번호 버튼이 있는 인증 템플릿 메시지를 보내세요.

요청 구문

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

POST 본문

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "template",
  "template": {
    "name": "<TEMPLATE_NAME>",
    "language": {
      "code": "<TEMPLATE_LANGUAGE_CODE>"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "<ONE-TIME PASSWORD>"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "0",
        "parameters": [
          {
            "type": "text",
            "text": "<ONE-TIME PASSWORD>"
          }
        ]
      }
    ]
  }
}

본문 속성

자리 표시자설명샘플 값

<CUSTOMER_PHONE_NUMBER>

고객의 WhatsApp 전화번호입니다.

12015553931

<ONE-TIME PASSWORD>

고객에게 전달될 일회용 비밀번호 또는 인증 코드입니다.


이 값은 페이로드에서 두 번 표시되어야 합니다.


최대 15자입니다.

J$FpnYnP

<TEMPLATE_LANGUAGE_CODE>

템플릿의 언어 및 로캘 코드입니다.

en_US

<TEMPLATE_NAME>

템플릿 이름입니다.

verification_code

응답

요청에 성공 시 API가 다음과 같이 응답합니다.

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "<INPUT>",
      "wa_id": "<WA_ID>"
    }
  ],
  "messages": [
    {
      "id": "<ID>"
    }
  ]
}

응답 내용

자리 표시자설명샘플 값

<INPUT>

문자열

메시지를 전송받은 고객 전화번호입니다. 이는 wa_id와 일치하지 않을 수 있습니다.

+16315551234

<WA_ID>

문자열

메시지를 전송받은 고객의 WhatsApp ID입니다. 이는 input과 일치하지 않을 수 있습니다.

+16315551234

<ID>

문자열

WhatsApp 메시지 ID입니다. 'wamid.' 이후에 나와 있는 ID를 사용하여 메시지 상태를 추적할 수 있습니다.

wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI3N0EyQUJDMjFEQzZCQUMzODMA

예시

요청 예시

curl -L 'https://graph.facebook.com/v19.0/105954558954427/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '{
      "messaging_product": "whatsapp",
      "recipient_type": "individual",
      "to": "12015553931",
      "type": "template",
      "template": {
        "name": "verification_code",
        "language": {
          "code": "en_US"
      },
      "components": [
        {
          "type": "body",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        },
        {
          "type": "button",
          "sub_type": "url",
          "index": "0",
          "parameters": [
            {
              "type": "text",
              "text": "J$FpnYnP"
            }
          ]
        }
      ]
    }
  }'

응답 예시

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "12015553931",
      "wa_id": "12015553931"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI4Qzc5QkNGNTc5NTMyMDU5QzEA"
    }
  ]
}