Die SMS Works (Independent Publisher) (Vorschau)
Die SMS Works ist ein kostengünstiger SMS-Dienst für Entwickler, die in Großbritannien ansässig sind. Sie werden nur für zugestellte Textnachrichten in Rechnung gestellt.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | 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 | Norm | 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 | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| ttaylor@hitachisolutions.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Troy Taylor |
| Webseite | https://thesmsworks.co.uk/ |
| Datenschutzrichtlinie | https://thesmsworks.co.uk/privacy |
| Kategorien | Communication |
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 | Typ | Description | Erforderlich |
|---|---|---|---|
| JWT-Token | securestring | Das JWT-Token für diese API | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen fehlgeschlagener Nachrichten |
Abrufen fehlgeschlagener Nachrichten, die Ihren Suchkriterien entsprechen. |
| Abrufen geplanter Nachrichten |
Gibt eine Liste von Nachrichten zurück, die aus Ihrem Konto geplant sind, einschließlich aller Nachrichten, die in den letzten 3 Monaten geplant sind, und alle geplanten Nachrichten, die in der Zukunft gesendet werden sollen. |
| Abrufen von Batchnachrichten |
Rufen Sie alle Nachrichten in einem Batch mit der angegebenen Batch-ID ab. |
| Batch planen |
Plant eine Reihe von SMS-Nachrichten, die zu dem von Ihnen angegebenen Datum gesendet werden. |
| Batch senden |
Senden Sie eine einzelne SMS-Nachricht an mehrere Empfänger. |
| Durchsuchen von Nachrichten |
Rufen Sie bis zu 1000 Nachrichten ab, die Ihren Suchkriterien entsprechen. |
| Flashnachricht senden |
Sendet eine SMS-Flashnachricht, die auf dem Sperrbildschirm der Empfänger angezeigt wird. |
| Geplante Nachricht abbrechen |
Bricht eine geplante SMS-Nachricht ab. |
| Geplanter Batch abbrechen |
Bricht eine geplante SMS-Nachricht ab. |
| Guthaben abrufen |
Gibt die Anzahl der derzeit für das Konto verfügbaren Guthaben zurück. |
| Kunden-ID abrufen |
Gibt die Kunden-ID an den Anrufer zurück. |
| Nachricht abrufen |
Rufen Sie eine protokollierte Nachricht von der Nachrichten-ID ab. |
| Nachricht löschen |
Löschen Sie die Nachricht mit der entsprechenden MessageID. |
| Nachricht planen |
Plant, dass eine SMS-Nachricht zu dem von Ihnen angegebenen Datum gesendet wird. |
| Senden einer Sammlung von Nachrichten |
Sendet eine Sammlung eindeutiger SMS-Nachrichten. Batches können jeweils bis zu 5000 Nachrichten enthalten. |
| Senden einer SMS |
Sendet eine SMS-Nachricht basierend auf Ihren Parametern. |
| Ungelesene Nachrichten abrufen |
Erhalten Sie ungelesene eingehende Nachrichten, die Ihren Suchkriterien entsprechen. |
Abrufen fehlgeschlagener Nachrichten
Abrufen fehlgeschlagener Nachrichten, die Ihren Suchkriterien entsprechen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Anfrage
|
query | True |
Gibt zurück
- response
- array of MessageResponse
Abrufen geplanter Nachrichten
Gibt eine Liste von Nachrichten zurück, die aus Ihrem Konto geplant sind, einschließlich aller Nachrichten, die in den letzten 3 Monaten geplant sind, und alle geplanten Nachrichten, die in der Zukunft gesendet werden sollen.
Gibt zurück
Details zu einer Nachricht, die an einem bestimmten Datum und zu einer bestimmten Uhrzeit gesendet werden soll
- response
- ScheduledMessagesResponse
Abrufen von Batchnachrichten
Rufen Sie alle Nachrichten in einem Batch mit der angegebenen Batch-ID ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Batch-ID
|
batchid | True | string |
Die ID des Batches, den Sie zurückgeben möchten |
Gibt zurück
- response
- array of MessageResponse
Batch planen
Plant eine Reihe von SMS-Nachrichten, die zu dem von Ihnen angegebenen Datum gesendet werden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
smsMessage
|
smsMessage | True |
Nachrichteneigenschaften |
Gibt zurück
- response
- ScheduledBatchResponse
Batch senden
Senden Sie eine einzelne SMS-Nachricht an mehrere Empfänger.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
smsMessage
|
smsMessage | True |
Nachrichteneigenschaften |
Gibt zurück
- response
- BatchMessageResponse
Durchsuchen von Nachrichten
Rufen Sie bis zu 1000 Nachrichten ab, die Ihren Suchkriterien entsprechen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Anfrage
|
query | True |
Gibt zurück
- response
- array of MessageResponse
Flashnachricht senden
Sendet eine SMS-Flashnachricht, die auf dem Sperrbildschirm der Empfänger angezeigt wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Absender
|
sender | True | string |
Der Absender der Nachricht. Darf nicht mehr als 11 Zeichen für alphanumerische oder 15 Zeichen für numerische Absender-IDs sein. Keine Leerzeichen oder Sonderzeichen. |
|
Bestimmungsort
|
destination | True | string |
Telefonnummer des Empfängers |
|
Content
|
content | True | string |
Nachricht, die an den Empfänger gesendet werden soll. Der Inhalt kann bis zu 1280 Zeichen lang sein. Nachrichten von 160 Zeichen oder weniger werden 1 Gutschrift belastet. Wenn Ihre Nachricht länger als 160 Zeichen ist, wird sie in Blöcke von 153 Zeichen aufgeteilt, bevor Sie an das Handset des Empfängers gesendet werden, und Sie werden 1 Gutschrift für jede 153 Zeichen belastet. Nachrichten, die an Nummern gesendet werden, die außerhalb des Vereinigten Königreichs registriert sind, werden in der Regel doppelte Gutschriften in Rechnung gestellt, aber für bestimmte Länder können Guthabenbrüche in Rechnung gestellt werden (z. B. 2,5). Bitte kontaktieren Sie uns für Tarife für jedes Land. |
|
URL des Übermittlungsberichts
|
deliveryreporturl | string |
Die URL, an die wir POST-Übermittlungsberichte für diese Nachricht senden sollten. Wenn keine angegeben ist, verwenden wir die URL des globalen Übermittlungsberichts, die Sie auf Ihrer Kontoseite konfiguriert haben. |
|
|
Zeitplan
|
schedule | string |
Datum, an dem die Nachricht gesendet werden soll. Dies wird nur vom Nachrichten-/Zeitplandienst verwendet und kann für andere Dienste leer gelassen werden. |
|
|
Tag
|
tag | string |
Eine Identifizierungsbezeichnung für die Nachricht, die Sie zum Filtern und Melden von Nachrichten verwenden können, die Sie später gesendet haben. Ideal für Kampagnen. Maximal 280 Zeichen. |
|
|
TTL
|
ttl | number |
Die optionale Anzahl von Minuten, bevor der Übermittlungsbericht gelöscht wird. Wahlfrei. Lassen Sie diese Auslassung aus, um das Löschen von Übermittlungsberichten zu verhindern. |
|
|
Antwort-E-Mail
|
responseemail | array of string |
Eine optionale Liste von E-Mail-Adressen, an die Antworten an diese bestimmte Nachricht weitergeleitet werden sollen. Für diese Funktion ist eine SMS Works Reply Number erforderlich. |
|
|
Metadaten
|
Metadata | object | ||
|
Gültigkeit
|
validity | number |
Die optionale Anzahl von Minuten, um die Zustellung zu versuchen, bevor die Nachricht als ABGELAUFEN markiert ist. Wahlfrei. Der Standardwert ist 2880 Minuten. |
Gibt zurück
- response
- SendMessageResponse
Geplante Nachricht abbrechen
Bricht eine geplante SMS-Nachricht ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nachrichten-ID
|
messageid | True | string |
Die ID der Nachricht, die Sie zurückgeben möchten |
Gibt zurück
- response
- CancelledMessageResponse
Geplanter Batch abbrechen
Bricht eine geplante SMS-Nachricht ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Batch-ID
|
batchid | True | string |
Die ID des Batches, den Sie zurückgeben möchten |
Gibt zurück
- response
- CancelledMessageResponse
Guthaben abrufen
Gibt die Anzahl der derzeit für das Konto verfügbaren Guthaben zurück.
Gibt zurück
- response
- CreditsResponse
Kunden-ID abrufen
Nachricht abrufen
Rufen Sie eine protokollierte Nachricht von der Nachrichten-ID ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nachrichten-ID
|
messageid | True | string |
Die ID der Nachricht, die Sie zurückgeben möchten |
Gibt zurück
- response
- MessageResponse
Nachricht löschen
Löschen Sie die Nachricht mit der entsprechenden MessageID.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nachrichten-ID
|
messageid | True | string |
Die ID der Nachricht, die Sie zurückgeben möchten |
Gibt zurück
- response
- DeletedMessageResponse
Nachricht planen
Plant, dass eine SMS-Nachricht zu dem von Ihnen angegebenen Datum gesendet wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Absender
|
sender | True | string |
Der Absender der Nachricht. Darf nicht mehr als 11 Zeichen für alphanumerische oder 15 Zeichen für numerische Absender-IDs sein. Keine Leerzeichen oder Sonderzeichen. |
|
Bestimmungsort
|
destination | True | string |
Telefonnummer des Empfängers |
|
Content
|
content | True | string |
Nachricht, die an den Empfänger gesendet werden soll. Der Inhalt kann bis zu 1280 Zeichen lang sein. Nachrichten von 160 Zeichen oder weniger werden 1 Gutschrift belastet. Wenn Ihre Nachricht länger als 160 Zeichen ist, wird sie in Blöcke von 153 Zeichen aufgeteilt, bevor Sie an das Handset des Empfängers gesendet werden, und Sie werden 1 Gutschrift für jede 153 Zeichen belastet. Nachrichten, die an Nummern gesendet werden, die außerhalb des Vereinigten Königreichs registriert sind, werden in der Regel doppelte Gutschriften in Rechnung gestellt, aber für bestimmte Länder können Guthabenbrüche in Rechnung gestellt werden (z. B. 2,5). Bitte kontaktieren Sie uns für Tarife für jedes Land. |
|
URL des Übermittlungsberichts
|
deliveryreporturl | string |
Die URL, an die wir POST-Übermittlungsberichte für diese Nachricht senden sollten. Wenn keine angegeben ist, verwenden wir die URL des globalen Übermittlungsberichts, die Sie auf Ihrer Kontoseite konfiguriert haben. |
|
|
Zeitplan
|
schedule | string |
Datum, an dem die Nachricht gesendet werden soll. Dies wird nur vom Nachrichten-/Zeitplandienst verwendet und kann für andere Dienste leer gelassen werden. |
|
|
Tag
|
tag | string |
Eine Identifizierungsbezeichnung für die Nachricht, die Sie zum Filtern und Melden von Nachrichten verwenden können, die Sie später gesendet haben. Ideal für Kampagnen. Maximal 280 Zeichen. |
|
|
TTL
|
ttl | number |
Die optionale Anzahl von Minuten, bevor der Übermittlungsbericht gelöscht wird. Wahlfrei. Lassen Sie diese Auslassung aus, um das Löschen von Übermittlungsberichten zu verhindern. |
|
|
Antwort-E-Mail
|
responseemail | array of string |
Eine optionale Liste von E-Mail-Adressen, an die Antworten an diese bestimmte Nachricht weitergeleitet werden sollen. Für diese Funktion ist eine SMS Works Reply Number erforderlich. |
|
|
Metadaten
|
Metadata | object | ||
|
Gültigkeit
|
validity | number |
Die optionale Anzahl von Minuten, um die Zustellung zu versuchen, bevor die Nachricht als ABGELAUFEN markiert ist. Wahlfrei. Der Standardwert ist 2880 Minuten. |
Gibt zurück
- response
- array of ScheduledMessageResponse
Senden einer Sammlung von Nachrichten
Sendet eine Sammlung eindeutiger SMS-Nachrichten. Batches können jeweils bis zu 5000 Nachrichten enthalten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
messages
|
messages | True |
Ein Array von Nachrichten |
Gibt zurück
- response
- BatchMessageResponse
Senden einer SMS
Sendet eine SMS-Nachricht basierend auf Ihren Parametern.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Absender
|
sender | True | string |
Der Absender der Nachricht. Darf nicht mehr als 11 Zeichen für alphanumerische oder 15 Zeichen für numerische Absender-IDs sein. Keine Leerzeichen oder Sonderzeichen. |
|
Bestimmungsort
|
destination | True | string |
Telefonnummer des Empfängers |
|
Content
|
content | True | string |
Nachricht, die an den Empfänger gesendet werden soll. Der Inhalt kann bis zu 1280 Zeichen lang sein. Nachrichten von 160 Zeichen oder weniger werden 1 Gutschrift belastet. Wenn Ihre Nachricht länger als 160 Zeichen ist, wird sie in Blöcke von 153 Zeichen aufgeteilt, bevor Sie an das Handset des Empfängers gesendet werden, und Sie werden 1 Gutschrift für jede 153 Zeichen belastet. Nachrichten, die an Nummern gesendet werden, die außerhalb des Vereinigten Königreichs registriert sind, werden in der Regel doppelte Gutschriften in Rechnung gestellt, aber für bestimmte Länder können Guthabenbrüche in Rechnung gestellt werden (z. B. 2,5). Bitte kontaktieren Sie uns für Tarife für jedes Land. |
|
URL des Übermittlungsberichts
|
deliveryreporturl | string |
Die URL, an die wir POST-Übermittlungsberichte für diese Nachricht senden sollten. Wenn keine angegeben ist, verwenden wir die URL des globalen Übermittlungsberichts, die Sie auf Ihrer Kontoseite konfiguriert haben. |
|
|
Zeitplan
|
schedule | string |
Datum, an dem die Nachricht gesendet werden soll. Dies wird nur vom Nachrichten-/Zeitplandienst verwendet und kann für andere Dienste leer gelassen werden. |
|
|
Tag
|
tag | string |
Eine Identifizierungsbezeichnung für die Nachricht, die Sie zum Filtern und Melden von Nachrichten verwenden können, die Sie später gesendet haben. Ideal für Kampagnen. Maximal 280 Zeichen. |
|
|
TTL
|
ttl | number |
Die optionale Anzahl von Minuten, bevor der Übermittlungsbericht gelöscht wird. Wahlfrei. Lassen Sie diese Auslassung aus, um das Löschen von Übermittlungsberichten zu verhindern. |
|
|
Antwort-E-Mail
|
responseemail | array of string |
Eine optionale Liste von E-Mail-Adressen, an die Antworten an diese bestimmte Nachricht weitergeleitet werden sollen. Für diese Funktion ist eine SMS Works Reply Number erforderlich. |
|
|
Metadaten
|
Metadata | object | ||
|
Gültigkeit
|
validity | number |
Die optionale Anzahl von Minuten, um die Zustellung zu versuchen, bevor die Nachricht als ABGELAUFEN markiert ist. Wahlfrei. Der Standardwert ist 2880 Minuten. |
Gibt zurück
- response
- SendMessageResponse
Ungelesene Nachrichten abrufen
Erhalten Sie ungelesene eingehende Nachrichten, die Ihren Suchkriterien entsprechen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Anfrage
|
query | True |
Gibt zurück
- response
- array of MessageResponse
Definitionen
TestResponse
CreditsResponse
ScheduledMessagesResponse
Details zu einer Nachricht, die an einem bestimmten Datum und zu einer bestimmten Uhrzeit gesendet werden soll
Details zu einer Nachricht, die an einem bestimmten Datum und zu einer bestimmten Uhrzeit gesendet werden soll