MessageBird SMS (независимый издатель) (предварительная версия)
Sms-служба messagebird позволяет отправлять и получать SMS-сообщения из любой страны мира.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Трой Тейлор |
| URL | https://www.hitachisolutions.com |
| Адрес электронной почты | ttaylor@hitachisolutions.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Трой Тейлор |
| Веб-сайт | https://messagebird.com/ |
| Политика конфиденциальности | https://messagebird.com/legal/terms |
| Категории | Communication |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ доступа (в форме AccessKey yourAccessKey) | securestring | Ключ доступа (в форме AccessKey yourAccessKey) для этого API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Отправка SMS |
Создайте и отправьте SMS-сообщение. |
| Отправка пакетного SMS |
Отправляет пакет SMS-сообщений. |
| Просмотр сообщения |
Извлеките сведения о существующем входящего или исходящем SMS-сообщении. |
| Список сообщений |
Получение списка всех входящих и исходящих SMS-сообщений. |
Отправка SMS
Создайте и отправьте SMS-сообщение.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Получатели
|
recipients | True | array of string |
Получатели. |
|
Создатель
|
originator | True | string |
Источник. |
|
Короткий код
|
shortcode | integer |
Короткий код. |
|
|
Тело
|
body | True | string |
Текст сообщения. |
|
Идентификаторы групп
|
groupIds | array of string |
Идентификаторы группы. |
|
|
Тип
|
type | string |
Тип. |
|
|
Reference
|
reference | string |
Ссылка. |
|
|
URL-адрес отчета
|
reportUrl | string |
URL-адрес отчета. |
|
|
Обоснованность
|
validity | integer |
Допустимость. |
|
|
Gateway
|
gateway | integer |
Шлюз. |
|
|
Кодирование данных
|
datacoding | string |
Кодирование данных. |
|
|
Класс message
|
mclass | integer |
Класс сообщения. |
|
|
Сокращение URL-адресов
|
shortenUrls | boolean |
Сокращены ли URL-адреса. |
|
|
Запланированное время даты
|
scheduledDatetime | string |
Запланированное время даты и времени. |
|
|
Создание даты и времени
|
createdDatetime | string |
При создании даты и времени. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор. |
|
HREF
|
href | string |
The HREF. |
|
Направление
|
direction | string |
Направление. |
|
Тип
|
type | string |
Тип. |
|
Создатель
|
originator | string |
Источник. |
|
Тело
|
body | string |
Текст сообщения. |
|
Reference
|
reference | string |
Ссылка. |
|
Обоснованность
|
validity | string |
Допустимость. |
|
Gateway
|
gateway | integer |
Шлюз. |
|
Кодирование данных
|
datacoding | string |
Кодирование данных. |
|
Класс message
|
mclass | integer |
Класс сообщения. |
|
Запланированное время даты
|
scheduledDatetime | string |
Запланированное время даты и времени. |
|
Создание даты и времени
|
createdDatetime | string |
При создании даты и времени. |
|
Общее число
|
recipients.totalCount | integer |
Общее число. |
|
Общее число отправленных сообщений
|
recipients.totalSentCount | integer |
Общее число отправленных сообщений. |
|
Общее количество доставленных данных
|
recipients.totalDeliveredCount | integer |
Общее количество доставленных данных. |
|
Общее число неудачных поставок
|
recipients.totalDeliveryFailedCount | integer |
Общее число неудачных поставок. |
|
Товары
|
recipients.items | array of object | |
|
Recipient
|
recipients.items.recipient | integer |
Получатель. |
|
Состояние
|
recipients.items.status | string |
Состояние. |
|
Дата времени состояния
|
recipients.items.statusDatetime | string |
Дата и время состояния. |
Отправка пакетного SMS
Отправляет пакет SMS-сообщений.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Получатели
|
recipients | array of string |
Получатели. |
|
|
Создатель
|
originator | string |
Источник. |
|
|
Тело
|
body | string |
Тело. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
array of object | ||
|
Идентификатор
|
id | string |
Идентификатор. |
|
HREF
|
href | string |
The HREF. |
|
Направление
|
direction | string |
Направление. |
|
Тип
|
type | string |
Тип. |
|
Создатель
|
originator | string |
Источник. |
|
Тело
|
body | string |
Тело. |
|
Reference
|
reference | string |
Ссылка. |
|
Обоснованность
|
validity | string |
Допустимость. |
|
Gateway
|
gateway | integer |
Шлюз. |
|
Кодирование данных
|
datacoding | string |
Кодирование данных. |
|
Класс message
|
mclass | integer |
Класс сообщения. |
|
Запланированное время даты
|
scheduledDatetime | string |
Дата и время расписания. |
|
Создание даты и времени
|
createdDatetime | string |
При создании даты и времени. |
|
Общее число
|
recipients.totalCount | integer |
Общее число. |
|
Общее число отправленных сообщений
|
recipients.totalSentCount | integer |
Общее число отправленных сообщений. |
|
Общее количество доставленных данных
|
recipients.totalDeliveredCount | integer |
Общее количество доставленных данных. |
|
Общее число неудачных поставок
|
recipients.totalDeliveryFailedCount | integer |
Общее число неудачных поставок. |
|
Товары
|
recipients.items | array of object | |
|
Recipient
|
recipients.items.recipient | integer |
Получатель. |
|
Состояние
|
recipients.items.status | string |
Состояние. |
|
Дата времени состояния
|
recipients.items.statusDatetime | string |
Дата и время состояния. |
Просмотр сообщения
Извлеките сведения о существующем входящего или исходящем SMS-сообщении.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сообщения
|
messageId | True | string |
Идентификатор сообщения. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор. |
|
HREF
|
href | string |
The HREF. |
|
Направление
|
direction | string |
Направление. |
|
Тип
|
type | string |
Тип. |
|
Создатель
|
originator | string |
Источник. |
|
Тело
|
body | string |
Текст сообщения. |
|
Reference
|
reference | string |
Ссылка. |
|
Обоснованность
|
validity | string |
Допустимость. |
|
Gateway
|
gateway | integer |
Шлюз. |
|
Кодирование данных
|
datacoding | string |
Кодирование данных. |
|
Класс message
|
mclass | integer |
Класс сообщения. |
|
Запланированное время даты
|
scheduledDatetime | string |
Запланированное время даты и времени. |
|
Создание даты и времени
|
createdDatetime | string |
При создании даты и времени. |
|
Общее число
|
recipients.totalCount | integer |
Общее число. |
|
Общее число отправленных сообщений
|
recipients.totalSentCount | integer |
Общее число отправленных сообщений. |
|
Общее количество доставленных данных
|
recipients.totalDeliveredCount | integer |
Общее количество доставленных данных. |
|
Общее число неудачных поставок
|
recipients.totalDeliveryFailedCount | integer |
Общее число неудачных поставок. |
|
Товары
|
recipients.items | array of object | |
|
Recipient
|
recipients.items.recipient | integer |
Получатель. |
|
Состояние
|
recipients.items.status | string |
Состояние. |
|
Причина состояния
|
recipients.items.statusReason | string |
Причина состояния. |
|
Код ошибки состояния
|
recipients.items.statusErrorCode | string |
Код ошибки состояния. |
|
Дата времени состояния
|
recipients.items.statusDatetime | string |
Дата и время состояния. |
|
Страна получателя
|
recipients.items.recipientCountry | string |
Страна получателя. |
|
Префикс страны получателя
|
recipients.items.recipientCountryPrefix | integer |
Префикс страны получателя. |
|
Оператор получателя
|
recipients.items.recipientOperator | string |
Оператор получателя. |
|
MCCMNC
|
recipients.items.mccmnc | string |
The MCCMNC. |
|
MCC
|
recipients.items.mcc | string |
The MCC. |
|
MNC
|
recipients.items.mnc | string |
The MNC. |
|
Длина сообщения
|
recipients.items.messageLength | integer |
Длина сообщения. |
|
Число частей сообщения
|
recipients.items.messagePartCount | integer |
Число частей сообщения. |
|
Сумма
|
recipients.items.price.amount | float |
Сумма. |
|
Валюта
|
recipients.items.price.currency | string |
Валюта. |
Список сообщений
Получение списка всех входящих и исходящих SMS-сообщений.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Создатель
|
originator | string |
Источник. |
|
|
Recipient
|
recipient | string |
Получатель. |
|
|
Направление
|
direction | string |
Направление. |
|
|
Лимит
|
limit | string |
Предел. |
|
|
Смещение
|
offset | integer |
Смещение. |
|
|
Условия поиска
|
searchterm | string |
Условия поиска. |
|
|
Тип
|
type | string |
Тип. |
|
|
Код контактного лица
|
contact_id | integer |
Идентификатор контакта. |
|
|
Состояние
|
status | string |
Состояние. |
|
|
От
|
from | string |
От. |
|
|
До условия
|
until | string |
Пока. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Смещение
|
offset | integer |
Смещение. |
|
Лимит
|
limit | integer |
Предел. |
|
Численность
|
count | integer |
Количество. |
|
Общее число
|
totalCount | integer |
Общее число. |
|
First
|
links.first | string |
Первое. |
|
Previous
|
links.previous | string |
Предыдущий. |
|
Next
|
links.next | string |
Далее. |
|
Last
|
links.last | string |
Последний. |
|
Товары
|
items | array of object | |
|
Идентификатор
|
items.id | string |
Идентификатор. |
|
HREF
|
items.href | string |
The HREF. |
|
Направление
|
items.direction | string |
Направление. |
|
Тип
|
items.type | string |
Тип. |
|
Создатель
|
items.originator | string |
Источник. |
|
Тело
|
items.body | string |
Тело. |
|
Reference
|
items.reference | string |
Ссылка. |
|
Обоснованность
|
items.validity | string |
Допустимость. |
|
Gateway
|
items.gateway | integer |
Шлюз. |
|
Кодирование данных
|
items.datacoding | string |
Кодирование данных. |
|
Класс message
|
items.mclass | integer |
Класс сообщения. |
|
Запланированное время даты
|
items.scheduledDatetime | string |
Запланированное время даты и времени. |
|
Создание даты и времени
|
items.createdDatetime | string |
При создании даты и времени. |
|
Общее число
|
items.recipients.totalCount | integer |
Общее число. |
|
Общее число отправленных сообщений
|
items.recipients.totalSentCount | integer |
Общее число отправленных сообщений. |
|
Общее количество доставленных данных
|
items.recipients.totalDeliveredCount | integer |
Общее количество доставленных данных. |
|
Общее число неудачных поставок
|
items.recipients.totalDeliveryFailedCount | integer |
Общее число неудачных поставок. |
|
Товары
|
items.recipients.items | array of object | |
|
Recipient
|
items.recipients.items.recipient | integer |
Получатель. |
|
Создатель
|
items.recipients.items.originator | string |
Источник. |
|
Состояние
|
items.recipients.items.status | string |
Состояние. |
|
Причина состояния
|
items.recipients.items.statusReason | string |
Причина состояния. |
|
Код ошибки состояния
|
items.recipients.items.statusErrorCode | string |
Код ошибки состояния. |
|
Дата времени состояния
|
items.recipients.items.statusDatetime | string |
Дата и время состояния. |
|
Страна получателя
|
items.recipients.items.recipientCountry | string |
Страна получателя. |
|
Префикс страны получателя
|
items.recipients.items.recipientCountryPrefix | integer |
Префикс страны получателя. |
|
Оператор получателя
|
items.recipients.items.recipientOperator | string |
Оператор получателя. |
|
MCCMNC
|
items.recipients.items.mccmnc | string |
Код оператора отправителя сообщения. |
|
MCC
|
items.recipients.items.mcc | string |
The MCC. |
|
MNC
|
items.recipients.items.mnc | string |
The MNC. |
|
Длина сообщения
|
items.recipients.items.messageLength | integer |
Длина сообщения. |
|
Число частей сообщения
|
items.recipients.items.messagePartCount | integer |
Число частей сообщения. |
|
Сумма
|
items.recipients.items.price.amount | float |
Сумма. |
|
Валюта
|
items.recipients.items.price.currency | string |
Валюта. |