Plivo (предварительная версия)
Plivo позволяет отправлять и получать 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://support.plivo.com/support/home |
| Метаданные соединителя | |
|---|---|
| Publisher | Plivo Inc |
| Веб-сайт | https://www.plivo.com/ |
| Политика конфиденциальности | https://www.plivo.com/legal/privacy/ |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Идентификатор проверки подлинности | струна | Имя пользователя для этого API. | True |
| Маркер проверки подлинности | securestring | Пароль для этого API. | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Вывод сообщения |
Эта операция используется для получения сведений о сообщении с идентификатором сообщения. |
| Вывод списка всех сообщений |
Эта операция возвращает список всех сообщений, связанных с учетной записью Plivo. |
| Отправка SMS |
Эта операция используется для отправки текстового сообщения. |
| Совершить звонок |
Эта операция используется для вызова. |
Вывод сообщения
Эта операция используется для получения сведений о сообщении с идентификатором сообщения.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор UUID сообщения
|
message_uuid | True | string |
UUID сообщения, для которого необходимо получить сведения. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор API
|
api_id | string |
Уникальный идентификатор запроса API. |
|
Код ошибки
|
error_code | string |
Код ошибки доставки, если сообщение не доставлено. |
|
От
|
from_number | string |
Номер, из которого отправлено сообщение. |
|
Направление сообщения
|
message_direction | string |
Направление сообщения (входящий и исходящий трафик). |
|
Состояние доставки сообщений
|
message_state | string |
Состояние сообщения (в очереди, отправке или доставке или сбое). |
|
Отметка времени
|
message_time | string |
Метка времени, в которой было отправлено или получено сообщение (гггг-ММ-дд HH:mm:ss UTC). |
|
Тип сообщения
|
message_type | string |
Тип сообщения. |
|
Идентификатор UUID сообщения
|
message_uuid | string |
Уникальный идентификатор сообщения. |
|
URI сообщения
|
resource_uri | string |
URI для получения сведений об этом одном сообщении. |
|
Кому
|
to_number | string |
Номер, в который отправлено сообщение. |
|
Итоговая сумма
|
total_amount | string |
Сумма, взимается за сообщение. |
|
Ставка
|
total_rate | string |
Частота на единицу сообщения. |
|
Единицы
|
units | integer |
Количество единиц сообщения было разделено на. |
Вывод списка всех сообщений
Эта операция возвращает список всех сообщений, связанных с учетной записью Plivo.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор API
|
api_id | string |
Уникальный идентификатор запроса API. |
|
Лимит
|
meta.limit | integer |
Максимальное количество сообщений на одной странице. |
|
Next
|
meta.next | string |
URI следующей страницы сообщений, если существует. |
|
Смещение
|
meta.offset | integer |
Количество сообщений до этой страницы. |
|
Previous
|
meta.previous | string |
URI предыдущей страницы. |
|
Общее число
|
meta.total_count | integer |
Общее количество сообщений. |
|
Список сообщений
|
objects | array of object |
Сведения обо всех сообщениях. |
|
Код ошибки
|
objects.error_code | string |
Код ошибки доставки, если сообщение не доставлено. |
|
От
|
objects.from_number | string |
Номер, из которого отправлено сообщение. |
|
Направление сообщения
|
objects.message_direction | string |
Направление сообщения (входящий и исходящий трафик). |
|
Состояние доставки сообщений
|
objects.message_state | string |
Состояние сообщения (в очереди, отправке или доставке или сбое). |
|
Отметка времени
|
objects.message_time | string |
Метка времени, в которой было отправлено или получено сообщение (гггг-ММ-дд HH:mm:ss UTC). |
|
Тип сообщения
|
objects.message_type | string |
Тип сообщения. |
|
Идентификатор UUID сообщения
|
objects.message_uuid | string |
Уникальный идентификатор сообщения. |
|
URI сообщения
|
objects.resource_uri | string |
URI для получения сведений об этом одном сообщении. |
|
Кому
|
objects.to_number | string |
Номер, в который отправлено сообщение. |
|
Итоговая сумма
|
objects.total_amount | string |
Сумма, взимается за сообщение. |
|
Ставка
|
objects.total_rate | string |
Частота на единицу сообщения. |
|
Единицы
|
objects.units | integer |
Количество единиц сообщения было разделено на. |
Отправка SMS
Эта операция используется для отправки текстового сообщения.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
От
|
src | True | string |
Номер Plivo, из которого отправляется сообщение. |
|
Кому
|
dst | True | string |
Номер телефона, в который отправляется сообщение. |
|
Message
|
text | True | string |
Текст отправленного сообщения. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор API
|
api_id | string |
Уникальный идентификатор запроса API. |
|
Ответ
|
message | string |
Ответ отправленного сообщения. |
|
Идентификатор UUID сообщения
|
message_uuid | array of string |
Уникальный идентификатор сообщения. |
Совершить звонок
Эта операция используется для вызова.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
От
|
from | True | string |
Номер Plivo, используемый для вызова. |
|
Кому
|
to | True | string |
Номер телефона для звонка. |
|
URL-адрес ответа
|
answer_url | True | string |
URL-адрес для вызова при вызове. |
|
Метод ответов
|
answer_method | string |
Метод HTTP (GET/POST), который следует использовать для вызова URL-адреса ответа. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор API
|
api_id | string |
Уникальный идентификатор запроса API. |
|
Ответ
|
message | string |
Ответ, полученный при вызове. |
|
Вызов UUID
|
request_uuid | string |
Уникальный идентификатор вызова. |