Gravity SMS (préversion)
Envoyez et recevez des sms via RingCentral. Connectez votre compte RingCentral pour envoyer des SMS, vérifier l’état de remise et déclencher des flux lorsque les messages arrivent.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | standard | Toutes les régions Logic Apps , à l’exception des suivantes : - régions Azure Government - régions de chine Azure - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Prise en charge des SMS de gravité |
| URL | https://gravitysms.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Clark County Tech |
| Website | https://gravitysms.com |
| Politique de confidentialité | https://gravitysms.com/privacy |
| Categories | Communication |
SMS de gravité
Le SMS de gravité permet aux organisations d’envoyer et de recevoir des sms via leur compte RingCentral. Connectez votre numéro RingCentral à Power Automate pour envoyer des messages sortants, surveiller l’état de remise, répertorier l’historique des messages et déclencher des flux lorsque les messages entrants arrivent.
Prerequisites
- Un compte Gravity SMS avec un abonnement actif
- Un compte RingCentral connecté via le tableau de bord Gravity SMS
- Clé API à partir du tableau de bord Gravity SMS
Configuration
- Connectez-vous à votre tableau de bord Gravity SMS à app.gravitysms.com
- Accédez à Integrations et activez l’intégration Power Automate
- Copier la clé API fournie
- Lors de la création d’une connexion dans Power Automate, collez la clé API dans le champ API Key
Votre compte RingCentral doit être connecté dans le tableau de bord Gravity SMS avant d’envoyer ou de recevoir des sms. Accédez à Paramètres → RingCentral et terminez la connexion OAuth.
Opérations prises en charge
Actions
| Operation | Description |
|---|---|
| envoyer un sms | Mettre en file d’attente un SMS sortant pour la remise via votre numéro RingCentral. |
| Obtenir l’état de remise des messages | Récupérez l’état de remise actuel d’un message envoyé par ID de message. |
| Répertorier l’historique des messages | Récupérer une liste paginé et filtrable de messages SMS entrants et sortants. |
| Vérifier la connexion RingCentral | Vérifiez si votre compte RingCentral est connecté et que le jeton est actif. |
Déclencheurs
| Déclencheur | Description |
|---|---|
| Lorsqu’un SMS est reçu | Se déclenche lorsqu’un SMS entrant arrive sur votre numéro RingCentral. Filtrez éventuellement par numéro de téléphone. |
Problèmes connus et limitations
- Les sms sont limités à 1 600 caractères.
- Les numéros de téléphone doivent être au format E.164 (par exemple, +14155551234).
- Le déclencheur SMS entrant nécessite un compte RingCentral connecté dans le tableau de bord Gravity SMS.
- L’envoi de SMS nécessite un numéro RingCentral affecté à votre compte.
Support
- Site web : gravitysms.com
- Documentation : docs.gravitysms.com
- Politique de confidentialité : gravitysms.com/privacy
- Conditions d’utilisation : gravitysms.com/terms
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.
| Name | Type | Description | Obligatoire |
|---|---|---|---|
| Clé d’API | securestring | Clé API pour cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Envoyer un message SMS |
Mettre en file d’attente un sms sortant pour la remise via RingCentral. |
| Obtenir l’état de remise des messages |
Récupérez l’état actuel et les détails d’un sms spécifique. |
| Répertorier l’historique des messages |
Récupérez une liste paginé de sms avec des filtres facultatifs. |
|
Vérifier la connexion Ring |
Vérifiez si votre compte RingCentral est connecté et l’état du jeton. |
Envoyer un message SMS
Mettre en file d’attente un sms sortant pour la remise via RingCentral.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
À
|
to | True | string |
Numéro de téléphone du destinataire au format E.164 (par exemple, +14155551234) |
|
De
|
from | True | string |
Numéro de téléphone de l’expéditeur au format E.164 (doit être un numéro RingCentral sur votre compte) |
|
Message
|
body | True | string |
Sms texte (1 à 1600 caractères) |
|
ID d’utilisateur
|
userId | string |
Identificateur d’utilisateur facultatif pour le suivi |
Retours
- Corps
- SendSmsResponse
Obtenir l’état de remise des messages
Récupérez l’état actuel et les détails d’un sms spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de message
|
messageId | True | string |
Identificateur de message unique |
Retours
- Corps
- MessageDetail
Répertorier l’historique des messages
Récupérez une liste paginé de sms avec des filtres facultatifs.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Direction
|
direction | string |
Filtrer par direction du message |
|
|
État
|
status | string |
Filtrer par état du message |
|
|
À partir du numéro
|
from | string |
Filtrer par numéro de téléphone de l’expéditeur (format E.164) |
|
|
À numéro
|
to | string |
Filtrer par numéro de téléphone du destinataire (format E.164) |
|
|
Date de début
|
startDate | date-time |
Filtrer les messages créés à la date ou après cette date (ISO 8601) |
|
|
Date de fin
|
endDate | date-time |
Filtrer les messages créés à cette date ou avant cette date (ISO 8601) |
|
|
Page
|
page | integer |
Numéro de page pour la pagination |
|
|
Taille de la page
|
limit | integer |
Nombre de messages par page (maximum 100) |
Retours
- Corps
- ListMessagesResponse
Vérifier la connexion RingCentral
Vérifiez si votre compte RingCentral est connecté et l’état du jeton.
Retours
- Corps
- ConnectionStatus
Déclencheurs
| Lorsqu’un SMS est reçu |
Se déclenche lorsqu’un sms entrant est reçu sur votre numéro RingCentral. |
Lorsqu’un SMS est reçu
Se déclenche lorsqu’un sms entrant est reçu sur votre numéro RingCentral.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Numéro de téléphone
|
phoneNumber | string |
Numéro de téléphone à surveiller pour les SMS entrants (format E.164, par exemple + 15551234567). Laissez vide pour se déclencher sur tous les nombres. |
Retours
- Corps
- InboundSmsPayload
Définitions
SendSmsResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de message
|
messageId | string |
Identificateur unique du message mis en file d’attente |
|
État
|
status | string |
État actuel du message |
MessageDetail
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de message
|
messageId | string |
Identificateur de message unique |
|
État
|
status | string |
État de remise actuel |
|
RC Message ID
|
rcMessageId | string |
Identificateur de message RingCentral |
|
Error
|
error | string |
Message d’erreur en cas d’échec de remise |
|
À
|
to | string |
Numéro de téléphone du destinataire |
|
De
|
from | string |
Numéro de téléphone de l’expéditeur |
|
Message
|
body | string |
Texte du message |
|
Créé à
|
createdAt | date-time |
Lorsque le message a été créé |
|
Mis à jour à l’adresse
|
updatedAt | date-time |
Lorsque le message a été mis à jour pour la dernière fois |
ListMessagesResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
messages
|
messages | array of MessageDetail |
Liste des messages |
|
Nombre total
|
total | integer |
Nombre total de messages correspondant au filtre |
|
Page
|
page | integer |
Numéro de page actuel |
|
Taille de la page
|
limit | integer |
Nombre de messages par page |
Statut de la connexion
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Connecté
|
connected | boolean |
Indique si RingCentral est connecté |
|
Expire à
|
expiresAt | date-time |
Lorsque le jeton actuel expire |
|
ID de compte RC
|
rcAccountId | string |
Identificateur de compte RingCentral |
InboundSmsPayload
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de message
|
messageId | string |
Identificateur de message unique pour les recherches d’état |
|
À partir du numéro
|
from | string |
Numéro de téléphone de l’expéditeur au format E.164 (par exemple, +15551234567) |
|
À numéro
|
to | string |
Numéro de téléphone du destinataire au format E.164 |
|
Texte du message
|
text | string |
Contenu du corps du message SMS |
|
Reçu à
|
receivedAt | date-time |
Horodatage lorsque le message a été reçu (ISO 8601) |