# 项目设置指南

本指南概述了设置您的 Pushwoosh 项目和消息渠道的步骤，例如推送通知、消息收件箱、应用内消息、电子邮件、WhatsApp、LINE、Kakao、SMS 以及 Apple 和 Google Wallet 通行证。根据渠道的不同，您需要配置平台设置、集成 SDK（如果需要）并注册用户数据。

配置好渠道后，您就可以开始通过 Pushwoosh 控制面板或 API 发送消息。

## 前提条件

在开始使用任何通信渠道之前，请完成以下步骤：

*   **创建 Pushwoosh 账户**

*   **使用您的默认项目或创建一个新项目**
    注册时会创建一个默认项目（**我的项目**）。您可以将其用于跨多个平台的一个应用程序，也可以为不同的应用程序创建单独的项目。
    <LinkCard title="了解如何创建项目" href="/product/first-steps/start-with-your-project/create-your-project/" />

## 设置消息渠道

<TitleIcon icon="push">
### 推送通知
</TitleIcon>

跨移动和 Web 平台向用户发送及时和个性化的提醒。

要启用推送通知：

<Steps>
1. **配置您的平台**

   为 iOS、Android、华为和 Web 设置凭据。[了解更多](/zh/developer/first-steps/connect-messaging-services/configure-project/)

