WhatsApp 개체
whats_app
개체를 사용하면 메시징 엔드포인트를 통해 WhatsApp 메시지를 수정하거나 생성할 수 있습니다.
WhatsApp 개체
1
2
3
4
5
6
7
| {
"app_id": (required, string) see App Identifier,
"subscription_group_id": (required, string) the ID of your subscription group,
"message_variation_id": (optional, string) used when providing a campaign_id to specify which message variation this message should be tracked under,
"message_type": (required, string) the type of WhatsApp message being sent under the `message` key (template_message | text_response_message | text_image_response_message | quick_reply_response_message),
"message": (required, object) message object specifying fields the required fields based on the specified message_type. See Message Types for field specifications.
}
|
메시지 유형
template_message
1
2
3
4
5
6
7
8
| {
"template_name": (required, string) the WhatsApp template name for the message,
"template_language_code": (required, string) the language code of the WhatsApp template for the message,
"header_variables": (optional, header variables object) an object to specify header variable values for specified template_name, required if the header has variables; see object specification below,
"body_variables": (optional, body variable object) an object to specify body variable values for specified template_name, required if the body has variables; see object specification below,
"button_variables": (optional, button variables object) an object to specify button variable values for specified template_name, required if buttons have variables; see object specification below,
"header_image_uri" :(optional, string) URI to the header image, if the header is of type IMAGE in specified template_name
}
|
헤더 변수 객체
header_variables
개체를 사용하면 WhatsApp 템플릿에서 헤더 변수의 값을 지정할 수 있습니다. 각 키는 지정된 값으로 대체할 WhatsApp 템플릿 변수 인덱스(인덱되지 않음)입니다.
1
2
3
| {
"$TEMPLATE_VARIABLE_INDEX_0": "$TEMPLATE_VARIABLE_VALUE_0"
}
|
현재 헤더 변수는 0 또는 하나만 지정할 수 있습니다.
예시
1
2
3
| {
"0": "Check it out!"
}
|
본문 변수 개체
body_variables
개체를 사용하면 WhatsApp 템플릿에서 본문 변수의 값을 지정할 수 있습니다. 각 키는 지정된 값으로 대체할 WhatsApp 템플릿 변수 인덱스(인덱되지 않음)입니다.
1
2
3
4
| {
"$TEMPLATE_VARIABLE_INDEX_0": "$TEMPLATE_VARIABLE_VALUE_0",
"$TEMPLATE_VARIABLE_INDEX_1": "$TEMPLATE_VARIABLE_VALUE_1"
}
|
예시
1
2
3
4
| {
"0": "Check it out!",
"1": "It's pretty neat."
}
|
버튼 변수 개체
button_variables
개체를 사용하면 WhatsApp 템플릿에서 버튼 변수에 대한 값을 지정할 수 있습니다. 각 키는 지정된 값으로 대체할 WhatsApp 템플릿 변수 인덱스(인덱되지 않음)입니다.
1
2
3
| {
"$TEMPLATE_VARIABLE_INDEX_1": "$TEMPLATE_VARIABLE_VALUE_1",
}
|
현재 버튼 변수는 콜투액션 URL의 경로 구성 요소인 버튼 변수 하나만 지정할 수 있습니다. 변수 인덱스는 템플릿의 CTA URL 버튼 인덱스와 일치해야 합니다. 예를 들어 CTA 버튼이 템플릿의 두 번째 버튼인 경우 가변 인덱스 “1”을 사용합니다.
예시
1
2
3
| {
"1": "/marketing/promotion123"
}
|
text_response_message
1
2
3
4
| {
"body": (required, string) the body of the message to send,
"preview_url": (optional, boolean) whether WhatsApp should render a preview of links included in body
}
|
예시
1
2
3
4
| {
"body": "Check out our new deals at https://braze.com",
"preview_url": true
}
|
text_image_response_message
1
2
3
4
| {
"image_uri": (required, string) the uri of the image to send,
"caption": (optional, string) the caption for the image being sent
}
|
예시
1
2
3
4
| {
"image_uri": "https://braze.com/promotion.jpg",
"caption": "This won't last for long, check it out!"
}
|
quick_reply_response_message
1
2
3
4
5
6
7
| {
"body": (required, string) the body of the message to send,
"header_image_uri": (optional, string) the URI of the image to send as the message header (only valid if header_text not present),
"header_text": (optional, string) the text to send as the message header (only valid if header_image_uri not present),
"footer": (optional, string) the footer of the message to send,
"buttons": (required, array) array of Button objects. Will render in message based on order in array.
}
|
버튼 개체
1
2
3
| {
"text": (required, string) the text of the button
}
|
예시
1
2
3
4
5
6
7
8
9
10
11
| {
"body": "Want to keep hearing from us?",
"buttons": [
{
"text": "Yes!"
},
{
"text": "No thanks"
}
]
}
|