Enum. Indicates button type. Set to COPY\_CODE if you want the template to use a copy code button, or ONE\_TAP to have it use a one-tap autofill button.
` | String. Copy code button text.
Note that even if your template is using a one-tap autofill button, this value must still be supplied. If Meta's unable to validate your handshake the authentication template message will display a copy code button with this text instead.
Maximum 25 characters.
| `'Copy Code'` |
| `` | One-tap buttons only.
String. One-tap button text.
Maximum 25 characters.
| `'Autofill'` |
| `` | One-tap buttons only.
Your Android app's package name.
| `'com.example.myapplication'` |
| `` | One-tap buttons only.
Your app signing key hash. See Meta's Official documentation for App Signing Key Hash.
| `'K8a%2FAINcGX7'` |
**Sample request with components descriptions**
```json
{
"name": "sample",
"language": "es_ES",
"category": "AUTHENTICATION",
"components": [
{
"type": "BODY",
"add_security_recommendation": "" /*#Optional*/
},
{
"type": "FOOTER",
"code_expiration_minutes": "" /*Optional*/
},
{
"type": "BUTTONS",
"buttons": [
{
"type": "OTP",
"otp_type": "",
"text": "",
"autofill_text": "", /*One-tap buttons only*/
"package_name": "", /*One-tap buttons only*/
"signature_hash": "" /*#One-tap buttons only*/
}
]
}
],
}
```
**Sample Copy Code Button Components Value**
```json
[
{
"type": "BODY",
"add_security_recommendation": true
},
{
"type": "FOOTER",
"code_expiration_minutes": 5
},
{
"type": "BUTTONS",
"buttons": [
{
"type": "OTP",
"otp_type": "COPY_CODE",
"text": "Copy Code"
}
]
}
]
```
**Sample One-tap Autofill Button Components Value**
```json
[
{
"type": "BODY",
"add_security_recommendation": true
},
{
"type": "FOOTER",
"code_expiration_minutes": 5
},
{
"type": "BUTTONS",
"buttons": [
{
"type": "OTP",
"otp_type": "ONE_TAP",
"text": "Copy Code",
"autofill_text": "Autofill",
"package_name": "com.example.myapplication",
"signature_hash": "K8a%2FAINcGX7"
}
]
}
]
```
#### Example Response
Upon success, the API will respond with a JSON object describing the newly created template.
```json
{
"id": "594425479261596",
"status": "PENDING",
"category": "AUTHENTICATION"
}
```
## Sending Authentication Templates
`POST` `https://waba-v2.360dialog.io/messages`
#### Request Body
| Name | Type | Description |
| ------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| name | String | |
| type | String | Message type |
| to | String | Recipient wa\_id |
| messaging\_product | String | Required only for Cloud API.
Messaging service used for the request. Use "whatsapp".
|
| components | String | |
| language | String | |
{% tabs %}
{% tab title="201: Created " %}
```
{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "12015553931",
"wa_id": "12015553931"
}
],
"messages": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI4Qzc5QkNGNTc5NTMyMDU5QzEA"
}
]
}
```
{% endtab %}
{% endtabs %}
| Placeholder | Description | Sample Value |
|---|
<CUSTOMER_PHONE_NUMBER> | The customer's WhatsApp phone number. | 12015553931 |
<ONE-TIME PASSWORD> | The one-time password or verification code to be delivered to the customer.
Note that this value must appear twice in the payload. | J$FpnYnP |
<TEMPLATE_LANGUAGE_CODE> | The template's language and locale code. | en_US |
<TEMPLATE_NAME> | The template's name. | verification_code |
**Sample payload with Copy Code Button**
```json
{
"messaging_product": "whatsapp",
"to": "",
"type": "template",
"template": {
"name": "",
"language": {
"code": ""
},
"components": [
{
"type": "body",
"parameters": [
{
"type": "text",
"text": ""
}
]
},
{
"type": "button",
"sub_type": "url",
"index": 0,
"parameters": [
{
"type": "text",
"text": "COPY_CODE"
}
]
}
]
}
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.360dialog.com/docs/resources/authentication-messages.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
