Twilio
Twilio umožňuje aplikacím odesílat a přijímat globální zprávy SMS, MMS a IP.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Standard | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Power Automate | Standard | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Microsoft |
| URL |
Podpora Microsoft LogicApps Podpora microsoft Power Automate Podpora Microsoft Power Apps |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsoft |
| Internetová stránka | https://www.twilio.com/ |
| Zásady ochrany osobních údajů | https://www.twilio.com/legal/privacy |
Požadavky
Konektor Twilio vyžaduje následující informace:
ID účtu Twilio a ověřovací token, který najdete na řídicím panelu Twilio, k autorizaci vytvoření připojení z vaší aplikace. Pokud používáte zkušební účet Twilio, můžete posílat textové zprávy jenom na ověřená telefonní čísla.
Jedno ověřené telefonní číslo Twilio, které může posílat textové zprávy a jiné telefonní číslo, které může přijímat textové zprávy.
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Sdíletelný |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs
| Název | Typ | Description | Povinné |
|---|---|---|---|
| ID účtu Twilio | securestring | ID účtu Twilio | Pravdivé |
| Přístupový token Twilio | securestring | Přístupový token Twilio | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 1200 | 60 sekund |
Akce
| Odeslat textovou zprávu (SMS) |
Tato operace slouží k odeslání nové zprávy na číslo mobilního zařízení. |
| Seznam zpráv [ZASTARALÉ] |
Vrátí seznam zpráv přidružených k vašemu účtu. |
| Výpis zpráv V2 |
Vrátí seznam zpráv přidružených k vašemu účtu. Tato akce podporuje stránkování. |
| Získat zprávu |
Tato operace vrátí jednu zprávu určenou zadaný zadaným ID zprávy. |
Odeslat textovou zprávu (SMS)
Tato operace slouží k odeslání nové zprávy na číslo mobilního zařízení.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Z telefonního čísla
|
from | True | string |
Telefonní číslo Twilio (ve formátu E.164) nebo ID alfanumerického odesílatele povolené pro typ zprávy, kterou chcete odeslat. |
|
Na telefonní číslo
|
to | True | string |
Cílové telefonní číslo. Formát s kódem +, např. +16175551212 (formát E.164). |
|
Text
|
body | True | string |
Text zprávy, kterou chcete odeslat, je omezený na 1600 znaků. |
|
Adresy URL médií
|
media_url | array of uri |
Seznam identifikátorů URI médií, které se mají odeslat. |
|
|
Zpět stavový hovor
|
StatusCallback | uri |
Adresa URL, na kterou Twilio odešle příspěvek při každé změně stavu zprávy. |
|
|
Sid služby zasílání zpráv
|
messaging_service_sid | string |
Jedinečné ID služby zasílání zpráv. |
|
|
SID aplikace
|
application_sid | string |
SID aplikace Twilio, která je nakonfigurovaná s požadovaným stavovým voláním zprávy zpět. |
|
|
Maximální cena
|
max_price | string |
Celkový maximální limit ceny zprávy. |
|
|
Doba platnosti
|
validity_period | string |
Počet sekund, po které může zpráva zůstat ve frontě Twilio. |
Návraty
Proprties of a single message.
- Message
- Message
Seznam zpráv [ZASTARALÉ]
Vrátí seznam zpráv přidružených k vašemu účtu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Na telefonní číslo
|
To | string |
Zobrazí se jenom zprávy na toto telefonní číslo. |
|
|
Z telefonního čísla
|
From | string |
Zobrazí se jenom zprávy z tohoto telefonního čísla. |
|
|
Datum odeslání
|
DateSent | date |
Zobrazovat pouze zprávy odeslané k tomuto datu (ve formátu GMT) zadané jako RRRR-MM-DD. Příklad: 2009-07-06. |
|
|
Omezení
|
PageSize | integer |
Kolik prostředků se má vrátit na každé stránce seznamu. Výchozí hodnota je 50. |
|
|
Stránka
|
Page | integer |
Číslo stránky. Výchozí hodnota je 0. |
Návraty
Seznam jedné nebo více zpráv
- Seznam zpráv
- MessageList
Výpis zpráv V2
Vrátí seznam zpráv přidružených k vašemu účtu. Tato akce podporuje stránkování.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Na telefonní číslo
|
To | string |
Zobrazí se jenom zprávy na toto telefonní číslo. |
|
|
Z telefonního čísla
|
From | string |
Zobrazí se jenom zprávy z tohoto telefonního čísla. |
|
|
Datum odeslání
|
DateSent | date |
Zobrazovat pouze zprávy odeslané k tomuto datu (ve formátu GMT) zadané jako RRRR-MM-DD. Příklad: 2009-07-06. |
|
|
Omezení
|
PageSize | integer |
Kolik prostředků se má vrátit na každé stránce seznamu. Výchozí hodnota je 50. |
Návraty
Seznam jedné nebo více zpráv
- Seznam zpráv V2
- MessageListV2
Získat zprávu
Tato operace vrátí jednu zprávu určenou zadaný zadaným ID zprávy.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
SID zprávy
|
MessageId | True | string |
Jedinečný identifikátor SID zprávy. |
Návraty
Proprties of a single message.
- Message
- Message
Definice
Message
Proprties of a single message.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Text
|
body | string |
Text zprávy. |
|
Z čísla
|
from | phone |
Telefonní číslo, ze kterého byla zpráva odeslána. |
|
Na číslo
|
to | phone |
Telefonní číslo, na které byla zpráva odeslána. |
|
Stav
|
status | string |
Stav zprávy byl odeslán. |
|
SID
|
sid | string |
IDENTIFIKÁTOR SID odeslané zprávy. |
|
Sid účtu
|
account_sid | string |
IDENTIFIKÁTOR SID účtu přidruženého k odeslané zprávě. |
|
API
|
api_version | string |
Verze rozhraní API použitého k odeslání zprávy |
|
Počet segmentů
|
num_segments | string |
Počet segmentů, na které byla zpráva rozdělena. |
|
Počet médií
|
num_media | string |
Počet multimediálních souborů přidružených k odeslané zprávě |
|
Vytvořeno Date-Time
|
date_created | string |
yyyy-MM-ddTHH:mm:ss.fffZ (formát UTC) |
|
Odeslaná Date-Time
|
date_sent | string |
yyyy-MM-ddTHH:mm:ss.fffZ (formát UTC) |
|
Aktualizace Date-Time
|
date_updated | string |
yyyy-MM-ddTHH:mm:ss.fffZ (formát UTC) |
|
Směr
|
direction | string |
Směr přidružený k odeslané zprávě |
|
Kódy chyb
|
error_code | integer |
Kódy chyb spojené s odeslanou zprávou( pokud existuje). |
|
Chybové zprávy
|
error_message | string |
Chybové zprávy spojené s odeslanou zprávou, pokud existuje. |
|
Cena
|
price | string |
Náklady na odeslanou zprávu |
|
Jednotka
|
price_unit | string |
Cenová jednotka použitá k vyhodnocení nákladů zprávy. |
|
identifikátor URI
|
uri | uri |
Relativní identifikátor URI pro tento prostředek |
|
Identifikátory URI podsourců
|
subresource_uris | object |
Relativní identifikátory URI pro všechny dílčí zdroje |
|
Sid služby zasílání zpráv
|
messaging_service_sid | string |
Jedinečné ID služby zasílání zpráv |
MessageList
Seznam jedné nebo více zpráv
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
Stránka
|
page | integer |
Číslo stránky respone. |
|
Omezení
|
page_size | integer |
Velikost stránky odpovědi |
|
Počet stránek
|
num_pages | integer |
Celkový počet stránek v odpovědi |
|
Začátek
|
start | integer |
Index první zprávy |
|
konec
|
end | integer |
Index poslední zprávy |
|
identifikátor URI
|
uri | uri |
Relativní identifikátor URI pro tento seznam |
|
Identifikátor URI první stránky
|
first_page_uri | uri |
Relativní identifikátor URI první stránky |
|
Identifikátor URI další stránky
|
next_page_uri | uri |
Relativní identifikátor URI pro další stránku |
|
Počet zpráv
|
total | integer |
Celkový počet zpráv |
|
Předchozí identifikátor URI stránky
|
previous_page_uri | uri |
Relativní identifikátor URI předchozí stránky |
MessageListV2
Seznam jedné nebo více zpráv
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
Relativní identifikátor URI pro další stránku |
|
value
|
value | array of Message |
Seznam jedné nebo více zpráv |