使用 MessageBird 发送消息

此扩展程序的运作方式

使用此扩展程序，通过 MessageBird 发送覆盖全渠道的消息（短信、WhatsApp、Google Business Messages、Messenger、Telegram、Line、Viber 等）。 在将文档添加到特定 Firestore 集合时，该扩展程序会使用 MessageBird Conversations API 将该文档转换为消息，并使用递送状态信息更新文档。

 db.collection('YOUR_DOCUMENT_COLLECTION').add({
  channelId: 'YOUR_CHANNEL_ID',
  type: 'text',
  content: {
    text: 'YOUR_MESSAGE_CONTENT'
  },
  to: 'RECIPIENT_OF_THE_MESSAGE',
});

注意：您可以在 Conversations API 文档中找到支持的消息类型和所需内容字段的完整列表。

额外设置

在安装此扩展程序之前，请先在您的 Firebase 项目中设置如下 Firebase 服务：

• Cloud Firestore，用于存储消息文档。
• 按照文档中的步骤操作，创建一个 Cloud Firestore 数据库。 您必须拥有 MessageBird 帐号和 MessageBird API 访问密钥才能安装此扩展程序。 您还需要创建希望用于发送消息的渠道（短信渠道、WhatsApp 渠道、Facebook Messenger 渠道、Telegram 渠道等），因为在发送消息时您将需要指定渠道。

MessageBird 帐号设置分步说明

• 在 MessageBird 页面创建一个 MessageBird 帐号，然后在系统要求时选择\“APIs\”路径
• 在创建帐号后，您可以在信息中心或开发者设置页面上查看您的 API 密钥。

您可以在渠道页面上设置您想使用的渠道

• 对于短信，您需要获取发送短信的号码
• 对于 WhatsApp，您需要按照 WhatsApp 安装向导的说明创建一个 WhatsApp for Business 帐号。如果您希望发送会话外 WhatsApp 消息，您可能还需要创建 WhatsApp 消息模板。
• 对于其他渠道，请按照渠道页面上的说明操作

注意：MessageBird 也有测试模式，让您可以在不发送实际消息的情况下进行 API 调用。您可以将其用于测试目的，以避免开发期间的额外成本。

结算

此扩展程序用到以下 Firebase 服务，可能会产生相关的费用：

• Cloud Firestore
• Cloud Functions

此扩展程序还使用如下第三方服务：

• MessageBird Billing（价格信息）

您有责任承担与您使用这些服务相关的任何费用。

Firebase 提供的说明

若要安装此扩展程序，您的 Firebase 项目必须采用 Blaze（随用随付）方案。您仅需为您使用的资源支付费用。大多数 Firebase 服务都提供了免费层级，可以覆盖较低的使用量。详细了解 Firebase 结算。

当您安装或重新配置此扩展程序时，需要支付少量费用（通常不到 $0.10）。请查看 Firebase 价格中的 Cloud Functions 价格获取详细说明。