表单提交可以在无需自定义服务的情况下触发一封确认邮件。但工作流仍需处理发送步骤完成后才到达的退信。
如何将 Bird 连接到 n8n?
在 n8n Cloud 或已启用社区节点验证的自托管实例上,从节点面板安装 Bird 的已验证节点。
- 创建一个新工作流。
- 点击 + 或按 Tab 打开节点面板。
- 搜索 Bird。
- 选择 Install 为你的实例安装该节点。
- Bird 节点现已可在你的工作流中使用。
对于自托管 n8n,安装前请确认满足运行时要求。如果面板中没有社区节点选项,打开 Settings > Community Nodes > Install,输入 @messagebird/n8n-nodes-bird 作为包名。
在 Bird 仪表板的 API keys 下创建密钥。在 n8n 中添加一个 Bird API 凭据,填入该工作区的 API 密钥。
为你选择的操作授予凭据所列的权限范围,以便工作流能够发起相应请求。
在 Bird 节点中选择资源和操作。它支持邮件、SMS、WhatsApp 和验证,以及配置和报告操作。
该节点不包含 Realtime 发布和订阅功能,因为其凭据无法存储所需的 app key 和 secret。
字节下载和基于重定向的媒体获取也不包含在内。该节点期望工作流项目返回 JSON 结果。对于这些操作,请使用合适的客户端或 HTTP 请求。
如何将 Bird 连接到 Zapier?
在 Zapier 中选择 Bird,点击 Connect,在 Bird 中完成授权。
Zapier 会存储 OAuth 连接,你无需粘贴 API 密钥。该连接属于工作区,即使授权人更换团队也不受影响。
在工作区的 Integrations 页面管理其访问权限。撤销连接会停止使用它的所有 Zap。
选择 Send Email、Send SMS 或 Send WhatsApp Message 作为发送步骤。Start Verification 和 Check Verification Code 用于验证码验证。
搜索步骤可检索消息及其事件。Zapier 集成描述了可用的操作和搜索。
如何从投递事件启动工作流?
在 n8n 中使用 Bird Trigger,或在 Zapier 中使用 New Event。选择工作流需要的事件。
集成会为工作流注册一个 webhook 端点,并在将事件传入自动化流程前验证投递签名。
每个事件触发的工作流都需要自己的端点。Bird 的端点配额默认为每个组织一个,因此已有的 webhook 可能会阻止创建新的触发器。
在添加更多事件触发工作流之前,请联系支持团队提升配额。发送操作和搜索不需要各自拥有 webhook 端点。
发送步骤成功证明了什么?
它证明 Bird 已接受发送请求,但不代表最终的投递结果。
保存返回的消息 ID。使用投递和失败事件来更新触发该发送的记录。
如果客服窗口在派发前关闭,WhatsApp 的自由格式消息可能会失败。该失败在发送步骤成功之后才到达。在客服窗口外发消息时,请使用已批准的模板。
n8n 的 Bird 节点为每个操作发送稳定的 Idempotency-Key,因此工作流重试不会重复发送。Zapier 不发送幂等键,因此平台重放可能导致重复发送。
何时该用低代码,何时该编写服务?
当发送属于你的工作流工具已管理的流程时,使用低代码。当你需要自行管理持久化的重试和投递状态时,使用服务。
n8n 的邮件或 SMS 批量操作可在一次调用中排队最多 100 条消息。一个 250 条消息的任务分组后只需三次调用,而非 250 个单独请求。
对于没有 Bird 集成的工具,使用其 HTTP 模块。如果该工具支持从 OpenAPI 规范生成客户端,可导入 Bird 的 OpenAPI 规范。
- n8n: 使用工作区 API 密钥配置 Bird 节点。
- Zapier: 授权 Bird 应用,选择其操作或事件触发器。
- HTTP block: 在没有 Bird 集成时,手动提供请求详情。
- Custom service: 自行管理存储的投递状态和重试策略。
简而言之
使用工具所需的凭据进行连接。
n8n 使用 Bird API 密钥。Zapier 要求你通过 Bird 授权一个工作区级别的连接。
为每个触发器预留一个 webhook 端点。
每个使用 Bird 事件触发器的工作流或 Zap 都需要在组织配额内拥有自己的端点。
检查投递事件。
发送步骤成功只确认请求已被接受。投递成功或失败会在之后到达,因此请保留消息 ID 以便对账。
为业务操作保留重试状态。
n8n 在重试时发送稳定的幂等键。Zapier 不发送幂等键,因此重放可能导致重复发送。