> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 通过 Journey Webhook 发送 WhatsApp 消息

> 使用 OneSignal Journeys 和 webhook 自动发送 WhatsApp 消息。

## 要求

* 支持 Journeys 和 Webhook 的付费计划
* [WhatsApp 商业平台](https://developers.facebook.com/docs/whatsapp/) + [Webhook 设置](https://developers.facebook.com/docs/whatsapp/business-management-api/guides/set-up-webhooks/)
* WhatsApp 收件人

<Info>
  虽然以下指南使用 Facebook/Meta API，但 Twilio 也可以用于发布 WhatsApp 消息。
</Info>

## 设置

### 1. 导入收件人电话号码

支持 WhatsApp 的号码应作为数据标签上传到用户。

**以下是一个例子：**

<Frame caption="WhatsApp 电话号码数据标签示例">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9d6d60f-Screenshot_2023-12-11_at_4.18.55_PM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=7da1071cc2d4d5d0532b5421e30fc037" width="1478" height="127" data-path="images/docs/9d6d60f-Screenshot_2023-12-11_at_4.18.55_PM.png" />
</Frame>

<Warning>
  请以 E.164 格式添加号码，但不包含 + 号。号码 +16463938787 应添加为 16463938787。
</Warning>

### 2. 获取 Webhook 代码

一旦您创建了 Meta/Facebook 商业帐户并激活了 WhatsApp 模块，您将获得一个 API 访问令牌。

您可以在 WhatsApp -> API 设置下找到此信息

<Frame caption="WhatsApp API 设置凭据屏幕">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6accf9b-Screenshot_2023-12-11_at_4.20.11_PM.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=80c1e9b33b021e551a495009e18bb473" width="1438" height="496" data-path="images/docs/6accf9b-Screenshot_2023-12-11_at_4.20.11_PM.png" />
</Frame>

### 3. 创建 Webhook 模板

* 在 OneSignal 中，点击：**数据 > Webhook > 新建 Webhook**
* 复制凭据。它应该看起来像这样：

<Frame caption="WhatsApp webhook 配置模板">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d9e43cc-Screenshot_2023-12-11_at_4.20.49_PM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=7fb711e8ee8dc46c0338adb7562ee75a" width="1470" height="1019" data-path="images/docs/d9e43cc-Screenshot_2023-12-11_at_4.20.49_PM.png" />
</Frame>

<Warning>
  如上所突出显示的，`{{user.tags.WhatsApp_number}}` 标签键被添加为"to"号码。
</Warning>

### 4. 创建 Journey

您现在可以创建您的 Journey 并添加您的新 WhatsApp Webhook。

<Frame caption="WhatsApp webhook 选择">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/journeys/whatsapp-webhook-selection.gif?s=bebc2ab65e99877c31e22eda7bff8080" width="600" height="319" data-path="images/journeys/whatsapp-webhook-selection.gif" />
</Frame>

测试时，请确保以下几点：

* 您添加 WhatsApp 号码的订阅 ID 具有外部 ID
* 订阅 ID 与 Journey 包含的细分匹配

***