通过

Netvolution （预览版）

Netvolution 连接器使企业能够简化和自动化其电子邮件营销活动。 它基于用户行为启用有针对性的电子邮件分段、个性化消息传递和自动化工作流。 通过利用 Netvolution，营销人员可以增强参与度，提高客户保留率，并尽量降低转换率。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Atcom SA
URL https://www.atcom.gr
连接器元数据
发布者 Atcom S.A
网站 https://www.atcom.gr/
隐私策略 https://www.atcom.gr/privacy-policy/
类别 商业;营销

Netvolution 连接器

介绍

Netvolution 连接器允许你设计和自动执行电子邮件市场营销活动，包括基于行为作将营销电子邮件发送到特定细分市场和自动化市场活动。 此连接器提供一组作，用于管理和与 Netvolution 平台中的各种资源进行交互。

先决条件

在使用 Netvolution 连接器之前，需要：

  • Netvolution 实现。
  • API 凭据（API 密钥）。

入门

若要使用 Netvolution 连接器，请执行以下步骤：

  1. 将连接器添加到 Power Platform 环境：

    • 导航到 Power Platform 门户。
    • 转到“连接器”部分并添加新连接器。
    • 搜索“Netvolution”并选择它。

  2. 配置连接器：

    • 输入从 Netvolution 平台获取的 API 凭据。
    • 输入 Netvolution 地址（不含 https 前缀）。
    • 保存配置。

  3. 在应用和流中使用连接器：

    • 将连接器添加到 Power Apps 或 Power Automate 流。
    • 使用可用作与 Netvolution 资源交互。

支持的作

Netvolution 连接器支持以下作：

  • 获取电子邮件模板

    • 方法：GET
    • 路径：/cdp/mail/list-templates
    • 说明：列出所有自定义电子邮件模板。

  • 发生新事件时

    • 方法：GET
    • 路径：/trigger/cdp/events/{eventName}
    • 说明：使用此方法选择事件作为触发器。 支持的事件：add_to_cart、、view_pageview_item。

  • 将联系人添加到细分市场时

    • 方法：GET
    • 路径：/trigger/cdp/contacts/{Id}
    • 说明：在新联系人添加到段时触发。

  • 获取联系人订单

    • 方法：GET
    • 路径：/cdp/orders/{contactId}
    • 说明：检查联系人是否已发出订单。

  • 检查联系人是否在抑制列表中

    • 方法：GET
    • 路径：/cdp/suppression/check
    • 说明：检查联系人是否暂时位于抑制列表中。

  • 将联系人置于抑制列表

    • 方法：PUT
    • 路径：/cdp/suppression/add
    • 说明：将联系人添加到抑制列表中的指定持续时间。

  • 发送电子邮件

    • 方法：POST
    • 路径：/cdp/mail/send
    • 说明：此作触发在 Netvolution 中创建的电子邮件市场活动。

  • 检查是否发生了事件

    • 方法：GET
    • 路径：/cdp/events/checkevent
    • 说明：检查特定时间段内某个联系人 ID 是否发生事件。

  • 获取愿望列表

    • 方法：GET
    • 路径：/cdp/wishlist/{since}
    • 说明：检索指定时间范围内更新的希望列表。

API 定义

连接器使用以下 API 定义：

  • Swagger 文件：apiDefinition.swagger.json
    • 此文件包含连接器使用的详细 API 架构和终结点。

设置

连接器设置在以下文件中定义：

  • 设置文件：settings.json
    • 此文件包含连接器的各种配置设置。

图标

连接器图标包含在以下文件中：

  • 图标文件：icon.png
    • 此文件用作 Power Platform 接口中连接器的可视表示形式。

已知问题和限制

  • 目前，连接器支持基本作。 将来的版本中将添加高级功能。
  • 确保正确配置 API 凭据以避免身份验证错误。

Support

有关任何问题或支持，请联系 Netvolution 支持团队，或参阅官方文档。

许可证

此连接器根据 MIT 许可证获得许可。 有关更多详细信息，请参阅 LICENSE 文件。

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
API 密钥 securestring 此 API 的密钥
Netvolution 主机名 字符串 Netvolution 主机名（示例：yourdomain.netvolution.net）。 True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

发送电子邮件

此作触发在 Netvolution 中创建的电子邮件市场活动。
将联系人置于抑制列表

将联系人置于抑制列表
检查是否发生了事件

检查某个联系人 ID 和某个时间段是否发生了事件。
检查联系人是否在抑制列表中

使用此作可检查联系人是否暂时处于抑制列表中。
获取愿望列表

获取愿望列表
获取电子邮件模板

列出所有自定义电子邮件模板。
获取联系人订单

检查联系人是否已下单。

发送电子邮件

操作 ID:
SendMail

此作触发在 Netvolution 中创建的电子邮件市场活动。

参数

名称 密钥 必需 类型 说明
触点 ID
 cdpContactId string

用户的 CDP 联系人 ID。
语言 ID
 languageId string

netvolution 站点中指定的语言 ID。
电子邮件模板
 emailTemplate string

选择电子邮件市场活动。

将联系人置于抑制列表

操作 ID:
PutContactIDToSuppresionList

将联系人置于抑制列表

参数

名称 密钥 必需 类型 说明
触点 ID
 contactId True string

根据以前使用的触发器使用联系人 ID 的输出。
抑制列表名称
 listName True string

