Sinch (предварительная версия)
Sinch помогает вашему бизнесу взаимодействовать с клиентами с помощью оповещений, напоминаний, приглашений, маркетинговых кампаний и т. д. На платформе Sinch Engage, Sinch MessageMedia, One NZ, eTXT и GroupText наши платформы предоставляют миллиарды сообщений глобально. С помощью этого соединителя вы можете легко интегрировать SMS и RCS в рабочие процессы, оптимизировать и автоматизировать взаимодействие с клиентами.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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://messagemedia.com/contact/ |
| Адрес электронной почты | support@messagemedia.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Синч Швеция AB |
| Веб-сайт | https://messagemedia.com |
| Политика конфиденциальности | https://messagemedia.com/legal/privacy-policy/ |
| Категории | Communication |
Имя соединителя
Синч
Документация по API
https://messagemedia.github.io/documentation/#tag/Messages/operation/SendMessages
Поддерживаемые операции
https://support.messagemedia.com/hc/en-us/categories/10710547404559-Power-Automate-App-Support
Получение учетных данных
Этот соединитель использует API Key и API secret проверку подлинности (см. инструкции по получению. https://support.messagemedia.com/hc/en-us/articles/4413627066383-Creating-New-API-Credentials
Поддерживаемые операции
Этот соединитель поддерживает следующие операции:
-
Send Text Message (SMS): отправьте текстовое сообщение нескольким мобильным получателям. -
Send Rich Text Message (RCS): отправка сообщения с форматированным текстом (RCS). -
Get sender IDs: это действие вернет список идентификаторов отправителя, связанных с вашей учетной записью. -
Get message status: получение состояния сообщения с помощью идентификатора сообщения -
When SMS or RCS is received: эта операция активируется при получении входящего сообщения (SMS или RCS). -
When delivery receipt is received: эта операция активируется при получении квитанции о доставке для исходящего сообщения (SMS или RCS).
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| ключ API | securestring | Api_key для этого API | True |
| api_secret | securestring | Api_secret для этого API | True |
| Службы Sinch | струна | Это API, к которому подключено подключение, выберите один из следующих вариантов: Sinch MessageMedia (лучший для конкретных учетных записей Азии); Sinch engage (Best for Europe, US accounts) | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Отправка сообщения с форматированным текстом (RCS) |
Отправка сообщения с форматированным текстом (RCS) |
| Отправка текстового сообщения (SMS) |
Это действие используется для отправки текстового сообщения (SMS) на номер мобильного телефона. |
| Получение идентификаторов отправителя |
Это действие вернет список идентификаторов отправителя, связанных с вашей учетной записью. |
| Получение состояния сообщения |
Получение состояния сообщения с помощью идентификатора сообщения |
Отправка сообщения с форматированным текстом (RCS)
Отправка сообщения с форматированным текстом (RCS)
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
Отправка текстового сообщения (SMS)
Это действие используется для отправки текстового сообщения (SMS) на номер мобильного телефона.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор отправителя
|
source_number | string |
Указание исходного номера, используемого |
|
|
Номер назначения
|
to | True | string |
Мобильный номер получателя в формате E.164. Максимум 100 получателей, разделенных пробелом |
|
Message
|
message | True | string |
Текст SMS-сообщения |
|
Отчет о доставке
|
delivery_report | boolean |
Отчеты о доставке можно запрашивать с каждым сообщением. Если запрашиваются отчеты о доставке, веб-перехватчик будет отправлен в свойство callback_url, указанное для сообщения (или в веб-перехватчики). |
|
|
URL-адрес обратного вызова
|
callback_url | string |
URL-адрес можно включить в каждое сообщение, в которое веб-перехватчики будут отправляться через HTTP-запрос POST |
|
|
Ключ метаданных
|
metadata_key | string |
Ключ метаданных |
|
|
Значение метаданных
|
metadata_value | string |
Значение метаданных |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Отчеты о доставке можно запрашивать с каждым сообщением. Если запрашиваются отчеты о доставке, веб-перехватчик будет отправлен в свойство callback_url, указанное для сообщения (или в веб-перехватчики). |
|
destination_number
|
messages.destination_number | string |
номер назначения |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
Метка времени истечения срока действия сообщения |
|
message_flags
|
messages.message_flags | array of |
Флаги сообщений |
|
message_id
|
messages.message_id | string |
Идентификатор сообщения |
|
Исходный материал
|
messages.metadata.Source | string |
Исходный материал |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
статус
|
messages.status | string |
статус |
|
содержимое
|
messages.content | string |
содержимое |
|
source_number
|
messages.source_number | string |
исходный номер |
|
мультимедиа
|
messages.media | array of string |
мультимедиа |
|
субъект
|
messages.subject | string |
субъект |
Получение идентификаторов отправителя
Это действие вернет список идентификаторов отправителя, связанных с вашей учетной записью.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
page
|
pagination.page | integer |
page |
|
page_size
|
pagination.page_size | integer |
page_size |
|
total_count
|
pagination.total_count | integer |
total_count |
|
page_count
|
pagination.page_count | integer |
page_count |
|
type
|
default_sender.type | string |
type |
|
число/номер
|
default_sender.number | string |
число/номер |
|
source_type
|
default_sender.source_type | string |
source_type |
|
mms_capable
|
default_sender.mms_capable | boolean |
mms_capable |
|
Отправителей
|
senders | array of object |
Отправителей |
|
display_type
|
senders.display_type | string |
display_type |
|
is_default
|
senders.is_default | boolean |
is_default |
|
label
|
senders.label | string |
label |
|
mms_capable
|
senders.mms_capable | boolean |
mms_capable |
|
число/номер
|
senders.number | string |
число/номер |
|
number_id
|
senders.number_id | string |
number_id |
|
source_type
|
senders.source_type | string |
source_type |
|
type
|
senders.type | string |
type |
|
number_status
|
senders.number_status | string |
number_status |
|
account_id
|
account_id | string |
account_id |
|
vendor_id
|
vendor_id | string |
vendor_id |
Получение состояния сообщения
Получение состояния сообщения с помощью идентификатора сообщения
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Уникальный идентификатор этого сообщения
|
messageId | True | string |
Уникальный идентификатор этого сообщения |
Возвращаемое значение
- Тело
- message
Триггеры
| При получении SMS или RCS |
Эта операция активируется при получении входящего текстового сообщения (SMS). |
| При получении квитанции о доставке |
Эта операция активируется при получении квитанции о доставке для исходящего текстового сообщения (SMS). |
При получении SMS или RCS
Эта операция активируется при получении входящего текстового сообщения (SMS).
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
message_id
|
message_id | string |
Идентификатор исходного сообщения |
|
reply_id
|
reply_id | string |
Уникальный идентификатор ответа, который представляет это уведомление |
|
статус
|
status | string |
Отчеты о доставке указывают состояние сообщения |
|
source_address
|
source_address | string |
исходный адрес |
|
destination_address
|
destination_address | string |
адрес назначения |
|
содержимое
|
content | string |
Содержимое ответа |
|
Содержимое сообщения версии 2 — текст
|
contact_message.text_message.text | string |
Содержимое сообщения версии 2 — текст |
|
type
|
type | string |
type |
|
status_code
|
status_code | string |
Коды состояния предоставляют более подробную информацию о состоянии сообщения |
|
submitted_date
|
submitted_date | string |
Метка времени сообщения |
|
date_received
|
date_received | string |
Метка времени поставщика |
|
Attachments
|
attachments | array of object |
Список, содержащий все вложения, включенные в ответ. Это поле присутствует только в том случае, если в вашей учетной записи включена входящий MMS- и ответ содержит вложения. |
|
Тип вложения
|
attachments.attachment_type | string |
Тип MIME, связанный с этим вложением |
|
Содержимое вложения
|
attachments.attachment_content | string |
Вложения Base64 закодированы |
|
Имя вложения
|
attachments.attachment_name | string |
Имя вложения |
|
Метаданные
|
metadata | array of object |
Все метаданные, включенные в исходный запрос на отправку сообщения |
|
Ключ метаданных
|
metadata.metadata_key | string |
Ключ метаданных |
|
Значение метаданных
|
metadata.metadata_value | string |
Значение метаданных |
При получении квитанции о доставке
Эта операция активируется при получении квитанции о доставке для исходящего текстового сообщения (SMS).
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
message_id
|
message_id | string |
Идентификатор исходного сообщения |
|
статус
|
status | string |
Отчеты о доставке указывают состояние сообщения |
|
source_address
|
source_address | string |
исходный адрес |
|
destination_address
|
destination_address | string |
адрес назначения |
|
содержимое
|
content | string |
содержимое |
|
type
|
type | string |
type |
|
delivery_report_id
|
delivery_report_id | string |
Идентификатор отчета о доставке |
|
status_code
|
status_code | string |
Коды состояния предоставляют более подробную информацию о состоянии сообщения |
|
submitted_date
|
submitted_date | string |
Метка времени сообщения |
|
date_received
|
date_received | string |
Метка времени поставщика |
|
Attachments
|
attachments | array of object |
Attachments |
|
Тип вложения
|
attachments.attachment_type | string |
Тип вложения |
|
Содержимое вложения
|
attachments.attachment_content | string |
Содержимое вложения |
|
Имя вложения
|
attachments.attachment_name | string |
Имя вложения |
|
Метаданные
|
metadata | array of object |
Все метаданные, включенные в исходное сообщение отправки |
|
Ключ метаданных
|
metadata.metadata_key | string |
Ключ метаданных |
|
Значение метаданных
|
metadata.metadata_value | string |
Значение метаданных |
Определения
сообщение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
callback_url
|
callback_url | string |
URL-адрес можно включить в каждое сообщение, в которое веб-перехватчики будут отправляться через HTTP-запрос POST |
|
delivery_report
|
delivery_report | boolean |
Отчеты о доставке можно запрашивать с каждым сообщением. Если запрашиваются отчеты о доставке, веб-перехватчик будет отправлен в свойство callback_url, указанное для сообщения (или в веб-перехватчики). |
|
destination_number
|
destination_number | string |
Номер назначения, в который должно быть доставлено сообщение |
|
format
|
format | string |
Формат указывает, какой формат сообщения будет отправляться как SMS (текстовое сообщение), MMS (мультимедийное сообщение) или TTS (текст в речь) |
|
message_expiry_timestamp
|
message_expiry_timestamp | string |
Метка времени истечения срока действия сообщения может быть предоставлена, чтобы указать последнее время доставки сообщения. |
|
message_flags
|
message_flags | array of |
message_flags |
|
message_id
|
message_id | string |
Идентификатор сообщения |
|
Исходный материал
|
metadata.Source | string |
Исходный материал |
|
scheduled
|
scheduled | string |
Время запланированной доставки сообщения |
|
статус
|
status | string |
Состояние сообщения |
|
содержимое
|
content | string |
содержимое |
|
source_number
|
source_number | string |
исходный номер |
|
мультимедиа
|
media | array of string |
мультимедиа |
|
субъект
|
subject | string |
субъект |