我们将弃用本地 API。请参阅我们的本地 API 弃用文档,了解弃用详情以及如何迁移到我们的下一代云端 API。
目录消息是自由格式的消息,您可通过目录消息在 WhatsApp 中完整地展示商品目录。
目录消息会显示您选择用作标题图片的商品缩略图、自定义正文文本、固定文本标题、固定文本子标题,以及一个查看目录按钮。
当客户点按查看目录按钮时,系统随即会在 WhatsApp 中显示您的商品目录。
您必须将库存上传到 Meta 的电子商务目录,并将该目录与您的 WhatsApp Business 商业帐号关联。
该功能在印度不可用。
使用 WhatsApp Business 电话号码 > 消息端点发送目录消息。
POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<TO>", "type": "interactive", "interactive" : { "type" : "catalog_message", "body" : { "text": "<BODY_TEXT>" }, "action": { "name": "catalog_message", "parameters": { "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>" } }, /* Footer object is optional */ "footer": { "text": "<FOOTER_TEXT>" } }
占位符 | 描述 | 值示例 |
---|---|---|
字符串 | 必要。 消息正文中显示的文本。 不超过 1,024 个字符。 |
|
字符串 | 可选。 消息页脚中显示的文本。 不超过 60 个字符。 |
|
字符串 | 必要。 商品的 SKU 编号。在电商管理工具中标记为内容编号。 此商品的缩略图将用作消息的标题图片。 如果您省略了 |
|
字符串 | 客户的电话号码。 |
|
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "16505551234", "type": "interactive", "interactive": { "type": "catalog_message", "body": { "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase." }, "action": { "name": "catalog_message", "parameters": { "thumbnail_product_retailer_id": "2lc20305pt" } }, "footer": { "text": "Best grocery deals on WhatsApp!" } } }'
{ "messaging_product": "whatsapp", "contacts": [ { "input": "16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA" } ] }
目录模板消息是包含一个按钮的模板消息。当客户点按该按钮时,系统会在 WhatsApp 中显示您的商品目录。
如要发送目录模板消息,您需要使用目录模板。请参阅我们的目录模板文档,了解如何创建目录模板,以及如何在模板消息中发送目录模板。
多件商品消息和单件商品消息都属于 interactive
消息类型。
多件商品消息示例: | 单件商品消息示例: |
用户点击“开始购物”时触发的菜单: | 商品详情页面示例: |
收到多件和单件商品消息的用户可以执行 3 个主要操作:
如果客户在同一个 WhatsApp 帐号下关联了多件设备,则多件商品和单件商品消息会在各设备之间同步。但是,对于每个特定设备而言,购物车为本机特有。详情请参阅购物车体验。
目前,以下平台可接收上述类型的消息:
2.21.100
(多件商品消息)和 2.21.210
(单件商品消息)。2.21.9.15
(多件商品消息)和 2.21.19
(单件商品消息)。如果收信人的应用版本不支持多件或单件商品消息,他们会收到一条消息,告知他们因使用了过时的 WhatsApp 版本而无法收到消息。企业也会收到 Webhooks 通知,表明由于收信人使用了过时的 WhatsApp 版本,消息无法送达。
多件商品消息和单件商品消息支持以下操作:
目录消息、多件商品消息和单件商品消息不支持以下行为:
商家可能需要更新目录中商品的属性。对于提到该商品的任何消息,我们会根据更新的属性,按照以下方式处理:
更新的属性 | 更新流程 |
---|---|
商品的价格、名称、描述和图片。 |
|
可用数量更新 |
|
查看商品之后,客户可以将其加入购物车,并将购物车发送至企业。就 WhatsApp 商务而言,购物车具备以下特点:
客户向购物车中添加商品时,对于单件目录商品,最多可以添加 99 个,但是对于可以加入购物车的不同商品数量并不设限。
购物车一旦发送,便无法编辑。如果客户需要新商品或希望更改订单,可发送新购物车。商家无法向客户发送购物车。
多件和单件商品消息都能带来简单且个性化的用户体验。它们能引导客户浏览与自身最相关的商品子集而非商家的完整库存,让客户获得更出色的体验。
如果将这两类消息与自然语言处理 (NLP)、文本搜索或清单消息和回复按钮等导航工具结合使用,能够快速找出客户正在寻找的内容。
商品消息为动态填充,因此可根据客户或情况进行定制。例如,您可以显示一条包含某客户最常订购商品的多件商品消息。
商品消息是可提高订单量的一个有效渠道。在测试期间,从发出的多件商品消息到收到的购物车,商家取得的平均转化率为 7%。
无需模板或经过预先批准,即可使用互动消息。这类消息实时生成,并始终显示最新商品详情、定价和仓库中的库存水平。
多件商品消息最适合引导客户浏览商家库存的特定子集,在以下场景中尤为有用:
单件商品消息最适合引导客户浏览商家库存中的一款特定商品,通过给予有限的选项提供快速回复方式,例如:
这两个功能还可用于人工客服流程,但是您需要构建工具,以支持人工客服在对话中生成多件商品消息或单件商品消息。
在发送每条消息之前,您需要向 /contacts
节点发出调用,以获取接收人的 WhatsApp 编号。
我们建议设置 Webhooks,以接收消息状态和消息入站通知。您可以通过这种方式追踪消息是否已发送以及客户的回答。
如要发送单件商品消息,应将以下组件整合成一个 product
类型的 interactive
对象:
对象 | 描述 |
---|---|
| 可选。 body 对象。查看 |
| 可选。 footer 对象。查看 |
| 必要。 此操作字段必须包含以下项目:
|
最后,interactive 对象应如下所示:
"interactive": { "type": "product", "body": { "text": "text-body-content" }, "footer": { "text": "text-footer-content" }, "action": { "catalog_id": "catalog-id", "product_retailer_id": "product-SKU-in-catalog" } }
如要发送多件商品消息,应将以下组件整合成一个 product_list
类型的 interactive
对象:
对象 | 描述 |
---|---|
| 必要。 必须将标题的 |
| 必要。
|
| 可选。
|
| 必要。 此操作字段必须包含以下项目:
在每个版块中,您可以添加以下项目:
每个商品对象都包含一个 |
最后,interactive
对象应如下所示:
"interactive": { "type": "product_list", "header":{ "type": "text", "text": "text-header-content" }, "body":{ "text": "text-body-content" }, "footer":{ "text":"text-footer-content" }, "action":{ "catalog_id":"catalog-id", "sections": [ { "title": "the-section-title", "product_items": [ { "product_retailer_id": "product-SKU-in-catalog" }, { "product_retailer_id": "product-SKU-in-catalog" }, ... ]}, { "title": "the-section-title", "product_items": [ { "product_retailer_id": "product-SKU-in-catalog" } ... ]}, ... ] }, }
如果上述 API 调用中提供的所有商品与商家 Facebook 目录中的任意商品都不相符,系统将发送错误消息,且不会向用户发送多件或单件商品消息。
对于多件商品消息,商品列表中必须至少有一件商品与商家 Facebook 目录中的商品相符。在此情况下:
interactive 对象整合完成后,请附加组成消息其他参数:recipient_type
、to
和 type
。记得将 type
设为 interactive
。
{ "recipient_type": "individual", "to" : "whatsapp-id", // WhatsApp ID of the recipient "type": "interactive", "interactive":{ // The interactive object } }
请在此处查看所有消息类型的通用参数。
/messages
发出 POST
调用使用您在第 1 步和第 2 步中整合的 JSON
对象,向 /messages
发出 POST
调用。如果消息发送成功,您将收到以下响应:
{ "messages": [{ "id": "{message-id}" }] }
如要发送多件商品模板消息,您需要使用多件商品消息模板。请参阅我们的多件商品消息模板文档,了解如何创建多件商品消息模板,以及如何在模板消息中发送多件商品消息模板。