Gravity SMS (Vorschau)
Senden und Empfangen von SMS-Nachrichten über RingCentral. Verbinden Sie Ihr RingCentral-Konto, um SMS zu senden, den Zustellungsstatus zu überprüfen und Flüsse auszulösen, wenn Nachrichten eingehen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure Government Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Gravity SMS Support |
| URL | https://gravitysms.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Clark County Tech |
| Website | https://gravitysms.com |
| Datenschutzrichtlinie | https://gravitysms.com/privacy |
| Kategorien | Communication |
Schwerkraft-SMS
Gravity SMS ermöglicht Es Organisationen, SMS-Nachrichten über ihr RingCentral-Konto zu senden und zu empfangen. Verbinden Sie Ihre RingCentral-Nummer mit Power Automate, um ausgehende Nachrichten zu senden, den Zustellungsstatus zu überwachen, den Nachrichtenverlauf auflisten und Abläufe beim Eintreffen eingehender Nachrichten auszulösen.
Voraussetzungen
- Ein Gravity SMS-Konto mit einem aktiven Abonnement
- Ein RingCentral-Konto, das über das Gravity SMS-Dashboard verbunden ist
- Ein API-Schlüssel aus dem Gravity SMS-Dashboard
Konfiguration
- Melden Sie sich bei Ihrem Gravity SMS-Dashboard bei app.gravitysms.com
- Wechseln Sie zu Integrations und aktivieren Sie die Integration Power Automate
- Kopieren des bereitgestellten API-Schlüssels
- Fügen Sie beim Erstellen einer Verbindung in Power Automate den API-Schlüssel in das Feld API-Schlüssel ein.
Ihr RingCentral-Konto muss im Gravity SMS-Dashboard verbunden sein, bevor SMS-Nachrichten gesendet oder empfangen werden. Wechseln Sie zu "Einstellungen " → "RingCentral ", und schließen Sie die OAuth-Verbindung ab.
Unterstützte Vorgänge
Aktionen
| Operation | Description |
|---|---|
| Senden einer SMS-Nachricht | Stellen Sie eine ausgehende SMS für die Zustellung über Ihre RingCentral-Nummer in die Warteschlange. |
| Status der Nachrichtenübermittlung abrufen | Rufen Sie den aktuellen Zustellungsstatus einer gesendeten Nachricht anhand der Nachrichten-ID ab. |
| Nachrichtenverlauf auflisten | Rufen Sie eine paginierte, filterbare Liste der eingehenden und ausgehenden SMS-Nachrichten ab. |
| Überprüfen der RingCentral-Verbindung | Überprüfen Sie, ob Ihr RingCentral-Konto verbunden ist und das Token aktiv ist. |
Trigger
| Auslöser | Description |
|---|---|
| Wenn eine SMS empfangen wird | Wird ausgelöst, wenn eine eingehende SMS auf Ihrer RingCentral-Nummer eintrifft. Optional nach Telefonnummer filtern. |
Bekannte Probleme und Einschränkungen
- SMS-Nachrichten sind auf 1.600 Zeichen beschränkt.
- Telefonnummern müssen im E.164-Format vorliegen (z. B. +14155551234).
- Der eingehende SMS-Trigger erfordert ein verbundenes RingCentral-Konto im Gravity SMS-Dashboard.
- Das Senden von SMS erfordert eine RingCentral-Nummer, die Ihrem Konto zugewiesen ist.
Support
- Website: gravitysms.com
- Dokumentation: docs.gravitysms.com
- Datenschutzrichtlinie: gravitysms.com/privacy
- Nutzungsbedingungen: gravitysms.com/terms
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Type | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Nachrichtenverlauf auflisten |
Rufen Sie eine paginierte Liste von SMS-Nachrichten mit optionalen Filtern ab. |
| Senden einer SMS |
Eine ausgehende SMS-Nachricht für die Zustellung über RingCentral in die Warteschlange stellen. |
| Status der Nachrichtenübermittlung abrufen |
Rufen Sie den aktuellen Status und details einer bestimmten SMS-Nachricht ab. |
|
Überprüfen der Ring |
Überprüfen Sie, ob Ihr RingCentral-Konto verbunden ist, und den Tokenstatus. |
Nachrichtenverlauf auflisten
Rufen Sie eine paginierte Liste von SMS-Nachrichten mit optionalen Filtern ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Richtung
|
direction | string |
Filtern nach Nachrichtenrichtung |
|
|
Status
|
status | string |
Nach Nachrichtenstatus filtern |
|
|
Von Zahl
|
from | string |
Nach Absendertelefonnummer filtern (E.164-Format) |
|
|
To Number
|
to | string |
Nach Empfängertelefonnummer filtern (E.164-Format) |
|
|
Startdatum
|
startDate | date-time |
Filtern von Nachrichten, die an oder nach diesem Datum erstellt wurden (ISO 8601) |
|
|
Enddatum
|
endDate | date-time |
Filtern von Nachrichten, die an oder vor diesem Datum erstellt wurden (ISO 8601) |
|
|
Seite
|
page | integer |
Seitenzahl für Paginierung |
|
|
Seitengröße
|
limit | integer |
Anzahl der Nachrichten pro Seite (max. 100) |
Gibt zurück
- Body
- ListMessagesResponse
Senden einer SMS
Eine ausgehende SMS-Nachricht für die Zustellung über RingCentral in die Warteschlange stellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
To
|
to | True | string |
Empfängertelefonnummer im E.164-Format (z. B. +14155551234) |
|
Von
|
from | True | string |
Absendertelefonnummer im E.164-Format (muss eine RingCentral-Nummer auf Ihrem Konto sein) |
|
Meldung
|
body | True | string |
SMS-Nachrichtentext (1-1600 Zeichen) |
|
Benutzer-ID
|
userId | string |
Optionaler Benutzerbezeichner für die Nachverfolgung |
Gibt zurück
- Body
- SendSmsResponse
Status der Nachrichtenübermittlung abrufen
Rufen Sie den aktuellen Status und details einer bestimmten SMS-Nachricht ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Meldungs-ID
|
messageId | True | string |
Der eindeutige Nachrichtenbezeichner |
Gibt zurück
- Body
- MessageDetail
Überprüfen der RingCentral-Verbindung
Überprüfen Sie, ob Ihr RingCentral-Konto verbunden ist, und den Tokenstatus.
Gibt zurück
- Body
- ConnectionStatus
Trigger
| Wenn eine SMS empfangen wird |
Wird ausgelöst, wenn eine eingehende SMS-Nachricht auf Ihrer RingCentral-Nummer empfangen wird. |
Wenn eine SMS empfangen wird
Wird ausgelöst, wenn eine eingehende SMS-Nachricht auf Ihrer RingCentral-Nummer empfangen wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Telefonnummer
|
phoneNumber | string |
Telefonnummer für eingehende SMS (E.164-Format, z. B. +15551234567). Lassen Sie leer, um für alle Zahlen auszulösen. |
Gibt zurück
- Body
- InboundSmsPayload
Definitionen
SendSmsResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Meldungs-ID
|
messageId | string |
Eindeutiger Bezeichner für die in die Warteschlange eingereihte Nachricht |
|
Status
|
status | string |
Aktueller Nachrichtenstatus |
MessageDetail
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Meldungs-ID
|
messageId | string |
Eindeutiger Nachrichtenbezeichner |
|
Status
|
status | string |
Aktueller Zustellungsstatus |
|
RC-Nachrichten-ID
|
rcMessageId | string |
RingCentral-Nachrichtenbezeichner |
|
Fehler
|
error | string |
Fehlermeldung, wenn die Übermittlung fehlgeschlagen ist |
|
To
|
to | string |
Telefonnummer des Empfängers |
|
Von
|
from | string |
Telefonnummer des Absenders |
|
Meldung
|
body | string |
Text der Nachricht |
|
Erstellt bei
|
createdAt | date-time |
Wann die Nachricht erstellt wurde |
|
Aktualisiert unter
|
updatedAt | date-time |
Zeitpunkt der letzten Aktualisierung der Nachricht |
ListMessagesResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
messages
|
messages | array of MessageDetail |
Liste der Nachrichten |
|
Gesamtanzahl
|
total | integer |
Gesamtanzahl der Nachrichten, die dem Filter entsprechen |
|
Seite
|
page | integer |
Aktuelle Seitenzahl |
|
Seitengröße
|
limit | integer |
Anzahl der Nachrichten pro Seite |
Verbindungsstatus
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Verbindung hergestellt
|
connected | boolean |
Gibt an, ob RingCentral verbunden ist |
|
Läuft ab am
|
expiresAt | date-time |
Wann das aktuelle Token abläuft |
|
RC-Konto-ID
|
rcAccountId | string |
RingCentral-Kontobezeichner |
InboundSmsPayload
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Meldungs-ID
|
messageId | string |
Eindeutiger Nachrichtenbezeichner für Statussuche |
|
Von Zahl
|
from | string |
Absendertelefonnummer im E.164-Format (z. B. +15551234567) |
|
To Number
|
to | string |
Empfängertelefonnummer im E.164-Format |
|
Meldungstext
|
text | string |
Textkörper der SMS-Nachricht |
|
Empfangen bei
|
receivedAt | date-time |
Zeitstempel beim Empfang der Nachricht (ISO 8601) |