API
API整合-Webhook篇

继续回答前面『API整合-入门篇 』这个问题:

Q4:需要发给会员的邮件发送状态,以及邮件打开,点击等会员行为数据,还有会员客户端,访问地理位置等信息,这些数据要怎么能够获得?

我们先解释一下 Webhook:

Webhook是一种消息订阅异步接口实现方式,它能够将用户订阅消息数据及时的传输到用户指定的位置(URL)。而灵动营销平台也提供这种接口,能够将用户订阅的邮件发送状态,用户的会员打开邮件,点击里面链接,更新会员信息等行为事件信息数据及时的传回用户业务系统。

下面灵动营销平台Webhook设置界面,订阅地址就是用户接送订阅数据的地址。

订阅会员行为

那么订阅数据是个什么样子,我们来看看下面这段文本,如果稍有点程序猿背景的同学,一眼就会看出。嗯,这是个JSON格式的数据,无论是对人还是对系统都比较容易理解。

//备注:下面示例数据在已经做了混淆:)
{
    "delivered": [
        {
            "id": 2201602002317593, 
            "campaign": "大麦网温馨提示:您关注的演出内容有更新", 
            "email": "hg007@example.com", 
            "status": "bounce:hard", 
            "dsn": "Action: failed | Status: 5.1.2 (bad destination system: no such domain)", 
            "updated": "2014-02-20 18:08:05", 
            "createdAt": "2014-02-20 18:08:04", 
            "scheduleId": 17436, 
            "messageId": 12399, 
            "contactId": 19016004
        }, 
        {
            "id": 22201606019253710, 
            "campaign": "大麦网温馨提示:您关注的演出内容有更新", 
            "uid": "GFpCmAhnXpPoXqXLH2BY", 
            "email": " xiaorong@example.com ", 
            "status": "success", 
            "dsn": "smtp;250 ok: Message 1758717523 accepted", 
            "updated": "2014-06-27 15:03:04", 
            "createdAt": "2014-06-27 15:02:20", 
            "scheduleId": 121830, 
            "messageId": 162084, 
            "contactId": 43001513
        }
    ], 
    "clicks": [
        {
            "id": 22201603016582230, 
            "campaign": "大麦网温馨提示:您关注的演出内容有更新", 
            "subject": "大麦网温馨提示:您关注的演出内容有更新", 
            "uid": "GFpCmAhnXpPoXqXLH2BY", 
            "email": "someone@example.com", 
            "ip": "119.255.75.126", 
            "location": "中国/河北/廊坊", 
            "longitude": 116.7139, 
            "latitude": 39.5292, 
            "device": "", 
            "platform": "Windows 7", 
            "client": "Chrome", 
            "url": "http://item.damai.cn/78982.html", 
            "createdAt": "2014-02-20 18:08:05"
        }, 
        {
            "id": 22201603026582230, 
            "campaign": "大麦网温馨提示:您关注的演出内容有更新", 
            "subject": "大麦网温馨提示:您关注的演出内容有更新", 
            "uid": "GFpCmAhnXpPoXqXLH2BY", 
            "email": "someone@example.com", 
            "ip": "119.255.75.126", 
            "location": "中国/河北/廊坊", 
            "longitude": 116.7139, 
            "latitude": 39.5292, 
            "device": "", 
            "platform": "Windows 7", 
            "client": "Chrome", 
            "url": "#退订", 
            "createdAt": "2014-02-20 18:08:05"
        }
    ], 
    "opens": [
        {
            "id": 222016111000001234, 
            "campaign": "大麦网温馨提示:您关注的演出内容有更新",
            "subject": "大麦网温馨提示:您关注的演出内容有更新", 
            "uid": "GFpCmAhnXpPoXqXLH2BY", 
            "email": "someone@example.com", 
            "ip": "119.255.75.126", 
            "location": "中国/河北/廊坊", 
            "longitude": 116.7139, 
            "latitude": 39.5292, 
            "device": "", 
            "platform": "Windows 7", 
            "client": "Chrome", 
            "createdAt": "2014-02-20 18:08:05"
        }
    ], 
    "unsubscriptions": [
        {
            "id": 222019111000001234, 
            "campaign": "大麦网温馨提示:您关注的演出内容有更新",
            "subject": "大麦网温馨提示:您关注的演出内容有更新", 
            "uid": "GFpCmAhnXpPoXqXLH2BY", 
            "email": "example@abc.com", 
            "ip": "119.255.75.126", 
            "location": "中国/河北/廊坊", 
            "longitude": 116.7139, 
            "latitude": 39.5292, 
            "device": "", 
            "platform": "Windows 7", 
            "client": "Chrome", 
            "source": "esp", 
            "content": "I do not want to receive these emails anymore .", 
            "createdAt": "2014-02-20 18:08:05"
        }
    ], 
    "complaints": [
        {
            "id": 222019111000005678, 
            "campaign": "KiKUU Order Shipped Reminder",
            "subject": "KiKUU Order Shipped Reminder", 
            "uid": "65655dnvdte0", 
            "email": "one@someone.com", 
            "ip": "117.136.31.250", 
            "location": "中国/广东省/广州市", 
            "longitude": 116.7139, 
            "latitude": 39.5292, 
            "device": "", 
            "platform": "Windows 7", 
            "client": "Chrome", 
            "source": "esp", 
            "content": "在沒有任何解釋及通知的情況下, 退還按金時直接扣了大約27英鎊。在現場交還汽車時並沒有指出任何問題需要作出賠償,現在卻無理地少退還了按金。請協助跟進。", 
            "createdAt": "2014-02-20 18:08:05"
        }
    ]
}

如需了解更多关于API详细资料,请访问我们官网资源中心的『开发者

API
API整合-入门篇

用户最基本整合需求各种场景邮件触发发送,往往来自于用户自身业务需求,除了发送需求,客户系统与API整合复杂度,则将是用户下一个关注点。

Q1:我的需求比较简单,就是发送注册通知邮件,有没有什么快捷整合方式?

Q2:除了触发通知类邮件,我还需要发送营销邮件,有什么方便集成方案?

Q3:另外我们有些系统不具备二次开发条件,只能设置SMTP服务器配置,可以提供SMTP接口吗?

Q4:需要发给会员的邮件发送状态,以及邮件打开,点击等会员行为数据,还有会员客户端,访问地理位置等信息,这些数据要怎么能够获得?

那么我们先来解答前三个问题:

SMTP发送接口

是的,如上图所暗示的,我们提供有SMTP接口,能够帮助用户完成快速整合,以近零成本完成API的整合。

过程大致如下:

1.如果还没有灵动营销平台帐户,请先从这里『免费注册』一个帐户;

2.找到API Key,这里的API Key可以理解为邮箱的帐户和密码;

API Key

3.设置您的SMTP 服务器配置,下图中主机名即为灵动的SMTP服务器:

API Key SMTP Config

4.好了,您可以发送邮件了。

哎,还剩一个问题呢?

哦,答案这里,请前往『API整合-Webhook篇 』。

如需更多关于API详细资料,请访问我们官网资源中心的『开发者

© Copyright 2022, All Rights Reserved. | 公司网站 | 灵动邮件营销博客 | 隐私声明 | 系统登录