Platform

如何从 n8n 或 Zapier 等低代码工具使用 Bird?

通过 n8n 中的 Bird 节点或 Zapier 中的 Bird 应用发送,然后通过事件触发器处理投递。

表单提交可以在无需自定义服务的情况下触发一封确认邮件。但工作流仍需处理发送步骤完成后才到达的退信。

如何将 Bird 连接到 n8n?

在 n8n Cloud 或已启用社区节点验证的自托管实例上,从节点面板安装 Bird 的已验证节点。

  1. 创建一个新工作流。
  2. 点击 + 或按 Tab 打开节点面板
  3. 搜索 Bird
  4. 选择 Install 为你的实例安装该节点。
  5. 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 EmailSend SMSSend WhatsApp Message 作为发送步骤。Start VerificationCheck 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 规范

  1. n8n: 使用工作区 API 密钥配置 Bird 节点。
  2. Zapier: 授权 Bird 应用,选择其操作或事件触发器。
  3. HTTP block: 在没有 Bird 集成时,手动提供请求详情。
  4. Custom service: 自行管理存储的投递状态和重试策略。

简而言之

  1. 使用工具所需的凭据进行连接。

    n8n 使用 Bird API 密钥。Zapier 要求你通过 Bird 授权一个工作区级别的连接。

  2. 为每个触发器预留一个 webhook 端点。

    每个使用 Bird 事件触发器的工作流或 Zap 都需要在组织配额内拥有自己的端点。

  3. 检查投递事件。

    发送步骤成功只确认请求已被接受。投递成功或失败会在之后到达,因此请保留消息 ID 以便对账。

  4. 为业务操作保留重试状态。

    n8n 在重试时发送稳定的幂等键。Zapier 不发送幂等键,因此重放可能导致重复发送。

付诸实践。

继续查阅此主题的文档、指南和示例。资源为英文。

获取实施简报

基于同一网络构建。

测试 API 密钥即刻获取。添加付款方式并验证发送者身份后,即可解锁生产环境。

你的下一个创意。
随时连接。