boomapp connect
"Интеллектуальный" глобальный 2-путь, электронная почта, голос, SMS и push-обмен сообщениями. Суперзарядка любых приложений Power Platform с помощью boomapp подключается к созданию рабочих процессов обмена данными с несколькими каналами (уникально на основе темы). Полностью интерактивные рабочие процессы запятых, основанные на ответе получателя, позволяют выполнять бесшовные и фрикционные взаимодействия без принудительного изменения поведения через взаимодействие. Дополнительные сведения и настройка бесплатной пробной учетной записи см. на нашем веб-сайте.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: — Облако Китая, управляемое 21Vianet |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure Для Китая |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: — Облако Китая, управляемое 21Vianet |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: — Облако Китая, управляемое 21Vianet |
| Контакт | |
|---|---|
| Имя | Поддержка Бумеранга |
| URL | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| Адрес электронной почты | support@boomcomms.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Бумеранг I-Comms Ltd |
| Веб-сайт | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| Политика конфиденциальности | https://boomerangmessaging.com/privacy/ |
| Категории | Коммуникация; Продуктивность |
Pre-requisites
Для продолжения вам потребуется следующее:
- План Microsoft Power Automate с пользовательским компонентом соединителя
- Подписка Boomerang
- Сведения о проверке подлинности API Boomerang.
Создание учетной записи с помощью Boomerang
- веб-сайт — дополнительные сведения о создании учетных записей Boomerang.
Поддержка и документация:
Здесь можно найти документацию.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| username | securestring | Имя пользователя для этого API | True |
| пароль | securestring | Пароль для этого API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Sms двухсторонняя |
Этот метод позволяет отслеживать ответы непосредственно по каждой исходящей транзакции и используется для управления беседами между системой и конечным пользователем. Ответы можно пересылать на адрес электронной почты, а клиенты с Boommail могут отправлять сообщение электронной почты-2-SMS обратно в ответ. Дополнительные сведения о 2-путь и обмен сообщениями в беседах см. в статье https://boomerangmessaging.com/docs/sending-sms-messages. |
| Sms односторонняя |
SMS-сообщения доставляются с помощью альфа-числового инициатора (например, имени компании), который должен содержать не более 11 символов, и получатель не может отвечать на сообщение, отправленное с помощью буквы-числового исходного элемента. Обратите внимание также, что в местах назначения, где доставка сообщений с альфа-числовым источником не поддерживается (из-за локальных ограничений), это может быть заменено числовым источником, чтобы обеспечить доставку сообщения. |
| Адрес электронной почты |
Отправка отдельных или массовых сообщений электронной почты. Сообщения электронной почты отправляются из домена @boomerangui.com и можно настроить тему и переопределить адрес from. Также можно перенаправить ответы на адрес электронной почты и /или URL-адрес |
| Голос |
Фиксированное число используется в качестве инициатора голосового вызова text-To-Speech (TTS). Нажатия клавиш "1" и "2" используются для принятия или отклонения сообщения, "9" используется для перенаправления вызова. Дополнительные сведения см. в статье https://boomerangmessaging.com/docs/sending-delivering-voice-messages |
| Настраиваемый номер SMS |
SMS-сообщения доставляются с помощью номера, указанного в запросе, чтобы все ответы возвращались в это число. Клиенты, использующие функцию кампании Бумеранга, могут использовать номер, связанный с кампанией, что позволяет получать доступ к входящим ответам из раздела отчетов кампании в пользовательском интерфейсе Boomerang. Однако в отличие от метода SMS 2-way ответы не отслеживаются по исходящему сообщению. См. https://boomerangmessaging.com/docs/sending-sms-messages для получения дополнительной информации. |
Sms двухсторонняя
Этот метод позволяет отслеживать ответы непосредственно по каждой исходящей транзакции и используется для управления беседами между системой и конечным пользователем. Ответы можно пересылать на адрес электронной почты, а клиенты с Boommail могут отправлять сообщение электронной почты-2-SMS обратно в ответ. Дополнительные сведения о 2-путь и обмен сообщениями в беседах см. в статье https://boomerangmessaging.com/docs/sending-sms-messages.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
conversation_id
|
conversation_id | string |
Определение идентификатора беседы для группировки всех сообщений (включая ответы) одной беседы |
|
|
message_content
|
message_content | string |
Содержимое исходящего сообщения, отправленного всем получателямAddresses. |
|
|
Адрес назначения получателя
|
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 |
URL-адрес обратного вызова, на который отправляются ответы на сообщения. |
|
|
priority
|
priority | boolean |
Необязательный параметр, используемый для задания состояния приоритета сообщения. Все сообщения, отправляемые с "приоритетом", переопределяют "Социальные часы", настроенные для учетной записи. Передайте значение true, чтобы задать приоритет. |
|
|
unique_identifier
|
unique_identifier | string |
Уникальный идентификатор для каждой транзакции. Это используется для защиты от дублирования сообщений, так как Boomerang будет игнорировать любые транзакции с идентификатором, который использовался ранее. |
|
|
campaign_name
|
campaign_name | string |
Необязательный идентификатор, который можно использовать для группировки сообщений по определенным кампаниям и пакетным сообщениям. |
|
|
custom_parameter
|
custom_parameter | string |
Параметр, используемый для пользовательской ссылки. Это можно использовать, например, как справочник по кампании, справочник по заданию, идентификатор пакетной службы и т. д. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
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 |
Sms односторонняя
SMS-сообщения доставляются с помощью альфа-числового инициатора (например, имени компании), который должен содержать не более 11 символов, и получатель не может отвечать на сообщение, отправленное с помощью буквы-числового исходного элемента. Обратите внимание также, что в местах назначения, где доставка сообщений с альфа-числовым источником не поддерживается (из-за локальных ограничений), это может быть заменено числовым источником, чтобы обеспечить доставку сообщения.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
от / из / с (context-dependent)
|
from | string |
Исходный идентификатор для 1-пути сообщения. Буквенно-числовое значение, содержащее не более 11 символов. |
|
|
message_content
|
message_content | string |
Содержимое исходящего сообщения, отправленного всем получателямAddresses. |
|
|
Адрес назначения получателя
|
number | string |
Адрес назначения получателя; Номер мобильного телефона, который должен содержать не менее 11 цифр (за исключением + или ведущих "0") и не более 16 цифр (за исключением +, где это используется в качестве предварительного исправления для самого числа). Можно передать одно число или массив размером до 10 000 чисел. |
|
|
priority
|
priority | boolean |
Необязательный параметр, используемый для задания состояния приоритета сообщения. Все сообщения, отправляемые с "приоритетом", переопределяют "Социальные часы", настроенные для учетной записи. Передайте значение true, чтобы задать приоритет. |
|
|
unique_identifier
|
unique_identifier | string |
Уникальный идентификатор для каждой транзакции. Это используется для защиты от дублирования сообщений, так как Boomerang будет игнорировать любые транзакции с идентификатором, который использовался ранее. |
|
|
campaign_name
|
campaign_name | string |
Необязательный идентификатор, который можно использовать для группировки сообщений по определенным кампаниям и пакетным сообщениям. |
|
|
custom_parameter
|
custom_parameter | string |
Параметр, используемый для пользовательской ссылки. Это можно использовать, например, как справочник по кампании, справочник по заданию, идентификатор пакетной службы и т. д. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
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 |
Адрес электронной почты
Отправка отдельных или массовых сообщений электронной почты. Сообщения электронной почты отправляются из домена @boomerangui.com и можно настроить тему и переопределить адрес from. Также можно перенаправить ответы на адрес электронной почты и /или URL-адрес
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
от / из / с (context-dependent)
|
from | string |
Передайте содержимое, которое будет использоваться в качестве адреса from. Если пустое значение по умолчанию будет взято из параметров учетной записи |
|
|
email_subject
|
email_subject | string |
Субъект по умолчанию отображается при получении сообщения электронной почты в папке "Входящие" получателя |
|
|
message_content
|
message_content | string |
Содержимое исходящего сообщения, отправленного всем получателямAddresses. |
|
|
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 |
URL-адрес обратного вызова, на который отправляются ответы на сообщения. |
|
|
unique_identifier
|
unique_identifier | string |
Уникальный идентификатор для каждой транзакции. Это используется для защиты от дублирования сообщений, так как Boomerang будет игнорировать любые транзакции с идентификатором, который использовался ранее. |
|
|
campaign_name
|
campaign_name | string |
Необязательный идентификатор, который можно использовать для группировки сообщений по определенным кампаниям и пакетным сообщениям. |
|
|
custom_parameter
|
custom_parameter | string |
Параметр, используемый для пользовательской ссылки. Это можно использовать, например, как справочник по кампании, справочник по заданию, идентификатор пакетной службы и т. д. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
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 |
Голос
Фиксированное число используется в качестве инициатора голосового вызова text-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 |
Содержимое исходящего сообщения, отправленного всем получателямAddresses. |
|
|
число/номер
|
number | string |
Адрес назначения получателя; Номер мобильного телефона, который должен содержать не менее 11 цифр (за исключением + или ведущих "0") и не более 16 цифр (за исключением +, где это используется в качестве предварительного исправления для самого числа). Можно передать одно число или массив размером до 10 000 чисел. |
|
|
priority
|
priority | boolean |
Необязательный параметр, используемый для задания состояния приоритета сообщения. Все сообщения, отправляемые с "приоритетом", переопределяют "Социальные часы", настроенные для учетной записи. Передайте значение true, чтобы задать приоритет. |
|
|
unique_identifier
|
unique_identifier | string |
Уникальный идентификатор для каждой транзакции. Это используется для защиты от дублирования сообщений, так как Boomerang будет игнорировать любые транзакции с идентификатором, который использовался ранее. |
|
|
campaign_name
|
campaign_name | string |
Необязательный идентификатор, который можно использовать для группировки сообщений по определенным кампаниям и пакетным сообщениям. |
|
|
custom_parameter
|
custom_parameter | string |
Параметр, используемый для пользовательской ссылки. Это можно использовать, например, как справочник по кампании, справочник по заданию, идентификатор пакетной службы и т. д. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
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 |
Настраиваемый номер SMS
SMS-сообщения доставляются с помощью номера, указанного в запросе, чтобы все ответы возвращались в это число. Клиенты, использующие функцию кампании Бумеранга, могут использовать номер, связанный с кампанией, что позволяет получать доступ к входящим ответам из раздела отчетов кампании в пользовательском интерфейсе Boomerang. Однако в отличие от метода SMS 2-way ответы не отслеживаются по исходящему сообщению. См. https://boomerangmessaging.com/docs/sending-sms-messages для получения дополнительной информации.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
от / из / с (context-dependent)
|
from | string |
Идентификатор отправки, связанный с сообщением, может быть номером входящей кампании, связанной в настоящее время с активной кампанией. |
|
|
message_content
|
message_content | string |
Содержимое исходящего сообщения, отправленного всем получателямAddresses. |
|
|
Адрес назначения получателя
|
number | string |
Адрес назначения получателя; Номер мобильного телефона, который должен содержать не менее 11 цифр (за исключением + или ведущих "0") и не более 16 цифр (за исключением +, где это используется в качестве предварительного исправления для самого числа). Можно передать одно число или массив размером до 10 000 чисел. |
|
|
priority
|
priority | boolean |
Необязательный параметр, используемый для задания состояния приоритета сообщения. Все сообщения, отправляемые с "приоритетом", переопределяют "Социальные часы", настроенные для учетной записи. Передайте значение true, чтобы задать приоритет. |
|
|
unique_identifier
|
unique_identifier | string |
Уникальный идентификатор для каждой транзакции. Это используется для защиты от дублирования сообщений, так как Boomerang будет игнорировать любые транзакции с идентификатором, который использовался ранее. |
|
|
campaign_name
|
campaign_name | string |
Необязательный идентификатор, который можно использовать для группировки сообщений по определенным кампаниям и пакетным сообщениям. |
|
|
custom_parameter
|
custom_parameter | string |
Параметр, используемый для пользовательской ссылки. Это можно использовать, например, как справочник по кампании, справочник по заданию, идентификатор пакетной службы и т. д. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
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 |
| При отправке SMS-ответа |
Активируется входящими ответами, которые автоматически сопоставляются с связанными исходящими сообщениями при отправке в виде интеллектуального 2-пути / беседного сообщения |
При доставке подтверждено
Активируется обновлением состояния доставки конечным пользователем. Обновляет транзакцию с состоянием доставки, возвращенным сетевым оператором конечного пользователя. Дополнительные сведения см. в статье https://boomerangmessaging.com/docs
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
status | integer |
статус |
|
сообщение
|
message | string |
сообщение |
|
есть_еще
|
has_more | boolean |
есть_еще |
|
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 |
|
destination
|
drs.destination | string |
destination |
|
custom_parameter
|
drs.custom_parameter | string |
custom_parameter |
|
campaign_name
|
drs.campaign_name | string |
campaign_name |
|
unique_id
|
drs.unique_id | string |
unique_id |
При отправке SMS-ответа
Активируется входящими ответами, которые автоматически сопоставляются с связанными исходящими сообщениями при отправке в виде интеллектуального 2-пути / беседного сообщения
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
статус
|
status | integer |
статус |
|
сообщение
|
message | string |
сообщение |
|
есть_еще
|
has_more | boolean |
есть_еще |
|
Ответы
|
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 |
|
от / из / с (context-dependent)
|
replies.from | string |
от / из / с (context-dependent) |
|
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 |