Гравитация SMS (предварительная версия)
Отправка и получение SMS-сообщений через RingCentral. Подключите учетную запись RingCentral для отправки SMS, проверки состояния доставки и активации потоков при поступлении сообщений.
Этот соединитель доступен в следующих продуктах и регионах:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: - Azure для государственных организаций регионы - Azure регионы Китая - Министерство обороны США (DoD) |
| Power Apps | Premium | Все регионы Power Apps кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Premium | Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Name | Поддержка SMS для гравитации |
| URL | https://gravitysms.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Кларк Каунти Tech |
| Веб-сайт | https://gravitysms.com |
| Политика конфиденциальности | https://gravitysms.com/privacy |
| Categories | Communication |
Гравитация SMS
Гравитация SMS позволяет организациям отправлять и получать SMS-сообщения через свою учетную запись RingCentral. Подключите номер RingCentral к Power Automate для отправки исходящих сообщений, отслеживания состояния доставки, журнала сообщений списка и триггеров при поступлении входящих сообщений.
Необходимые условия
- Учетная запись Гравитации SMS с активной подпиской
- Учетная запись RingCentral, подключенная через панель мониторинга "Гравитация SMS"
- Ключ API на панели мониторинга "Гравитация SMS"
Setup
- Войдите на панель мониторинга "Гравитация SMS" на app.gravitysms.com
- Перейдите к Integrations и активируйте интеграцию Power Automate
- Копирование предоставленного ключа API
- При создании подключения в Power Automate вставьте ключ API в поле API Key
Учетная запись RingCentral должна быть подключена на панели мониторинга "Гравитация SMS" перед отправкой или получением SMS-сообщений. Перейдите в раздел "Параметры " → RingCentral и завершите подключение OAuth.
Поддерживаемые операции
Действия
| Operation | Description |
|---|---|
| Отправка SMS | Очередь исходящего SMS для доставки по номеру RingCentral. |
| Получение состояния доставки сообщений | Получение текущего состояния доставки отправленного сообщения по идентификатору сообщения. |
| Список журналов сообщений | Получение списка входящих и исходящих SMS-сообщений с разбивкой на страницы. |
| Проверка подключения RingCentral | Проверьте, подключена ли учетная запись RingCentral, и маркер активен. |
Триггеры
| Триггер | Description |
|---|---|
| При получении SMS | Срабатывает, когда входящий SMS поступает на ваш номер RingCentral. При необходимости фильтруйте по номеру телефона. |
Известные проблемы и ограничения
- SMS-сообщения ограничены 1600 символами.
- Номера телефонов должны быть в формате E.164 (например, +14155551234).
- Для триггера входящего SMS требуется подключенная учетная запись RingCentral на панели мониторинга "Гравитация SMS".
- Для отправки SMS требуется номер RingCentral, назначенный вашей учетной записи.
Поддержка
- Веб-сайт: gravitysms.com
- Документация: docs.gravitysms.com
- Политика конфиденциальности: gravitysms.com/privacy
- Условия обслуживания: gravitysms.com/terms
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Name | Type | Description | Обязательный |
|---|---|---|---|
| Ключ API | securestring | Ключ API для этого API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Отправка SMS-сообщения |
Очередь исходящего SMS-сообщения для доставки через RingCentral. |
| Получение состояния доставки сообщений |
Получение текущего состояния и сведений о конкретном SMS-сообщении. |
|
Проверка подключения Ring |
Проверьте, подключена ли учетная запись RingCentral и состояние токена. |
| Список журналов сообщений |
Получение списка sms-сообщений с разбивкой на страницы с дополнительными фильтрами. |
Отправка SMS-сообщения
Очередь исходящего SMS-сообщения для доставки через RingCentral.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Кому
|
to | True | string |
Номер телефона получателя в формате E.164 (например, +14155551234) |
|
От
|
from | True | string |
Номер телефона отправителя в формате E.164 (должен быть номером RingCentral в вашей учетной записи) |
|
Message
|
body | True | string |
Текст SMS-сообщения (1–1600 символов) |
|
Идентификатор пользователя
|
userId | string |
Необязательный идентификатор пользователя для отслеживания |
Возвращаемое значение
- Тело
- SendSmsResponse
Получение состояния доставки сообщений
Получение текущего состояния и сведений о конкретном SMS-сообщении.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сообщения
|
messageId | True | string |
Уникальный идентификатор сообщения |
Возвращаемое значение
- Тело
- MessageDetail
Проверка подключения RingCentral
Проверьте, подключена ли учетная запись RingCentral и состояние токена.
Возвращаемое значение
- Тело
- ConnectionStatus
Список журналов сообщений
Получение списка sms-сообщений с разбивкой на страницы с дополнительными фильтрами.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Направление
|
direction | string |
Фильтрация по направлению сообщения |
|
|
Статус
|
status | string |
Фильтрация по состоянию сообщения |
|
|
Из числа
|
from | string |
Фильтрация по номеру телефона отправителя (формат E.164) |
|
|
Число
|
to | string |
Фильтрация по номеру телефона получателя (формат E.164) |
|
|
Дата начала
|
startDate | date-time |
Фильтрация сообщений, созданных по дате или после этой даты (ISO 8601) |
|
|
Дата окончания
|
endDate | date-time |
Фильтрация сообщений, созданных до этой даты (ISO 8601) |
|
|
Страница
|
page | integer |
Номер страницы для разбиения на страницы |
|
|
Размер страницы
|
limit | integer |
Количество сообщений на страницу (максимум 100) |
Возвращаемое значение
- Тело
- ListMessagesResponse
Триггеры
| При получении SMS |
Активирует при получении входящего SMS-сообщения на номер RingCentral. |
При получении SMS
Активирует при получении входящего SMS-сообщения на номер RingCentral.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Номер телефона
|
phoneNumber | string |
Номер телефона для отслеживания входящих SMS (формат E.164, например +15551234567). Оставьте пустым для активации всех чисел. |
Возвращаемое значение
- Тело
- InboundSmsPayload
Определения
SendSmsResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор сообщения
|
messageId | string |
Уникальный идентификатор для сообщения в очереди |
|
Статус
|
status | string |
Текущее состояние сообщения |
MessageDetail
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор сообщения
|
messageId | string |
Уникальный идентификатор сообщения |
|
Статус
|
status | string |
Текущее состояние доставки |
|
Идентификатор сообщения RC
|
rcMessageId | string |
Идентификатор сообщения RingCentral |
|
Error
|
error | string |
Сообщение об ошибке при сбое доставки |
|
Кому
|
to | string |
Номер телефона получателя |
|
От
|
from | string |
Номер телефона отправителя |
|
Message
|
body | string |
Текст сообщения |
|
Создано в
|
createdAt | date-time |
Когда сообщение было создано |
|
Обновлено в
|
updatedAt | date-time |
После последнего обновления сообщения |
ListMessagesResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
messages
|
messages | array of MessageDetail |
Список сообщений |
|
Общее число
|
total | integer |
Общее количество сообщений, соответствующих фильтру |
|
Страница
|
page | integer |
Текущий номер страницы |
|
Размер страницы
|
limit | integer |
Количество сообщений на страницу |
Статус соединения
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Подключено
|
connected | boolean |
Подключение RingCentral |
|
Истекает в
|
expiresAt | date-time |
Срок действия текущего маркера |
|
Идентификатор учетной записи RC
|
rcAccountId | string |
Идентификатор учетной записи RingCentral |
InboundSmsPayload
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор сообщения
|
messageId | string |
Уникальный идентификатор сообщения для подстановок состояния |
|
Из числа
|
from | string |
Номер телефона отправителя в формате E.164 (например, +15551234567) |
|
Число
|
to | string |
Номер телефона получателя в формате E.164 |
|
Текст сообщения
|
text | string |
Содержимое текста SMS-сообщения |
|
Получено по адресу
|
receivedAt | date-time |
Метка времени получения сообщения (ISO 8601) |