Google 致力于为黑人社区推动种族平等。查看具体举措
使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

使用 SendGrid 同步联系人

Twilio
Made by Twilio

使 Firestore 联系人数据集合与 SendGrid Marketing Campaign 联系人列表保持同步

此扩展程序的运作方式

使用此扩展程序,根据添加到指定 Cloud Firestore 集合的信息,添加、更新或移除 SendGrid Marketing Campaigns 联系人列表中的联系人。

添加文档触发此扩展程序,以将联系人添加到 Marketing Campaigns 联系人列表。更新文档将更新联系人的数据,删除文档将触发从 SendGrid 的联系人列表中删除该文档。

以下是将触发此扩展程序的一个示例文档:

admin.firestore().collection('contacts').add({
  email: 'someone@example.com',
  first_name: 'Bob',
  last_name: 'Bobson'
});

在该文档中,您可以将以下任何字段添加到文档,这些字段将应用到您的联系人:

字段 类型
email 字符串 必填
alternate_emails 数组<字符串>
first_name 字符串
last_name 字符串
address_line_1 字符串
address_line_2 字符串
city 字符串
postal_code 字符串
state_province_region 字符串
country 字符串
phone_number 字符串
whatsapp 字符串
line 字符串
facebook 字符串
unique_name 字符串
custom_fields 映射<字符串, 字符串>

custom_fields 必须在您的 SendGrid 帐号中定义,并且是自定义字段的 ID 到内容的映射。

额外设置

在安装此扩展程序之前,请确保:

结算

若要安装扩展程序,您的项目必须采用 Blaze(随用随付)方案

  • 您需要为此扩展程序所需的 Firebase 资源支付少量费用(通常约为 $0.01/月),即使没有使用此扩展程序也要支付。
  • 此扩展程序用到了其他 Firebase 和 Google Cloud Platform 服务,如果超出这些服务的免费层级,则会产生相关费用:
  • Cloud Firestore
  • Cloud Functions(Node.js 10+ 运行时。 查看常见问题解答 )
  • Cloud Secret Manager

使用此扩展程序还需要您拥有 Twilio SendGrid 帐号 和凭据,以将 Twilio SendGrid API 用于营销活动。您需要自行承担与使用 Twilio SendGrid 相关的任何费用。

如何安装此扩展程序

使用 Firebase 控制台

要安装和管理扩展程序,您可以使用 Firebase 控制台。

使用控制台安装

使用 Firebase CLI

要安装和管理扩展程序,您还可以使用 Firebase CLI:

步骤 1 :运行以下 npm 命令来安装 CLI 或将 CLI 更新到最新版本。

npm install -g firebase-tools
不能运行?请参阅 Firebase CLI 参考文档 或者更改您的 npm 权限

第 2 步 设置一个新的 Firebase 项目目录 或转到现有目录

第 3 步 :将此扩展程序添加到 扩展程序清单

firebase ext:install twilio/sendgrid-sync-contacts --local --project=projectId_or_alias

Step 4 (Optional): Test this extension locally with the Firebase Emulator Suite

firebase emulators:start

第 5 步 :将清单中的扩展程序 部署 到项目中

firebase deploy --only extensions --project=projectId_or_alias
支持
Cloud Firestore
作者
许可
Apache-2.0
版本
0.1.1