SMS gravità (anteprima)
Inviare e ricevere messaggi SMS tramite RingCentral. Connettere l'account RingCentral per inviare SMS, controllare lo stato del recapito e attivare i flussi all'arrivo dei messaggi.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - aree Azure per enti pubblici - Azure cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Premium | Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Name | Supporto sms gravità |
| URL | https://gravitysms.com |
| Metadati del connettore | |
|---|---|
| Editore | Contea di Clark |
| Sito web | https://gravitysms.com |
| Informativa sulla privacy | https://gravitysms.com/privacy |
| Categorie | Communication |
SMS gravità
Gravità SMS consente alle organizzazioni di inviare e ricevere messaggi SMS tramite il proprio account RingCentral. Connettere il numero RingCentral a Power Automate per inviare messaggi in uscita, monitorare lo stato del recapito, elencare la cronologia dei messaggi e attivare i flussi all'arrivo dei messaggi in ingresso.
Prerequisiti
- Un account SMS di gravità con una sottoscrizione attiva
- Un account RingCentral connesso tramite il dashboard Di gravità SMS
- Una chiave API dal dashboard di Gravity SMS
Setup
- Accedere al dashboard di Gravity SMS all'indirizzo app.gravitysms.com
- Passare a Integrations e attivare l'integrazione di Power Automate
- Copiare la chiave API fornita
- Quando si crea una connessione in Power Automate, incollare la chiave API nel campo Chiave API
L'account RingCentral deve essere connesso nel dashboard di Gravity SMS prima di inviare o ricevere messaggi SMS. Passare a Impostazioni → RingCentral e completare la connessione OAuth.
Operazioni supportate
Azioni
| Operation | Descrizione |
|---|---|
| Inviare SMS | Accoda un SMS in uscita per il recapito tramite il numero RingCentral. |
| Ottenere lo stato di recapito dei messaggi | Recuperare lo stato di recapito corrente di un messaggio inviato in base all'ID messaggio. |
| Elencare la cronologia dei messaggi | Recuperare un elenco impaginato e filtrabile di messaggi SMS in ingresso e in uscita. |
| Controllare la connessione RingCentral | Verificare se l'account RingCentral è connesso e il token è attivo. |
Attivatori
| Attivatore | Descrizione |
|---|---|
| Quando viene ricevuto un SMS | Viene generato quando arriva un SMS in ingresso sul numero RingCentral. Facoltativamente, filtrare in base al numero di telefono. |
Problemi noti e limitazioni
- I messaggi SMS sono limitati a 1.600 caratteri.
- I numeri di telefono devono essere in formato E.164 ,ad esempio +14155551234.
- Il trigger SMS in ingresso richiede un account RingCentral connesso nel dashboard di Gravity SMS.
- L'invio di SMS richiede un numero RingCentral assegnato all'account.
Support
- Sito Web: gravitysms.com
- Documentazione: docs.gravitysms.com
- Informativa sulla privacy: gravitysms.com/privacy
- Condizioni per il servizio: gravitysms.com/terms
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Name | Type | Descrizione | Obbligatorio |
|---|---|---|---|
| Chiave API | securestring | Chiave API per questa API | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
|
Controllare la connessione Ring |
Controllare se l'account RingCentral è connesso e lo stato del token. |
| Elencare la cronologia dei messaggi |
Recuperare un elenco impaginato di messaggi SMS con filtri facoltativi. |
| Inviare un messaggio SMS |
Accoda un messaggio SMS in uscita per il recapito tramite RingCentral. |
| Ottenere lo stato di recapito dei messaggi |
Recuperare lo stato corrente e i dettagli di un messaggio SMS specifico. |
Controllare la connessione RingCentral
Controllare se l'account RingCentral è connesso e lo stato del token.
Valori restituiti
- Corpo
- ConnectionStatus
Elencare la cronologia dei messaggi
Recuperare un elenco impaginato di messaggi SMS con filtri facoltativi.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Direction
|
direction | string |
Filtrare in base alla direzione del messaggio |
|
|
Condizione
|
status | string |
Filtrare in base allo stato del messaggio |
|
|
Da numero
|
from | string |
Filtrare in base al numero di telefono del mittente (formato E.164) |
|
|
A numero
|
to | string |
Filtrare in base al numero di telefono del destinatario (formato E.164) |
|
|
Data di inizio
|
startDate | date-time |
Filtrare i messaggi creati in base o dopo questa data (ISO 8601) |
|
|
Data di fine
|
endDate | date-time |
Filtrare i messaggi creati in base o prima di questa data (ISO 8601) |
|
|
Pagina
|
page | integer |
Numero di pagina per la paginazione |
|
|
Dimensioni pagina
|
limit | integer |
Numero di messaggi per pagina (massimo 100) |
Valori restituiti
- Corpo
- ListMessagesResponse
Inviare un messaggio SMS
Accoda un messaggio SMS in uscita per il recapito tramite RingCentral.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Per
|
to | True | string |
Numero di telefono destinatario in formato E.164 (ad esempio +14155551234) |
|
Da
|
from | True | string |
Numero di telefono del mittente in formato E.164 (deve essere un numero RingCentral nel tuo account) |
|
Message
|
body | True | string |
Testo del messaggio SMS (1-1600 caratteri) |
|
ID utente
|
userId | string |
Identificatore utente facoltativo per il rilevamento |
Valori restituiti
- Corpo
- SendSmsResponse
Ottenere lo stato di recapito dei messaggi
Recuperare lo stato corrente e i dettagli di un messaggio SMS specifico.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID messaggio
|
messageId | True | string |
Identificatore univoco del messaggio |
Valori restituiti
- Corpo
- MessageDetail
Trigger
| Quando viene ricevuto un SMS |
Si attiva quando viene ricevuto un messaggio SMS in ingresso sul numero RingCentral. |
Quando viene ricevuto un SMS
Si attiva quando viene ricevuto un messaggio SMS in ingresso sul numero RingCentral.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero di telefono
|
phoneNumber | string |
Numero di telefono da monitorare per gli SMS in ingresso (formato E.164, ad esempio +15551234567). Lasciare vuoto per attivare tutti i numeri. |
Valori restituiti
- Corpo
- InboundSmsPayload
Definizioni
SendSmsResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID messaggio
|
messageId | string |
Identificatore univoco per il messaggio in coda |
|
Condizione
|
status | string |
Stato del messaggio corrente |
MessageDetail
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID messaggio
|
messageId | string |
Identificatore univoco del messaggio |
|
Condizione
|
status | string |
Stato di recapito corrente |
|
RC Message ID
|
rcMessageId | string |
Identificatore del messaggio RingCentral |
|
Error
|
error | string |
Messaggio di errore se il recapito non è riuscito |
|
Per
|
to | string |
Numero di telefono del destinatario |
|
Da
|
from | string |
Numero di telefono del mittente |
|
Message
|
body | string |
Testo del messaggio |
|
Creato in
|
createdAt | date-time |
Al momento della creazione del messaggio |
|
Aggiornato all'indirizzo
|
updatedAt | date-time |
Data dell'ultimo aggiornamento del messaggio |
ListMessagesResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
messages
|
messages | array of MessageDetail |
Elenco di messaggi |
|
Conteggio totale
|
total | integer |
Numero totale di messaggi corrispondenti al filtro |
|
Pagina
|
page | integer |
Numero di pagina corrente |
|
Dimensioni pagina
|
limit | integer |
Numero di messaggi per pagina |
Stato della connessione
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Connesso
|
connected | boolean |
Indica se RingCentral è connesso |
|
Scade all'ora
|
expiresAt | date-time |
Alla scadenza del token corrente |
|
RC Account ID
|
rcAccountId | string |
Identificatore dell'account RingCentral |
InboundSmsPayload
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID messaggio
|
messageId | string |
Identificatore univoco del messaggio per le ricerche di stato |
|
Da numero
|
from | string |
Numero di telefono mittente in formato E.164 (ad esempio +15551234567) |
|
A numero
|
to | string |
Numero di telefono destinatario in formato E.164 |
|
Testo del messaggio
|
text | string |
Contenuto del corpo del messaggio SMS |
|
Ricevuto all'indirizzo
|
receivedAt | date-time |
Timestamp quando il messaggio è stato ricevuto (ISO 8601) |