抑制列表的名称。
时间跨度
 timeSpan True string

指定联系人 ID 将保留在此活动的“抑制列表”中的天数。

检查是否发生了事件

操作 ID:
CheckEvent

检查某个联系人 ID 和某个时间段是否发生了事件。

参数

名称 密钥 必需 类型 说明
事件名称
 eventName string

选择可用事件。
触点 ID
 contactId string

用户的 CDP 联系人 ID。
因为
 since string

事件发生后检查的时间点。

返回

名称 路径 类型 说明
Message
 Message boolean

Message
Results
 Results integer

Results

检查联系人是否在抑制列表中

操作 ID:
GetContactIDFromSuppressionList

使用此作可检查联系人是否暂时处于抑制列表中。

参数

名称 密钥 必需 类型 说明
触点 ID
 contactId True string

用户的 CDP 联系人 ID。
列表名称
 listName True string

抑制列表的名称。

获取愿望列表

操作 ID:
GetWishList

获取愿望列表

参数

名称 密钥 必需 类型 说明
时间跨度
 since True string

指定要检查更新的希望列表的天数。

返回

名称 路径 类型 说明
Results
 Results array of object

Results
CDPContactID
 Results.CDPContactID string

CDPContactID
UserID
 Results.UserID integer

UserID
WishListID
 Results.WishListID integer

WishListID
LastUpdated
 Results.LastUpdated string

LastUpdated
LanguageID
 Results.LanguageID integer

LanguageID

获取电子邮件模板

操作 ID:
GetEmailTemplates

列出所有自定义电子邮件模板。

返回

名称 路径 类型 说明
Message
 Message boolean

Message
Results
 Results integer

Results

获取联系人订单

操作 ID:
GetOrder

检查联系人是否已下单。

参数

名称 密钥 必需 类型 说明
触点 ID
 contactId True string

根据以前使用的触发器使用联系人 ID 的输出。
因为
 since True string

它将检查用户是否已下订单的时间点。

触发器

发生新事件时

使用此键选择事件作为触发器
将联系人添加到细分市场时

将新联系人添加到段时使用此触发器

发生新事件时

操作 ID:
OnNewEvent

使用此键选择事件作为触发器

参数

名称 密钥 必需 类型 说明
事件名称
 eventName True string

选择可用事件。

返回

名称 路径 类型 说明
NextSince
 NextSince string

NextSince
Results
 Results array of object

Results
LanguageID
 Results.LanguageID integer

LanguageID
LanguageName
 Results.LanguageName string

LanguageName
EventName
 Results.EventName string

EventName
时间戳
 Results.Timestamp string

时间戳
CDPContactID
 Results.CDPContactID string

CDPContactID
家庭
 Results.Browser.OS.Family string

家庭
主要
 Results.Browser.OS.Major string

主要
IsSpider
 Results.Browser.Device.IsSpider boolean

IsSpider
家庭
 Results.Browser.Device.Family string

家庭
品牌
 Results.Browser.Device.Brand string

品牌
型号
 Results.Browser.Device.Model string

型号
家庭
 Results.Browser.UserAgent.Family string

家庭
主要
 Results.Browser.UserAgent.Major string

主要
轻微
 Results.Browser.UserAgent.Minor string

轻微
Patch
 Results.Browser.UserAgent.Patch string

Patch
id
 Results.List.id string

id
姓名
 Results.List.name string

姓名
ItemParentId
 Results.Product.ItemParentId string

ItemParentId
ItemName
 Results.Product.ItemName string

ItemName
类别
 Results.Product.Category string

类别

将联系人添加到细分市场时

操作 ID:
OnNewUserInSegment

将新联系人添加到段时使用此触发器

参数

名称 密钥 必需 类型 说明
细分 ID
 Id True string

使用 Netvolution 段 ID。

返回

名称 路径 类型 说明
NextSince
 NextSince string

NextSince
Results
 Results array of object

Results
ID
 Results.ID string

ID
CreatedDate
 Results.CreatedDate string

CreatedDate
电子邮件地址
 Results.EmailAddress string

电子邮件地址
eStoreSessionId
 Results.eStoreSessionId string

eStoreSessionId
名字
 Results.FirstName string

名字
姓
 Results.LastName string

姓
出生日期
 Results.DateOfBirth string

出生日期
性别
 Results.Gender string

性别
匿名
 Results.Anonymized boolean

匿名
Code
 Results.MobilePhone.Code string

Code
编号
 Results.MobilePhone.Number string

编号
国家代码
 Results.MobilePhone.CountryCode string

国家代码
价值
 Results.ModifiedDate.Value string

价值
IsAutocalculated
 Results.ModifiedDate.IsAutocalculated boolean

IsAutocalculated
Code
 Results.Landline.Code string

Code
编号
 Results.Landline.Number string

编号
国家代码
 Results.Landline.CountryCode string

国家代码
街道
 Results.Address.Street string

街道
City
 Results.Address.City string

City
ZipCode
 Results.Address.ZipCode string

ZipCode
县
 Results.Address.County string

县
国家
 Results.Address.Country string

国家
位置
 Results.Location string

位置
段数
 Results.Segments array of object

段数
SegmentID
 Results.Segments.SegmentID integer

SegmentID
MemberSince
 Results.Segments.MemberSince string

MemberSince