WhatsApp 营销模板
营销模板承载推广内容,例如优惠、产品公告或优惠券。发送前,请准备好已获批准的内容、收件人许可,以及处理回复和退订的明确方式。
WhatsApp Studio 每次只向一位收件人发送。群发可以从控制台将营销模板发送给整个受众。如需规划营销活动,请参阅 WhatsApp Studio 与营销活动。
发送前的准备
Bird 的托管模板目录中没有任何营销模板,因此营销发送始终使用由您的工作区创建的模板,并且必须使用您自己的 WhatsApp Business Account:
- 连接您自己的 WhatsApp Business Account 和号码。请参阅号码设置。
- 创建营销模板并提交审核。哪些内容可以通过审核,请参阅模板指南。
- 使用与模板属于同一 WhatsApp Business Account 的号码发送。营销发送必须提供
from;如果发送方属于其他账户,请求会在产生任何费用之前被拒绝,422E15023WhatsAppSenderWABAMismatch。
发送营销模板
调用 POST /v1/whatsapp/messages,设置 from,并提供一个指定您自己 slug 的 template 对象:
const msg = await bird.whatsapp.send({
to: "+16505551234",
from: "+13125550101",
template: {
slug: "summer_sale",
language: "en",
parameters: {
header_url: "https://cdn.example.com/banners/summer.png",
first_name: "Pablo",
code: "SUMMER25",
},
},
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+16505551234",
from_="+13125550101",
template="summer_sale",
language="en",
parameters={
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25",
},
)
print(msg.id, msg.status)package main
import (
"context"
"fmt"
"log"
"os"
bird "github.com/messagebird/bird-sdk-go"
"github.com/messagebird/bird-sdk-go/option"
)
func main() {
client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
if err != nil {
log.Fatal(err)
}
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+16505551234",
From: "+13125550101",
Template: "summer_sale",
Language: "en",
Parameters: map[string]any{
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25",
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+16505551234',
from: '+13125550101',
template: 'summer_sale',
language: 'en',
parameters: [
'header_url' => 'https://cdn.example.com/banners/summer.png',
'first_name' => 'Pablo',
'code' => 'SUMMER25',
],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--from +13125550101 \
--language en \
--parameters '{"code":"SUMMER25","first_name":"Pablo","header_url":"https://cdn.example.com/banners/summer.png"}' \
--template summer_sale \
--to +16505551234curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+16505551234",
"from": "+13125550101",
"template": {
"slug": "summer_sale",
"language": "en",
"parameters": {
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25"
}
}
}'- 正文变量使用命名方式,与实用类模板相同,因此
first_name是一个独立的键。 - 优惠券按钮的代码放在
code中,如上例所示。没有单独的优惠券键。 - 媒体标头使用
header_url,无论是图片、视频还是gif。省略它则发送模板已获批准的示例。从 Meta 导入的模板没有示例,因此必须提供header_url。营销是唯一接受动态 GIF 标头的类别。 - 轮播卡片的媒体和带编号的 URL 后缀使用带编号的键:第一张卡片用
header_url_1和button_url_1,第二张卡片用header_url_2,依此类推。卡片内的变量使用命名方式。在两张卡片中使用同一个名称时,它是同一个键,因此两张卡片获得相同的值。如果轮播的每张卡片都编号了{{1}},则只接受components,值放在cards上,并且该次发送必须提供与模板获批时完全相同数量的卡片。
Bird 会自动将每次营销发送路由到 Meta 的 Marketing Messages API;您无需选择加入,也没有按次发送的开关。企业账户在该 API 中的接入状态决定能否使用 Meta 的优化功能,而不决定能否投递,但 gif 标头除外,它需要已完成接入的账户。有关账户状态、接入后可用的功能以及营销在哪些国家/地区受限,请参阅营销模板。
退订
当 Bird 收到来自 Meta 的有效营销停止事件时,会为该企业账户记录一条收件人偏好。此偏好与针对所有消息的屏蔽相互独立。发送前请检查这两类记录。投递失败可能先于对应的偏好事件到达;此时请保留收件人的选择并调查该历史记录,而不是重试。有关记录和读取这些记录的方法,请参阅偏好设置。
费用
按目的地和币种使用公布的营销费率,或者设置最高价格,让 Meta 的投递费用在您设定的上限内浮动。Bird 在提交前收取出站费用;可计费的投递或已读结果可能会额外产生 Meta 的费用。请参阅费用与计费和 WhatsApp 定价。
注意事项
- 价格由 Meta 的类别决定。 Meta 可能在批准后将促销内容重新归类为营销类别。发送前请检查每种语言当前的类别;按最高价格发送要求类别为营销。如果您不同意分类结果,请参阅 Meta 的类别审核流程。
131049表示投递暂停,而不是您配置的请求速率限制,重试会使情况更糟。 Meta 在其针对美国的全面暂停和针对单个用户的营销上限两种情况下都会报告131049,其官方建议是等待大约一天后再重新发送。过早重新发送可能使该账户在更长时间内无法触达该收件人,并拉低您自己的投递率。Bird 会将该失败报告为rate_limited。131050表示收件人已关闭 "Offers and announcements",绝不能重试。 Meta 会接受这次发送,然后拒绝投递。正确的处理方式是走消息偏好流程,而不是重新发送:自行屏蔽该收件人,或等待对方重新启用投递。Bird 会通过报告退订的同一偏好机制获知重新启用。参见 Preferences。132015和132016表示模板被暂停,而不是收件人的问题。132015是因质量低而暂停;132016是多次暂停后的永久停用,唯一的解决办法是用不同内容创建新模板。请检查该语言自身的状态,而不是模板的状态,因为被暂停的语言会立即停止发送。- 使用错误 WhatsApp Business Account 上的发送方,会在产生任何费用前被拒绝。
from必须与模板位于同一账户,否则发送会失败422E15023WhatsAppSenderWABAMismatch。
后续步骤
- WhatsApp 模板:浏览模板目录,以及通用的按模板发送约定
- 营销模板:Marketing Messages API、接入状态,以及营销消息受限的地区
- 偏好:记录和读取收件人的偏好声明
- 实用模板:订单更新、预约提醒和账户通知