2. **集成 SDK**

   将 Pushwoosh SDK 添加到您的应用或网站。[了解更多](/zh/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **测试集成并发布您的应用或网站**

   确保推送功能按预期工作。
   *   对于应用，将集成了 SDK 的版本发布到应用商店。
   对于网站，只需更新您的线上网站即可。[了解更多](/zh/developer/first-steps/test-your-integration/test-devices/)

4. **注册用户**

   订阅设备并同步用户数据以启用推送送达。[了解更多](/zh/developer/first-steps/subscribe-users/)

5. **设置自定义用户 ID**

   分配自定义用户 ID，将个人的设备/联系人统一到一个个人资料下。[了解更多](/zh/developer/first-steps/collecting-user-ids/)
</Steps>

设置完成后，您可以开始[通过控制面板发送推送通知](/zh/product/messaging-channels/push-notifications/#start-sending-different-types-of-push-notifications)或使用 [`Notify`](/zh/developer/api-reference/messaging-api-v2/notify/) API 方法。

<TitleIcon icon="download">
### 消息收件箱
</TitleIcon>

将重要消息存储在专用的应用内空间，即使用户选择退出推送通知也能触达他们。

要启用消息收件箱：

<Steps>
1. **配置平台**

   在支持的平台上为您的应用设置推送消息。[了解更多](/zh/developer/first-steps/connect-messaging-services/configure-project/)

2. **集成 SDK**

   将 Pushwoosh SDK 添加到您的应用以启用收件箱功能。[了解更多](/zh/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **注册用户**

   同步用户数据以允许收件箱消息送达。[了解更多](/zh/developer/first-steps/subscribe-users/)

4. **设置自定义用户 ID**

   分配自定义用户 ID，将个人的设备/联系人统一到一个个人资料下。[了解更多](/zh/developer/first-steps/collecting-user-ids/)

5. **实现消息收件箱**

   遵循特定平台的指南来实现收件箱 UI。[了解更多](/zh/developer/guides/message-inbox/)

6. **自定义 UI（可选）**

   根据需要自定义收件箱的外观。[了解更多](/zh/developer/guides/message-inbox/)
</Steps>

集成完成后，您可以使用 [Pushwoosh Customer Journey](/zh/product/customer-journey/journey-elements/#save-to-inbox) 或 [`Notify`](/zh/developer/api-reference/messaging-api-v2/notify/) API 方法来发送收件箱消息。

<TitleIcon icon="inapp">
### 应用内消息
</TitleIcon>

直接在您的应用内显示上下文相关的消息。

要启用应用内消息：

<Steps>
1. **配置您的平台**

   确保您的应用支持应用内消息。[了解更多](/zh/developer/first-steps/connect-messaging-services/configure-project/)

2. **集成 SDK**

   应用内消息的发送需要集成 SDK。[了解更多](/zh/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **测试集成并发布您的应用**

   确保应用内功能按预期工作，并将集成了 SDK 的版本发布到应用商店。[了解更多](/zh/developer/first-steps/test-your-integration/)

4. **注册用户**

   确保设备已订阅并同步了用户数据。[了解更多](/zh/developer/first-steps/subscribe-users/)

5. **设置自定义用户 ID**

   分配自定义用户 ID，将个人的设备/联系人统一到一个个人资料下。[了解更多](/zh/developer/first-steps/collecting-user-ids/)
</Steps>

设置完成后，您可以通过 [Customer Journey](/zh/product/messaging-channels/in-apps/sending-in-apps/#send-in-apps-via-customer-journey) 发送应用内消息，或使用[即时应用内消息](/zh/product/messaging-channels/in-apps/sending-in-apps/#send-instant-in-apps)功能。

<TitleIcon icon="email">
### 电子邮件
</TitleIcon>

通过个性化的电子邮件营销活动或交易性消息触达您的用户。

要开始发送电子邮件：

<Steps>
1. **配置电子邮件平台**

   验证您的域名和发件人地址。[了解更多](/zh/developer/first-steps/connect-messaging-services/email-verification/)

2. **注册用户**

   导入并同步用户电子邮件地址。[了解更多](/zh/developer/first-steps/subscribe-users/)

3. **设置自定义用户 ID**

   分配自定义用户 ID，将个人的设备/联系人统一到一个个人资料下。[了解更多](/zh/developer/first-steps/collecting-user-ids/)
</Steps>

设置完成后，您就可以开始使用 Pushwoosh 控制面板或 [`Notify`](/zh/developer/api-reference/messaging-api-v2/notify/) 方法发送电子邮件。

<TitleIcon icon="whatsapp">
### WhatsApp
</TitleIcon>

在全球使用最广泛的消息应用之一上与用户互动，发送安全且经批准的消息，以推动有意义的互动。

要启用 WhatsApp 消息：

<Steps>
1. **连接您的 WhatsApp Business 账户**

   [了解更多](/zh/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration/)

2. **批准模板**

   向 Meta 提交您自己的模板或使用预先批准的模板。[了解更多](/zh/product/messaging-channels/whatsapp-messages/#create-whatsapp-templates)

3. **注册 WhatsApp 联系人**

   [了解更多](/zh/developer/first-steps/subscribe-users/)

4. **设置自定义用户 ID**

   分配自定义用户 ID，将个人的设备/联系人统一到一个个人资料下。[了解更多](/zh/developer/first-steps/collecting-user-ids/)
</Steps>

集成准备就绪后，您可以[使用控制面板](/zh/product/messaging-channels/whatsapp-messages/send-whatsapp-messages/)或 [`Notify`](/zh/developer/api-reference/messaging-api-v2/notify/) API 方法发送 WhatsApp 消息。

<TitleIcon icon="sms">
### SMS
</TitleIcon>

直接向用户的手机号码发送短信。

要启用 SMS：

<Steps>
1. **连接您的 SMS 提供商**

   [了解更多](/zh/developer/first-steps/connect-messaging-services/sms-configuration/)

   有关提供商回调 URL，请参阅 [SMS 提供商 webhooks](/zh/developer/first-steps/connect-messaging-services/sms-configuration/sms-provider-webhooks/)。

2. **注册电话号码**

   在用户同意的情况下，正确收集并格式化号码（E.164）。[了解更多](/zh/developer/first-steps/subscribe-users/)

3. **设置自定义用户 ID**

   分配自定义用户 ID，将个人的设备/联系人统一到一个个人资料下。[了解更多](/zh/developer/first-steps/collecting-user-ids/)
</Steps>

设置完成后，您可以使用 [Customer Journey](/zh/product/customer-journey/journey-elements/#sms) 或通过 [`Notify`](/zh/developer/api-reference/messaging-api-v2/notify/) API 方法发送 SMS 消息。

<TitleIcon icon="line">
### LINE
</TitleIcon>

使用 LINE 通过 Customer Journeys、API 或 1:1 聊天与用户联系，可使用模板或纯文本消息。
要开始使用 LINE 消息：

<Steps>

1. **设置您的 LINE 账户**
   创建一个 [LINE Official Business Account](https://www.linebiz.com/jp-en/) 和一个 [LINE Developers Account](https://developers.line.biz/en/docs/line-developers-console/login-account/)。

2. **将 LINE 连接到 Pushwoosh**
   在您的 Pushwoosh 账户中配置 LINE 平台。[了解更多](/zh/developer/first-steps/connect-messaging-services/line-configuration/)

3. **确保 LINE Messaging 已设置并启用了计费。**
   > **重要提示：** LINE Messaging API 的定价由 LINE 直接管理。套餐因地区和使用量而异。[查看定价详情](https://developers.line.biz/en/docs/messaging-api/pricing/)

</Steps>

##### 后续步骤

*   **通过 API 发送消息**

    使用 Pushwoosh API 发送带有模板或纯文本内容的 LINE 消息。

    <LinkCard title="通知" href="/developer/api-reference/messaging-api-v2/notify/" />

<TitleIcon icon="comment">
### Kakao
</TitleIcon>

通过 Customer Journeys 或 API 使用经批准的模板发送 Kakao 消息，以在 KakaoTalk 上触达用户。

要开始使用 Kakao 消息：

<Steps>

1. **将 Kakao 连接到 Pushwoosh**

   在您的 Pushwoosh 账户中配置 Kakao 平台。[了解更多](/zh/developer/first-steps/connect-messaging-services/kakao-configuration/)

2. **创建并批准消息模板**

   使用经批准的 Kakao 模板；自定义模板需要在 Kakao Business Center 中获得批准。[了解更多](/zh/product/content/kakao-presets/)

</Steps>

##### 后续步骤

*   **通过 API 发送消息**

    使用 Pushwoosh API 发送带有经批准模板的 Kakao 消息。

    <LinkCard title="通知" href="/developer/api-reference/messaging-api-v2/notify/" />

### Apple Wallet 通行证

设计 Apple Wallet 通行证，包括会员卡、优惠券、活动门票等，并向添加了它们的每台设备推送实时更新。

要开始使用 Apple Wallet 通行证：

<Steps>

1. **配置签名证书**

   将您的 Apple Pass Type ID 证书添加到您的应用程序中，以便 Pushwoosh 可以签署通行证。[了解更多](/zh/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2. **设计并发行通行证**

   在通行证构建器中构建通行证，然后将其作为安装链接或二维码分享。[了解更多](/zh/product/messaging-channels/apple-wallet-passes/pass-builder/)

</Steps>

##### 后续步骤

*   **了解更多关于 Apple Wallet 通行证的信息**

    在控制面板中设计、分发和更新通行证。

    <LinkCard title="了解更多" href="/product/messaging-channels/apple-wallet-passes/" />

*   **通过 API 管理通行证**

    使用 PassKit API 以编程方式创建、更新和管理通行证。

    <LinkCard title="了解更多" href="/developer/api-reference/apple-wallet-passkit-api/" />

### Google Wallet 通行证

设计 Google Wallet 通行证，包括会员卡、优惠、活动门票等，并让 Google 将更新同步到保存了它们的每台设备。

要开始使用 Google Wallet 通行证：

<Steps>

1. **在 Pushwoosh 中配置 Google Wallet**

   将您的 Issuer ID 和服务账户密钥添加到您的应用程序中。此设置独立于 Firebase。[了解更多](/zh/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)

2. **设计并发行通行证**

   在通行证构建器中构建通行证，然后分享一个“添加到 Google Wallet”的保存链接或二维码。[了解更多](/zh/product/messaging-channels/google-wallet-passes/pass-builder/)

</Steps>

##### 后续步骤

*   **在控制面板中分发和更新通行证**

    <LinkCard title="了解更多" href="/product/messaging-channels/google-wallet-passes/" />

*   **向通行证持有者发送消息**

    通过通行证更新、一次性推送或 Customer Journey 触达持有者。

    <LinkCard title="了解更多" href="/product/messaging-channels/google-wallet-passes/message-pass-holders/" />

*   **通过 API 管理通行证**

    使用 Google Wallet API 创建通行证、发行保存链接并将其发送给用户。

    <LinkCard title="了解更多" href="/developer/api-reference/google-wallet-api/" />

## 构建全渠道营销活动

在您配置并集成了必要的消息渠道后，您可以创建全渠道营销活动，以协调跨多个触点的沟通。

要启用全渠道功能，请确保您在一个[统一的用户 ID](/zh/developer/pushwoosh-knowledge-hub/users-userids/) 下注册并关联用户数据（例如，设备 ID、电子邮件、电话号码）。这使您能够通过单一的营销活动逻辑在不同渠道上触达同一用户。

<LinkCard title="了解更多关于全渠道营销活动的信息" href="/product/pushwoosh-knowledge-hub/omnichannel-campaigns/" />