通过

SmartDialog

SmartDialog 是用于发送和接收短信和 WhatsApp 消息的平台。 它提供各种智能消息服务。

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

服务 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 Arena 交互式支持
URL https://www.arenainteractive.fi/contact
Email support@arenainteractive.fi
连接器元数据
发布者 Arena Interactive Oy
Website https://www.arenainteractive.fi
隐私策略 https://www.arenainteractive.fi/privacypolicy
类别 通信;协作

SmartDialog 连接器

此连接器可用于使用 SmartDialog 平台发送和接收短信。

先决条件

  1. SmartDialog 订阅和帐户。 请与 联系
  2. 需要为帐户启用 OAuth，需要请求客户端密码。 可以通过向我们 support@arenainteractive.fi发送电子邮件来完成此作。

设置

  1. 请按照 OpenAPI 定义创建自定义连接器中的说明进行作。
  2. 创建 Flow 或 PowerApp，并从自定义部分添加 SmartDialog作。 使用 SmartDialog 帐户登录。

支持的操作

  • 新消息（接收消息的触发器）
  • 发送消息
  • 发送 WhatsApp 消息
  • 发送讨论回复消息
  • 发送回复消息
  • WhatsApp 选择加入
  • WhatsApp 选择退出
  • 创建 WhatsApp 模板
  • 获取组联系人
  • 创建组联系人
  • 更新组联系人
  • 删除组联系人
  • 删除所有组联系人

限制

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

操作

WhatsApp Opt In （已弃用） [已弃用]

WhatsApp 选择加入发件人和收件人。 （已弃用）
WhatsApp 选择退出 （已弃用） [已弃用]

WhatsApp 选择退出发件人和收件人。 （已弃用）
创建 WhatsApp 模板

创建新的 WhatsApp 模板。
创建组联系人

创建组联系人
删除所有组联系人

删除所有组联系人
删除组联系人

使用电话号码删除组联系人。
发送 WhatsApp 消息

发送 WhatsApp 模板消息。
发送回复消息

向收件人发送 Replymessage。
发送消息

向收件人发送邮件。
发送讨论回复消息

向收件人发送讨论答复邮件。
更新组联系人

更新组联系人
获取组联系人

获取组联系人

WhatsApp Opt In （已弃用） [已弃用]

操作 ID:
WhatsAppOptIn

WhatsApp 选择加入发件人和收件人。 （已弃用）

参数

名称 密钥 必需 类型 说明
发件人地址
 Sender True string

注册了 Whatsapp 标识号以选择加入。
收件人地址
 Recipient True string

要选择加入的收件人号码。

WhatsApp 选择退出 （已弃用） [已弃用]

操作 ID:
WhatsAppOptOut

WhatsApp 选择退出发件人和收件人。 （已弃用）

参数

名称 密钥 必需 类型 说明
发件人地址
 Sender True string

注册了 Whatsapp 标识号以选择退出。
收件人地址
 Recipient True string

要从选择加入中删除的食谱编号。

创建 WhatsApp 模板

操作 ID:
CreateWhatsappTemplate

创建新的 WhatsApp 模板。

参数

名称 密钥 必需 类型 说明
客户
 Customer-Id True string

要为其创建模板的客户。
IdentityNumber
 IdentityNumber True string

WhatsApp IdentityNumber 用于模板。
Displayname
 DisplayName True string

模板显示名称。
Content
 RawContent True string

模板内容。
模板类别
 Category True string

模板类别。
模板语言
 Language True string

模板语言的 2 个字符代码。
按钮类型
 Type string

按钮的类型。
按钮标签
 Label string

按钮标签。
按钮数据
 Data string

按钮数据。 URL（Url）、电话号码（呼叫）或文本（QuickReply）。 URL 的最大长度为 2000，电话号码和文本长度为 20。
附件 URL
 AttachmentUrl string

示例附件的 URL。

创建组联系人

操作 ID:
CreateGroupContact

创建组联系人

参数

名称 密钥 必需 类型 说明
客户
 Customer True string

要为其提取组服务的客户。
组服务
 Group Service True string

要使用的组服务。
活跃
 active boolean

指示联系人是否处于活动状态的标志。
电话
 phone True string

联系人的电话号码。
Email
 email string

联系人的电子邮件地址。
名字
 firstName string

联系人的名字。
Lastname
 lastName string

联系人的姓氏。
性别
 gender string

联系人的性别。
出生年
 birthYear integer

联系人的出生年。
街道地址
 streetAddress string

联系人的街道地址。
邮政编码
 zipCode string

联系人的邮政编码。
City
 city string

联系人城市。
国家/地区代码
 countryCode string

联系人的 3 个字母国家/地区代码。
Name
 name string

自定义属性名称。
价值
 value string

自定义属性值。
Phonenumber 区域
 phoneNumberRegions array of string

用于分析号码的 Phonenumber 区域。 如果留空，则默认为芬兰。

返回

创建联系人的唯一 ID。

联系人 ID
uuid

删除所有组联系人

操作 ID:
DeleteAllGroupContacts

删除所有组联系人

参数

