Twilio
Twilio ermöglicht Apps das Senden und Empfangen von globalen SMS-, MMS- und IP-Nachrichten.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - 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 China-Regionen - US Department of Defense (DoD) |
| Power Apps | Norm | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps-Unterstützung Microsoft Power Automate-Support Microsoft Power Apps-Unterstützung |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://www.twilio.com/ |
| Datenschutzrichtlinie | https://www.twilio.com/legal/privacy |
Anforderungen
Der Twilio Connector benötigt die folgenden Informationen:
Ihre Twilio-Konto-ID und Ihr Authentifizierungstoken, das Sie auf Ihrem Twilio-Dashboard finden können, um die Erstellung einer Verbindung aus Ihrer App zu autorisieren. Wenn Sie ein Twilio-Testkonto verwenden, können Sie sms nur an überprüfte Telefonnummern senden.
Eine bestätigte Twilio-Telefonnummer, die Sms und eine andere Telefonnummer senden kann, die Sms empfangen kann.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Freigabefähig |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Twilio Konto-ID | securestring | Twilio Konto-ID | Richtig |
| Twilio-Zugriffstoken | securestring | Twilio-Zugriffstoken | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 1200 | 60 Sekunden |
Aktionen
| Nachricht abrufen |
Dieser Vorgang gibt eine einzelne Nachricht zurück, die durch die angegebene Nachrichten-ID angegeben wird. |
| Nachrichten auflisten [VERALTET] |
Gibt eine Liste der Nachrichten zurück, die Ihrem Konto zugeordnet sind. |
| Nachrichten auflisten V2 |
Gibt eine Liste der Nachrichten zurück, die Ihrem Konto zugeordnet sind. Diese Aktion unterstützt die Paginierung. |
| Sms senden |
Dieser Vorgang wird verwendet, um eine neue Nachricht an eine Mobiltelefonnummer zu senden. |
Nachricht abrufen
Dieser Vorgang gibt eine einzelne Nachricht zurück, die durch die angegebene Nachrichten-ID angegeben wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nachrichten-SID
|
MessageId | True | string |
Eindeutige SID der Nachricht. |
Gibt zurück
Eigenschaften einer einzelnen Nachricht.
- Nachricht
- Message
Nachrichten auflisten [VERALTET]
Gibt eine Liste der Nachrichten zurück, die Ihrem Konto zugeordnet sind.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
To Phone Number
|
To | string |
Nur Nachrichten an diese Telefonnummer anzeigen. |
|
|
Von Telefonnummer
|
From | string |
Nur Nachrichten von dieser Telefonnummer anzeigen. |
|
|
Gesendetes Datum
|
DateSent | date |
Zeigen Sie nur Nachrichten an, die an diesem Datum (im GMT-Format) gesendet wurden, angegeben als JJJJ-MM-TT. Beispiel: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
Anzahl der Ressourcen, die auf jeder Listenseite zurückgegeben werden sollen. Der Standardwert ist 50. |
|
|
Seite
|
Page | integer |
Seitennummer. Standard ist "0". |
Gibt zurück
Liste einer oder mehrerer Nachrichten.
- Nachrichtenliste
- MessageList
Nachrichten auflisten V2
Gibt eine Liste der Nachrichten zurück, die Ihrem Konto zugeordnet sind. Diese Aktion unterstützt die Paginierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
To Phone Number
|
To | string |
Nur Nachrichten an diese Telefonnummer anzeigen. |
|
|
Von Telefonnummer
|
From | string |
Nur Nachrichten von dieser Telefonnummer anzeigen. |
|
|
Gesendetes Datum
|
DateSent | date |
Zeigen Sie nur Nachrichten an, die an diesem Datum (im GMT-Format) gesendet wurden, angegeben als JJJJ-MM-TT. Beispiel: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
Anzahl der Ressourcen, die auf jeder Listenseite zurückgegeben werden sollen. Der Standardwert ist 50. |
Gibt zurück
Liste einer oder mehrerer Nachrichten.
- Nachrichtenliste V2
- MessageListV2
Sms senden
Dieser Vorgang wird verwendet, um eine neue Nachricht an eine Mobiltelefonnummer zu senden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Von Telefonnummer
|
from | True | string |
Eine Twilio-Telefonnummer (im E.164-Format) oder alphanumerische Absender-ID, die für den Nachrichtentyp aktiviert ist, den Sie senden möchten. |
|
To Phone Number
|
to | True | string |
Die Zieltelefonnummer. Formatieren sie mit einem "+"- und Ländercode, z. B. +16175551212 (E.164-Format). |
|
Text
|
body | True | string |
Der Text der Nachricht, die Sie senden möchten, beschränkt auf 1600 Zeichen. |
|
Medien-URLs
|
media_url | array of uri |
Liste der ZU sendenden MEDIEN |
|
|
Statusrückruf
|
StatusCallback | uri |
Eine URL, die Twilio bei jeder Änderung des Nachrichtenstatus POST sendet. |
|
|
Nachrichtendienst-Sid
|
messaging_service_sid | string |
Eindeutige ID des Messagingdiensts. |
|
|
Anwendungs-SID
|
application_sid | string |
SID der Twilio-Anwendung, die mit dem erforderlichen Nachrichtenstatusrückruf konfiguriert ist. |
|
|
Max Preis
|
max_price | string |
Das maximale Höchstpreislimit für die Nachricht. |
|
|
Gültigkeitsdauer
|
validity_period | string |
Die Anzahl der Sekunden, die die Nachricht in einer Twilio-Warteschlange verbleiben kann. |
Gibt zurück
Eigenschaften einer einzelnen Nachricht.
- Nachricht
- Message
Definitionen
Nachricht
Eigenschaften einer einzelnen Nachricht.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Text
|
body | string |
Textkörper der Nachricht. |
|
Von Zahl
|
from | phone |
Telefonnummer, von der die Nachricht gesendet wurde. |
|
To Number
|
to | phone |
Telefonnummer, an die die Nachricht gesendet wurde. |
|
Der Status
|
status | string |
Gesendeter Status der Nachricht. |
|
SID
|
sid | string |
SID der gesendeten Nachricht. |
|
Konto-Sid
|
account_sid | string |
SID des Kontos, das der gesendeten Nachricht zugeordnet ist. |
|
API
|
api_version | string |
Version der API, die zum Senden der Nachricht verwendet wird. |
|
Segmentanzahl
|
num_segments | string |
Die Anzahl der Segmente, in die die Nachricht aufgeteilt wurde. |
|
Medienanzahl
|
num_media | string |
Die Anzahl der Mediendateien, die der gesendeten Nachricht zugeordnet sind. |
|
Erstellt Date-Time
|
date_created | string |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC-Format) |
|
Gesendete Date-Time
|
date_sent | string |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC-Format) |
|
Aktualisierte Date-Time
|
date_updated | string |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC-Format) |
|
Richtung
|
direction | string |
Richtung, die der gesendeten Nachricht zugeordnet ist. |
|
Fehlercodes
|
error_code | integer |
Fehlercodes, die der gesendeten Nachricht zugeordnet sind, falls vorhanden. |
|
Fehlermeldungen
|
error_message | string |
Fehlermeldungen, die der gesendeten Nachricht zugeordnet sind, falls vorhanden. |
|
Preis
|
price | string |
Kosten der gesendeten Nachricht. |
|
Einheit
|
price_unit | string |
Preiseinheit, die zum Auswerten der Kosten der Nachricht verwendet wird. |
|
URI
|
uri | uri |
Relativer URI für diese Ressource. |
|
Unterressourcen-URIs
|
subresource_uris | object |
Relative URIs für alle Unterressourcen. |
|
Nachrichtendienst-Sid
|
messaging_service_sid | string |
Eindeutige ID des Messagingdiensts. |
MessageList
Liste einer oder mehrerer Nachrichten.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
Seite
|
page | integer |
Seitenzahl der Respone. |
|
Limit
|
page_size | integer |
Seitengröße der Antwort. |
|
Seitenanzahl
|
num_pages | integer |
Gesamtanzahl der Seiten in der Antwort. |
|
Start
|
start | integer |
Index der ersten Nachricht. |
|
ENDE
|
end | integer |
Index der letzten Nachricht. |
|
URI
|
uri | uri |
Relativer URI für diese Liste. |
|
URI der ersten Seite
|
first_page_uri | uri |
Relativer URI für die erste Seite. |
|
URI der nächsten Seite
|
next_page_uri | uri |
Relativer URI für die nächste Seite. |
|
Nachrichtenanzahl
|
total | integer |
Gesamtanzahl der Nachrichten. |
|
Vorheriger Seiten-URI
|
previous_page_uri | uri |
Relativer URI für die vorherige Seite. |
MessageListV2
Liste einer oder mehrerer Nachrichten.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
Relativer URI für die nächste Seite. |
|
value
|
value | array of Message |
Liste einer oder mehrerer Nachrichten. |