Twilio
Twilio позволяет приложениям отправлять и получать глобальные SMS, MMS и IP-сообщения.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Стандарт | Все регионы Power Apps , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL |
Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Website | https://www.twilio.com/ |
| Политика конфиденциальности | https://www.twilio.com/legal/privacy |
Требования
Соединитель Twilio требует следующей информации:
Идентификатор учетной записи Twilio и маркер проверки подлинности, который можно найти на панели мониторинга Twilio, чтобы авторизовать создание подключения из приложения. Если вы используете пробную учетную запись Twilio, вы можете отправлять текстовые сообщения только на проверенные номера телефонов.
Один проверенный номер телефона Twilio, который может отправлять текстовые сообщения и другой номер телефона, который может получать текстовые сообщения.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Доступный для общего пользования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Идентификатор учетной записи Twilio | securestring | Идентификатор учетной записи Twilio | True |
| Маркер доступа Twilio | securestring | Маркер доступа Twilio | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 1200 | 60 секунд |
Действия
| Вывод списка сообщений [не рекомендуется] |
Возвращает список сообщений, связанных с вашей учетной записью. |
| Вывод списка сообщений версии 2 |
Возвращает список сообщений, связанных с вашей учетной записью. Это действие поддерживает разбиение на страницы. |
| Отправка текстового сообщения (SMS) |
Эта операция используется для отправки нового сообщения на мобильный номер. |
| Получение сообщения |
Эта операция возвращает одно сообщение, указанное указанным идентификатором сообщения. |
Вывод списка сообщений [не рекомендуется]
Возвращает список сообщений, связанных с вашей учетной записью.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Номер телефона
|
To | string |
Отображаются только сообщения на этот номер телефона. |
|
|
Номер телефона
|
From | string |
Отображаются только сообщения из этого номера телефона. |
|
|
Дата отправки
|
DateSent | date |
Отображаются только сообщения, отправленные на эту дату (в формате GMT), заданные как ГГГГ-ММ-ДД. Пример: 2009-07-06. |
|
|
Лимит
|
PageSize | integer |
Сколько ресурсов нужно вернуть на каждой странице списка. Значение по умолчанию — 50. |
|
|
Страница
|
Page | integer |
Номер страницы. Значение по умолчанию — 0. |
Возвращаемое значение
Список одного или нескольких сообщений.
- Список сообщений
- MessageList
Вывод списка сообщений версии 2
Возвращает список сообщений, связанных с вашей учетной записью. Это действие поддерживает разбиение на страницы.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Номер телефона
|
To | string |
Отображаются только сообщения на этот номер телефона. |
|
|
Номер телефона
|
From | string |
Отображаются только сообщения из этого номера телефона. |
|
|
Дата отправки
|
DateSent | date |
Отображаются только сообщения, отправленные на эту дату (в формате GMT), заданные как ГГГГ-ММ-ДД. Пример: 2009-07-06. |
|
|
Лимит
|
PageSize | integer |
Сколько ресурсов нужно вернуть на каждой странице списка. Значение по умолчанию — 50. |
Возвращаемое значение
Список одного или нескольких сообщений.
- Список сообщений версии 2
- MessageListV2
Отправка текстового сообщения (SMS)
Эта операция используется для отправки нового сообщения на мобильный номер.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Номер телефона
|
from | True | string |
Номер телефона Twilio (в формате E.164) или буквенно-цифровой идентификатор отправителя, включенный для типа сообщения, которое вы хотите отправить. |
|
Номер телефона
|
to | True | string |
Номер целевого телефона. Формат с кодом страны "+", например +16175551212 (формат E.164). |
|
Текст
|
body | True | string |
Текст сообщения, которое нужно отправить, ограничено 1600 символами. |
|
URL-адреса мультимедиа
|
media_url | array of uri |
Список URI мультимедиа для отправки. |
|
|
Обратный вызов состояния
|
StatusCallback | uri |
URL-адрес, который Twilio будет POST при каждом изменении состояния сообщения. |
|
|
Идентификатор службы обмена сообщениями
|
messaging_service_sid | string |
Уникальный идентификатор службы обмена сообщениями. |
|
|
Идентификатор безопасности приложения
|
application_sid | string |
Идентификатор безопасности приложения Twilio, настроенного с обязательным обратным вызовом состояния сообщения. |
|
|
Максимальная цена
|
max_price | string |
Общий максимальный предел цены для сообщения. |
|
|
Срок действия
|
validity_period | string |
Количество секунд, которые сообщение может остаться в очереди Twilio. |
Возвращаемое значение
Proprties одного сообщения.
- Message
- Message
Получение сообщения
Эта операция возвращает одно сообщение, указанное указанным идентификатором сообщения.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор безопасности сообщений
|
MessageId | True | string |
Уникальный идентификатор безопасности сообщения. |
Возвращаемое значение
Proprties одного сообщения.
- Message
- Message
Определения
Message
Proprties одного сообщения.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Текст
|
body | string |
Текст сообщения. |
|
Из числа
|
from | phone |
Номер телефона, из которого отправлено сообщение. |
|
Число
|
to | phone |
Номер телефона, на который отправлено сообщение. |
|
Состояние
|
status | string |
Отправлено состояние сообщения. |
|
SID
|
sid | string |
ИДЕНТИФИКАТОР отправленного сообщения. |
|
Идентификатор учетной записи
|
account_sid | string |
Идентификатор безопасности учетной записи, связанной с отправленным сообщением. |
|
API
|
api_version | string |
Версия API, используемая для отправки сообщения. |
|
Число сегментов
|
num_segments | string |
Количество сегментов сообщения разделено на. |
|
Число носителей
|
num_media | string |
Количество файлов мультимедиа, связанных с отправленным сообщением. |
|
Создан Date-Time
|
date_created | string |
гггг-ММ-ddTHH:mm:ss.fffZ (формат UTC) |
|
Отправленные Date-Time
|
date_sent | string |
гггг-ММ-ddTHH:mm:ss.fffZ (формат UTC) |
|
Обновленные Date-Time
|
date_updated | string |
гггг-ММ-ddTHH:mm:ss.fffZ (формат UTC) |
|
Направление
|
direction | string |
Направление, связанное с отправленным сообщением. |
|
Коды ошибок
|
error_code | integer |
Коды ошибок, связанные с отправленным сообщением, если таковые есть. |
|
Сообщения об ошибках
|
error_message | string |
Сообщения об ошибках, связанные с отправленным сообщением, если таковые есть. |
|
Цена
|
price | string |
Стоимость отправленного сообщения. |
|
Единица
|
price_unit | string |
Цена, используемая для оценки стоимости сообщения. |
|
URI
|
uri | uri |
Относительный универсальный код ресурса (URI) для этого ресурса. |
|
URI подресурсов
|
subresource_uris | object |
Относительные URI для любых подресурсов. |
|
Идентификатор службы обмена сообщениями
|
messaging_service_sid | string |
Уникальный идентификатор службы обмена сообщениями. |
MessageList
Список одного или нескольких сообщений.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
Страница
|
page | integer |
Номер страницы повторного использования. |
|
Лимит
|
page_size | integer |
Размер страницы ответа. |
|
Число страниц
|
num_pages | integer |
Общее количество страниц в ответе. |
|
Start
|
start | integer |
Индекс первого сообщения. |
|
Конец
|
end | integer |
Индекс последнего сообщения. |
|
URI
|
uri | uri |
Относительный универсальный код ресурса (URI) для этого списка. |
|
Универсальный код ресурса (URI) первой страницы
|
first_page_uri | uri |
Относительный универсальный код ресурса (URI) для первой страницы. |
|
URI следующей страницы
|
next_page_uri | uri |
Относительный универсальный код ресурса (URI) для следующей страницы. |
|
Число сообщений
|
total | integer |
Общее количество сообщений. |
|
URI предыдущей страницы
|
previous_page_uri | uri |
Относительный универсальный код ресурса (URI) для предыдущей страницы. |
MessageListV2
Список одного или нескольких сообщений.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
Относительный универсальный код ресурса (URI) для следующей страницы. |
|
value
|
value | array of Message |
Список одного или нескольких сообщений. |