此文档概述了我们的客户使用 Bird 进行一般集成的常见方法。这些集成涵盖了诸如“我如何发送电子邮件？”和“我如何知道电子邮件发生了什么？”之类的重要主题。 对于兼顾内部部署和云设置的组织，我们的S/MIME 内部部署平台实施指南涵盖了 PowerMTA 和 Momentum 配置以确保安全的电子邮件传递。如果您正在从 Postfix、Sendmail 或 Exim 进行转换，本文件应能解释有关电子邮件发送和报告基础知识的所有内容。 本文件的其余部分假定您已有一个 SparkPost 帐户。

我如何发送电子邮件？

Bird 将以几种方式接受邮件传输。目前，最常见的是 SMTP（简单邮件传输协议），Bird 会在端口 587 上精确地展现为任何其他安全电子邮件代理。如果您当前有生成或邮件合并软件创建用于传递的电子邮件，Bird 将它作为标准 SMTP 邮件接受并尝试交付。您需要一个具有有效 TLS 证书的系统，能够生成 SMTP 邮件并通过端口 587 发送。Postfix、Sendmail 和 Exim 都具备此功能。

示例 1：

您有一个通过 Postfix 生成合并消息以进行电子邮件传递的网页服务器。
· 调整网页服务器的生成软件，将 SMTP 消息发送至分配的 SparkPost 服务器而不是 Postfix 服务器
· 是的，确实就是这么简单

示例 2：

您有一些管理代码需要使用本地服务器的“Mail”功能。
· 如果您使用 Sendmail，编辑 /etc/mail/sendmail.mc 文件以添加“smart-host”定义。
例如：define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· 如果您使用 Postfix，编辑 /etc/postfix/transport 文件以添加 smtp 中继定义。
例如：* smtp:MyMessageBirdServer.com
· 确保启用 TLS 并将出站端口设置为 587。
· 应用更改并重新启动本地邮件服务
· 执行管理代码，邮件将路由至 MessageBird 进行交付

REST 注入呢？

对于在其网络中使用 HTTP(S) 传输数据的客户，将消息转换为 SMTP 可能很麻烦。Bird 拥有全面的 REST API，可以通过 HTTPS 接受 JSON 模板、收件人列表和替换数据，并将其转换为生成的（合并）电子邮件，以标准 SMTP 发送到世界各地。这对于将生成工作从网页服务器卸载到邮件引擎特别有帮助。

示例：

您的服务器每天为 50,000 名收件人生成具有个性化数据的通讯，然后通过 Postfix 单独发送。
· 为收件人、替换数据和内容模板创建 JSON 对象。
· 使用 REST API 将 JSON 对象 POST 到 Bird 的 Transmission API。这样做将生成过程卸载到 SparkPost，以便更快交付。
· 您甚至可以将 JSON 放在文件中并使用 cURL：

curl -v -H "Content-Type: application/json" -X POST \ https://api.bird.com/api/v1transmissions -d@./newsletter.json

我如何获得交付信息？

Bird 收集大量交付信息，并以 JSON 格式提供给您，这些数据可以通过 webhook“推送”或通过 API 调用“拉取”。交付的数据看起来像这样：

{      "campaign_id":"Welcome_Letter",    "customer_id":"108",    "delv_method":"esmtp",    "event_id":"84769964978165188",    "friendly_from":"bounce@sp-send.com",    "ip_address":"50.116.50.117",    "ip_pool":"default",    "message_id":"00046a82565a6d39451a",    "msg_from":"abc-bounces-108@sp-send..com",    "msg_size":"2164",    "num_retries":"0",    "queue_time":"1759",    "raw_rcpt_to":"fakespark+32@deadboltemail.com",    "rcpt_meta":{      },    "rcpt_tags":[      ],    "rcpt_to":"fakespark+32@deadboltemail.com",    "routing_domain":"deadboltemail.com",    "sending_ip":"52.38.47.118",    "subject":"Welcome Letter Template",    "tdate":"2018-01-10T21:15:24.000Z",    "template_id":"welcome-letter",    "template_version":"5",    "transmission_id":"84769964922735103",    "type":"delivery",    "timestamp":"2018-01-10T14:15:24.000-07:00" }

这可能比您在 Postfix 日志中习惯看到的数据要多得多，并且它已经是一种易于消费的格式。如果需要，将 JSON 数据转换为 Postfix 日志格式也相对简单。传递、退回、拒绝、垃圾邮件投诉、打开、点击和延迟数据都可以用同样的方式读取。

示例：

1) 您通常将 Postfix 日志导出到 Excel 以便排序和分析。
A) 执行 message_events API 调用，运行生成的 JSON 数据，通过 JSON2CSV 转换。

2) 您喜欢将 Postfix 日志转化为 JSON，然后将其拉入网页服务进行读取和分析。
A) 使用 MessageBird 指标 API 向 SparkPost 轮询所需数据，并且它会自动导出为 JSON。

3) 您有一个单独的进程实时跟踪和解析日志，并更新单独的收件人数据库。
A) SparkPost 可以提供实时 webhook，专为此目的提供垃圾邮件投诉者和退订者的喂送。实施起来非常简单。

-Tom