在 Firebase 上开始使用 Bird 扩展
鸟
2021年6月1日
Firebase 扩展
1 min read
关键要点
The Bird | Firebase Extension 允许开发人员通过 Firestore 文档写入直接在 SMS、WhatsApp、Messenger、Google Business Messages、Telegram、LINE、Viber 等平台发送消息和通知。
当新文档被添加到配置的 Firestore 集合时，扩展将其转换为可读的消息负载，并通过 Bird 的 Conversations API 发送，然后更新文档的交付状态。
这个扩展消除了与 Bird 的 API 进行后端集成的需要，使团队能够以最少的代码更快地交付消息功能。
Firebase 的实时和可扩展基础设施与 Bird 的全球连接相结合，确保在世界任何地方可靠地传递消息。
一个示例用例展示了餐馆如何通过仅需 Firestore 写入来自动向等待桌位的顾客发送 SMS 通知。
设置仅需要一个 Bird API 密钥和一个 SMS（或其他渠道）ID；配置通过 Firebase 的扩展安装向导完成。
开发人员定义扩展监听的 Firestore 集合—每个新文档都会成为消息触发器。
发送后，扩展将通过提供交付数据、状态，以及在适用时的错误信息来丰富 Firestore 文档。
安全最佳实践至关重要：Firestore 规则必须严格限制读/写访问，以防止滥用或未经授权的信息发送。
云函数日志允许开发人员检查消息失败、扩展执行错误和交付结果。
该扩展可无缝地与更广泛的 Bird 生态系统配合使用，使将来的增强功能如 AI 生成的流程、图像识别或 CRM 自动化成为可能。
这种集成为更丰富的体验奠定了基础，如使客户能够使用关键词回复，构建餐厅队列功能，或通过 Flow Builder 连接到外部 API。
Q&A 精华
Bird Firebase 扩展有什么作用？
它监听 Firestore 集合中的更改，并在添加新文档时通过 Bird 的 Conversations API 发送消息。
扩展可以通过哪些渠道发送消息？
短信，WhatsApp，Facebook Messenger，Google Business Messages，Telegram，LINE，Viber，与任何其他Bird支持的渠道。
我需要后端服务器来发送消息吗？
不，扩展处理所有的 API 交互—消息变得像写入一个文档到 Firestore 一样简单。
从我的Bird账户需要哪些信息？
你将需要你的Bird API密钥和一个频道ID（例如，用于SMS）。
我如何安装扩展程序？
通过 Firebase 控制台 → 扩展程序 → 安装 “Send Messages with Bird”，然后配置您的 API 密钥和集合名称。
扩展如何知道何时发送消息？
它监控指定的 Firestore 集合，并在创建新文档时触发。
消息文档格式是什么样的？
一个简单的JSON包含目的地、渠道ID和消息文本（或其他渠道的有效载荷）。
消息发送后会发生什么？
扩展更新Firestore文档，包括交付元数据，如delivery.state、时间戳和错误详情（如果有）。
我如何检查错误？
错误会出现在更新的Firestore文档中，以及Firebase中的Cloud Functions日志中。
How do I secure my Firestore collection?
使用 Firestore 安全规则来限制读/写权限，仅授权用户或服务账户可以访问。
我可以使用这个扩展程序来实现更高级的工作流程吗？
是的 —— 你可以将它与 Flow Builder、外部 API 或像 Google Vision 这样的机器学习工具配对，以构建互动和自动化体验。
有什么现实世界的例子可以说明如何使用这个扩展？
一个餐厅排队系统，可以在桌子准备好时发送SMS通知——只需添加一个Firestore文档即可触发。