名称 密钥 必需 类型 说明
客户
 Customer True string

要为其提取组服务的客户。
组服务
 Group Service True string

要使用的组服务。

返回

response
boolean

删除组联系人

操作 ID:
DeleteGroupContact

使用电话号码删除组联系人。

参数

名称 密钥 必需 类型 说明
客户
 Customer True string

要为其提取组服务的客户。
组服务
 Group Service True string

要使用的组服务。
电话
 Phone True string

要删除的联系人的电话号码。

返回

response
boolean

发送 WhatsApp 消息

操作 ID:
SendWhatsappTemplateMessage

发送 WhatsApp 模板消息。

参数

名称 密钥 必需 类型 说明
客户
 Customer-Id True string

要用于发送的客户。
服务
 Service-Id True string

要用于发送的服务。
WhatsApp 模板
 TemplateName True string

要用于发送的模板。
地址
 Address True string

邮件收件人地址。
BodyParameters
 BodyParameters array of string

BodyParameters
HeaderParameters
 HeaderParameters array of string

HeaderParameters
类型
 Type string

按钮类型。 每个模板只有一个类型，可以包含同一类型的多个类型。
文本
 Data string

按钮的文本。
发送日期/时间
 SendDateTime string

发送邮件的日期和时间。 留空以立即发送。
附件 URI
 AttachmentUri string

如果模板包含附件，则为附件 URI。
使用短信回退
 UseSmsFallback boolean

应将短信用作回退。
Dlr Url
 DlrUrl string

传递报告 URL，将在发送进程完成时接收回调。
客户数据
 CustomerData string

此消息的计费/分组数据（可选）。
请求 ID
 RequestId string

可用于标识重复请求的可选唯一请求 ID。 如果检测到重复的请求 ID，则会取消发送。 不能保证在高吞吐量/流量情况下会阻止具有重复请求 ID 的请求。 给定 requestId 将“记住”7 天。

返回

名称 路径 类型 说明
消息 ID
 messageId string

新创建的消息的标识符。
消息部件计数
 messagePartCount integer

此消息的消息部分的近似数目。
recipients
 recipients array of object

recipients
收件人地址
 recipients.address string

收件人地址（电话号码/电子邮件/用户 ID 等）。
收件人 ID
 recipients.id string

用于接收传递状态信息的收件人标识符。

发送回复消息

操作 ID:
SendReplyMessage

向收件人发送 Replymessage。

参数

名称 密钥 必需 类型 说明
ParentMessage Id
 ParentMessageId True string

要答复的父消息 ID。
客户
 Customer-Id True string

要用于发送的客户。
服务
 Service-Id True string

要用于发送的服务。
邮件发件人
 Sender True string

邮件的发送方可以是字母数字、长代码或短代码（限制适用）。
消息内容
 Content True string

消息的内容。
消息协议
 Protocol True string

用于发送消息的协议。
发送日期/时间
 SendDateTime date-time

发送邮件的日期和时间。 留空以立即发送。
地址
 Address True string

邮件收件人地址。
附件 URI
 AttachmentUri string

发送包含附件的 WhatsApp 消息时要使用的附件 URI。
客户数据
 CustomerData string

此消息的计费/分组数据（可选）。
广告消息
 AdMessage boolean

可选重写标志，用于将邮件标记为广告消息
Dlr Url
 DlrUrl string

通过 http-get 传递状态回调的 URL。 可以将查询字符串值添加到 URL，这些值将保留。
请求 ID
 RequestId string

可用于标识重复请求的可选唯一请求 ID。 如果检测到重复的请求 ID，则会取消发送。 不能保证在高吞吐量/流量情况下会阻止具有重复请求 ID 的请求。 给定 requestId 将“记住”7 天。

返回

名称 路径 类型 说明
消息 ID
 MessageId string

新创建的消息的标识符。
消息部件计数
 MessagePartCount integer

此消息的消息部分的近似数目。
收件人
 Recipients array of object

收件人
收件人地址
 Recipients.Address string

收件人地址（电话号码/电子邮件/用户 ID 等）。
收件人 ID
 Recipients.Id string

用于接收传递状态信息的收件人标识符。

发送消息

操作 ID:
SendMessage

向收件人发送邮件。

参数

名称 密钥 必需 类型 说明
客户
 Customer-Id True string

要用于发送的客户。
服务
 Service-Id True string

要用于发送的服务。
邮件发件人
 Sender True string

邮件的发送方可以是字母数字、长代码或短代码（限制适用）。
消息内容
 Content True string

消息的内容。
消息协议
 Protocol True string

用于发送消息的协议。
发送日期/时间
 SendDateTime date-time

发送邮件的日期和时间。 留空以立即发送。
地址
 Address True string

邮件收件人地址。
附件 URI
 AttachmentUri string

发送包含附件的 WhatsApp 消息时要使用的附件 URI。
客户数据
 CustomerData string

此消息的计费/分组数据（可选）。
广告消息
 AdMessage boolean

可选重写标志，用于将邮件标记为广告消息
Dlr Url
 DlrUrl string

