boomapp 连接
“智能”全球 2 向、电子邮件、语音、短信和推送消息。 通过 boomapp 连接来增强任何 Power Platform 应用程序,以构建真正自动化的多渠道对话通信工作流(以主题为独特驱动)。 基于收件人响应的完全交互式 comms 工作流允许交付无缝且无摩擦的交互,而无需通过参与强制进行行为更改。 有关更多详细信息和设置免费试用帐户,请参阅我们的网站。
此连接器在以下产品和区域中可用:
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 : - 由世纪互联运营的中国云 |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 中国区域 |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 : - 由世纪互联运营的中国云 |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 : - 由世纪互联运营的中国云 |
| 联系人 | |
|---|---|
| Name | Boomerang 支持 |
| URL | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| support@boomcomms.com |
| 连接器元数据 | |
|---|---|
| 发布者 | Boomerang I-Comms Ltd |
| Website | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| 隐私策略 | https://boomerangmessaging.com/privacy/ |
| 类别 | 通信;生产力 |
先决条件
需要满足以下条件才能继续作:
- 具有自定义连接器功能的 Microsoft Power Automate 计划
- Boomerang 订阅
- Boomerang API 身份验证详细信息。
使用 Boomerang 创建帐户
- 网站 - 有关如何创建 Boomerang 帐户的更多详细信息。
支持和文档:
可 在此处找到文档。
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| 用户名 | securestring | 此 API 的用户名 | True |
| 密码 | securestring | 此 API 的密码 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
|
发送单个或批量电子邮件。 电子邮件是从域 @boomerangui.com 发送的,可以自定义主题并覆盖“发件人”地址。 还可以将响应转发到电子邮件地址和/或 URL |
|
| Voice |
固定号码用作文本To-Speech(TTS)语音呼叫的发起方。 击键“1”和“2”用于接受或拒绝消息,“9”用于重定向呼叫。 有关详细信息,请参阅https://boomerangmessaging.com/docs/sending-delivering-voice-messages |
| 短信单向 |
短信是使用字母数字发起方(如公司名称)传递的,该名称必须最多包含 11 个字符,并且收件人无法响应使用 alpha 数字发起方发送的邮件。 另请注意,在不支持使用 alpha 数字发起方传递消息的目标(由于本地限制),这可能会被数字发起方替换,以确保消息已传递。 |
| 短信双向 |
此方法允许直接针对每个出站事务跟踪答复,并用于管理系统与最终用户之间的对话。 回复可以转发到电子邮件地址,使用 Boommail 的客户可以将电子邮件 2 短信发回回复者。 有关双向和对话消息的详细信息,请参阅 https://boomerangmessaging.com/docs/sending-sms-messages。 |
| 短信自定义号码 |
使用请求中指定的号码传递短信,以便将任何答复返回到该号码。 使用 Boomerang 的“市场活动”功能的客户可以使用与市场活动关联的数字,这允许从 Boomerang UI 中的“市场活动报告”部分访问入站回复。 但是,与 SMS 2 向方法不同,不会针对出站消息跟踪答复。 有关详细信息,请参阅 https://boomerangmessaging.com/docs/sending-sms-messages。 |
发送单个或批量电子邮件。 电子邮件是从域 @boomerangui.com 发送的,可以自定义主题并覆盖“发件人”地址。 还可以将响应转发到电子邮件地址和/或 URL
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
from
|
from | string |
传递要用作发件人地址的内容。 如果为空,则默认值将从帐户设置中获取 |
|
|
email_subject
|
email_subject | string |
在收件人收件箱中收到电子邮件时,默认显示主题 |
|
|
message_content
|
message_content | string |
发送到所有 recipientAddresses 的出站邮件的内容。 |
|
|
email_address
|
email_address | array of string |
email_address |
|
|
validity_period
|
validity_period | integer |
用于发送消息的数字将处于活动状态的时间段。 在有效期到期后,不会传递对邮件的答复。 对于双向消息,最小有效期为 1 天。 |
|
|
open_ticket
|
open_ticket | boolean |
默认情况下,所有消息都发送单个票证,这意味着消息在收到第一个响应时关闭。 若要将多个响应匹配到同一原始消息,请通过传递 true 来使用开放票证。 |
|
|
email_responses
|
email_responses | string |
将邮件响应转发到的电子邮件地址。 |
|
|
push_responses
|
push_responses | string |
将消息响应发布到的 CallBack URL。 |
|
|
unique_identifier
|
unique_identifier | string |
每个事务的唯一标识符。 这用于防止消息重复,因为 Boomerang 将忽略以前使用过 ID 的任何事务。 |
|
|
campaign_name
|
campaign_name | string |
可选标识符,可用于按特定市场活动和批处理消息对消息进行分组。 |
|
|
custom_parameter
|
custom_parameter | string |
用于自定义引用的参数。 例如,这可用作市场活动参考、作业引用、批处理 ID 等。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
状态
|
status | integer |
状态 |
|
消息
|
message | string |
消息 |
|
事务
|
transactions | array of object |
事务 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
email_address
|
transactions.email_address | string |
email_address |
Voice
固定号码用作文本To-Speech(TTS)语音呼叫的发起方。 击键“1”和“2”用于接受或拒绝消息,“9”用于重定向呼叫。 有关详细信息,请参阅https://boomerangmessaging.com/docs/sending-delivering-voice-messages
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
voice_intro
|
voice_intro | string |
语音呼叫接听时播放的消息。 消息内容将在消息内容后立即播放。 |
|
|
voice_thank_you
|
voice_thank_you | string |
在播放消息内容后,在语音呼叫结束时播放的消息。 |
|
|
voice_redirect_message
|
voice_redirect_message | string |
在播放消息内容后,在语音呼叫结束时播放的消息。 |
|
|
数字
|
number | string |
重定向编号 |
|
|
voice_retries
|
voice_retries | integer |
如果未第一次接听语音呼叫,则尝试次数。 |
|
|
voice_delay
|
voice_delay | integer |
系统在重试之间等待的时间。 |
|
|
message_content
|
message_content | string |
发送到所有 recipientAddresses 的出站邮件的内容。 |
|
|
数字
|
number | string |
收件人的目标地址;必须至少包含 11 位数字(不包括 + 或前导“0”)的移动电话号码,最多包含 16 位数字(不包括一个 +,其中用作号码本身的预修复)。 可以传递单个数字或最多 10,000 个数字的数组。 |
|
|
priority
|
priority | boolean |
用于将优先级状态设置为消息的可选参数。 使用“优先级”发送的任何消息都将替代针对帐户配置的“社交时间”。 传递 true 以设置优先级。 |
|
|
unique_identifier
|
unique_identifier | string |
每个事务的唯一标识符。 这用于防止消息重复,因为 Boomerang 将忽略以前使用过 ID 的任何事务。 |
|
|
campaign_name
|
campaign_name | string |
可选标识符,可用于按特定市场活动和批处理消息对消息进行分组。 |
|
|
custom_parameter
|
custom_parameter | string |
用于自定义引用的参数。 例如,这可用作市场活动参考、作业引用、批处理 ID 等。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
状态
|
status | integer |
状态 |
|
消息
|
message | string |
消息 |
|
事务
|
transactions | array of object |
事务 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
短信单向
短信是使用字母数字发起方(如公司名称)传递的,该名称必须最多包含 11 个字符,并且收件人无法响应使用 alpha 数字发起方发送的邮件。 另请注意,在不支持使用 alpha 数字发起方传递消息的目标(由于本地限制),这可能会被数字发起方替换,以确保消息已传递。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
from
|
from | string |
1 向消息的发起 ID。 最多包含 11 个字符的 alpha 数值。 |
|
|
message_content
|
message_content | string |
发送到所有 recipientAddresses 的出站邮件的内容。 |
|
|
收件人的目标地址
|
number | string |
收件人的目标地址;必须至少包含 11 位数字(不包括 + 或前导“0”)的移动电话号码,最多包含 16 位数字(不包括一个 +,其中用作号码本身的预修复)。 可以传递单个数字或最多 10,000 个数字的数组。 |
|
|
priority
|
priority | boolean |
用于将优先级状态设置为消息的可选参数。 使用“优先级”发送的任何消息都将替代针对帐户配置的“社交时间”。 传递 true 以设置优先级。 |
|
|
unique_identifier
|
unique_identifier | string |
每个事务的唯一标识符。 这用于防止消息重复,因为 Boomerang 将忽略以前使用过 ID 的任何事务。 |
|
|
campaign_name
|
campaign_name | string |
可选标识符,可用于按特定市场活动和批处理消息对消息进行分组。 |
|
|
custom_parameter
|
custom_parameter | string |
用于自定义引用的参数。 例如,这可用作市场活动参考、作业引用、批处理 ID 等。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
状态
|
status | integer |
状态 |
|
消息
|
message | string |
消息 |
|
事务
|
transactions | array of object |
事务 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
短信双向
此方法允许直接针对每个出站事务跟踪答复,并用于管理系统与最终用户之间的对话。 回复可以转发到电子邮件地址,使用 Boommail 的客户可以将电子邮件 2 短信发回回复者。 有关双向和对话消息的详细信息,请参阅 https://boomerangmessaging.com/docs/sending-sms-messages。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
conversation_id
|
conversation_id | string |
定义对话 ID 以对同一对话中的所有邮件(包括答复)部分进行分组 |
|
|
message_content
|
message_content | string |
发送到所有 recipientAddresses 的出站邮件的内容。 |
|
|
收件人的目标地址
|
number | string |
收件人的目标地址;必须至少包含 11 位数字(不包括 + 或前导“0”)的移动电话号码,最多包含 16 位数字(不包括一个 +,其中用作号码本身的预修复)。 可以传递单个数字或最多 10,000 个数字的数组。 |
|
|
validity_period
|
validity_period | integer |
用于发送消息的数字将处于活动状态的时间段。 在有效期到期后,不会传递对邮件的答复。 对于双向消息,最小有效期为 1 天。 |
|
|
open_ticket
|
open_ticket | boolean |
默认情况下,所有消息都发送单个票证,这意味着消息在收到第一个响应时关闭。 若要将多个响应匹配到同一原始消息,请通过传递 true 来使用开放票证。 |
|
|
email_responses
|
email_responses | string |
将邮件响应转发到的电子邮件地址。 |
|
|
push_responses
|
push_responses | string |
将消息响应发布到的 CallBack URL。 |
|
|
priority
|
priority | boolean |
用于将优先级状态设置为消息的可选参数。 使用“优先级”发送的任何消息都将替代针对帐户配置的“社交时间”。 传递 true 以设置优先级。 |
|
|
unique_identifier
|
unique_identifier | string |
每个事务的唯一标识符。 这用于防止消息重复,因为 Boomerang 将忽略以前使用过 ID 的任何事务。 |
|
|
campaign_name
|
campaign_name | string |
可选标识符,可用于按特定市场活动和批处理消息对消息进行分组。 |
|
|
custom_parameter
|
custom_parameter | string |
用于自定义引用的参数。 例如,这可用作市场活动参考、作业引用、批处理 ID 等。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
状态
|
status | integer |
状态 |
|
消息
|
message | string |
消息 |
|
事务
|
transactions | array of object |
事务 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
短信自定义号码
使用请求中指定的号码传递短信,以便将任何答复返回到该号码。 使用 Boomerang 的“市场活动”功能的客户可以使用与市场活动关联的数字,这允许从 Boomerang UI 中的“市场活动报告”部分访问入站回复。 但是,与 SMS 2 向方法不同,不会针对出站消息跟踪答复。 有关详细信息,请参阅 https://boomerangmessaging.com/docs/sending-sms-messages。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
from
|
from | string |
与消息关联的发送 ID 可能是当前与活动市场活动关联的入站市场活动编号。 |
|
|
message_content
|
message_content | string |
发送到所有 recipientAddresses 的出站邮件的内容。 |
|
|
收件人的目标地址
|
number | string |
收件人的目标地址;必须至少包含 11 位数字(不包括 + 或前导“0”)的移动电话号码,最多包含 16 位数字(不包括一个 +,其中用作号码本身的预修复)。 可以传递单个数字或最多 10,000 个数字的数组。 |
|
|
priority
|
priority | boolean |
用于将优先级状态设置为消息的可选参数。 使用“优先级”发送的任何消息都将替代针对帐户配置的“社交时间”。 传递 true 以设置优先级。 |
|
|
unique_identifier
|
unique_identifier | string |
每个事务的唯一标识符。 这用于防止消息重复,因为 Boomerang 将忽略以前使用过 ID 的任何事务。 |
|
|
campaign_name
|
campaign_name | string |
可选标识符,可用于按特定市场活动和批处理消息对消息进行分组。 |
|
|
custom_parameter
|
custom_parameter | string |
用于自定义引用的参数。 例如,这可用作市场活动参考、作业引用、批处理 ID 等。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
状态
|
status | integer |
状态 |
|
消息
|
message | string |
消息 |
|
事务
|
transactions | array of object |
事务 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
触发器
| 在短信响应提交上 |
由入站答复触发,这些答复在以智能双向/对话消息的形式发送时自动映射到关联的出站消息 |
| 在送达时确认 |
由最终用户传递状态更新触发。 使用最终用户的网络操作员返回的传递状态更新事务。 有关详细信息,请参阅https://boomerangmessaging.com/docs |
在短信响应提交上
由入站答复触发,这些答复在以智能双向/对话消息的形式发送时自动映射到关联的出站消息
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
状态
|
status | integer |
状态 |
|
消息
|
message | string |
消息 |
|
has_more
|
has_more | boolean |
has_more |
|
答复
|
replies | array of object |
答复 |
|
transaction_id
|
replies.transaction_id | string |
transaction_id |
|
custom_parameter
|
replies.custom_parameter | string |
custom_parameter |
|
response_id
|
replies.response_id | string |
response_id |
|
from
|
replies.from | string |
from |
|
response_content
|
replies.response_content | string |
response_content |
|
is_new
|
replies.is_new | boolean |
is_new |
|
transaction_date
|
replies.transaction_date | string |
transaction_date |
|
response_date
|
replies.response_date | string |
response_date |
在送达时确认
由最终用户传递状态更新触发。 使用最终用户的网络操作员返回的传递状态更新事务。 有关详细信息,请参阅https://boomerangmessaging.com/docs
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
状态
|
status | integer |
状态 |
|
消息
|
message | string |
消息 |
|
has_more
|
has_more | boolean |
has_more |
|
drs
|
drs | array of object |
drs |
|
transaction_id
|
drs.transaction_id | string |
transaction_id |
|
状态
|
drs.status | string |
状态 |
|
status_date
|
drs.status_date | string |
status_date |
|
目标
|
drs.destination | string |
目标 |
|
custom_parameter
|
drs.custom_parameter | string |
custom_parameter |
|
campaign_name
|
drs.campaign_name | string |
campaign_name |
|
unique_id
|
drs.unique_id | string |
unique_id |