通过 http-get 传递状态回调的 URL。 可以将查询字符串值添加到 URL，这些值将保留。
请求 ID
 RequestId string

可用于标识重复请求的可选唯一请求 ID。 如果检测到重复的请求 ID，则会取消发送。 不能保证在高吞吐量/流量情况下会阻止具有重复请求 ID 的请求。 给定 requestId 将“记住”7 天。

返回

名称 路径 类型 说明
消息 ID
 MessageId string

新创建的消息的标识符。
消息部件计数
 MessagePartCount integer

此消息的消息部分的近似数目。
收件人
 Recipients array of object

收件人
收件人地址
 Recipients.Address string

收件人地址（电话号码/电子邮件/用户 ID 等）。
收件人 ID
 Recipients.Id string

用于接收传递状态信息的收件人标识符。

发送讨论回复消息

操作 ID:
SendDiscussionReplyMessage

向收件人发送讨论答复邮件。

参数

名称 密钥 必需 类型 说明
客户
 CustomerId True string

要用于发送的客户。
线程 ID
 ThreadId True string

要答复的现有线程的 ID。
消息内容
 Content True string

消息的内容。
客户数据
 CustomerData string

此消息的计费/分组数据（可选）。

返回

名称 路径 类型 说明
消息 ID
 MessageId string

新创建的消息的标识符。
消息部件计数
 MessagePartCount integer

此消息的消息部分的近似数目。
收件人
 Recipients array of object

收件人
收件人地址
 Recipients.Address string

收件人地址（电话号码/电子邮件/用户 ID 等）。
收件人 ID
 Recipients.Id string

用于接收传递状态信息的收件人标识符。
ThreadId
 ThreadId string

消息发送到的线程标识符。

更新组联系人

操作 ID:
UpdateGroupContact

更新组联系人

参数

名称 密钥 必需 类型 说明
客户
 Customer True string

要为其提取组服务的客户。
组服务
 Group Service True string

要使用的组服务。
电话
 Phone True string

要更新的联系人的电话号码。
活跃
 active boolean

指示联系人是否处于活动状态的标志。
Email
 email string

联系人的电子邮件地址。
名字
 firstName string

联系人的名字。
Lastname
 lastName string

联系人的姓氏。
性别
 gender string

联系人的性别。
出生年
 birthYear integer

联系人的出生年。
街道地址
 streetAddress string

联系人的街道地址。
邮政编码
 zipCode string

联系人的邮政编码。
City
 city string

联系人城市。
国家/地区代码
 countryCode string

联系人的 3 个字母国家/地区代码。
Name
 name string

自定义联系人属性名称。
价值
 value string

自定义联系人属性值。
Phonenumber 区域
 phoneNumberRegions array of string

用于分析号码的 Phonenumber 区域。 如果留空，则默认为芬兰。

返回

response
boolean

获取组联系人

操作 ID:
GetGroupContact

获取组联系人

参数

名称 密钥 必需 类型 说明
客户
 Customer True string

要为其提取组服务的客户。
组服务
 Group Service True string

要使用的组服务。
电话
 Phone True string

联系人的电话号码。
区域
 Region string

用于分析电话号码的可选 Phonenumber 区域。

返回

名称 路径 类型 说明
电话
 phone string

联系人的电话号码。
Email
 email string

联系人的电子邮件地址。
名字
 firstName string

联系人的名字。
Lastname
 lastName string

联系人的姓氏。
性别
 gender string

联系人的性别。
出生年
 birthYear integer

联系人的出生年。
街道地址
 streetAddress string

联系人的街道地址。
邮政编码
 zipCode string

联系人的邮政编码。
City
 city string

联系人城市。
国家/地区代码
 countryCode string

联系人的国家/地区代码。
失败的消息
 failedMessages integer

联系人失败的消息数。
自定义属性
 customContactProperties array of object

为联系人保存的自定义联系人属性集合。
Name
 customContactProperties.name string

自定义联系人属性名称。
价值
 customContactProperties.value string

自定义联系人属性值。

触发器

新建消息

当新消息到达 2 路服务时。

新建消息

操作 ID:
NewMessage

当新消息到达 2 路服务时。

参数

名称 密钥 必需 类型 说明
客户
 Customer True string

要使用的客户。
服务
 Service True string

要使用的 2 向服务。

返回

名称 路径 类型 说明
邮件发件人
 sender string

邮件发件人。
邮件收件人
 recipient string

邮件的收件人。
消息内容
 content string

收到的消息的内容。
消息时间戳
 timestamp date-time

消息的时间戳。
消息协议
 protocol string

收到的消息的协议。
attachments
 attachments array of object

attachments
附件文件名
 attachments.name string

附件的文件名。
附件 Mime 类型
 attachments.mimeType string

附件的 mime 类型。
附件资源位置
 attachments.resourceLocation string

附件资源位置。
消息 ID
 messageId string

接收的消息的唯一消息 ID。

定义

UUID（通用唯一识别码）

创建联系人的唯一 ID。

创建联系人的唯一 ID。

联系人 ID
uuid

布尔

这是基本数据类型“boolean”。