Twilio
Met Twilio kunnen apps globale sms-, MMS- en IP-berichten verzenden en ontvangen.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Standaard | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Standaard | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Standaard | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Microsoft |
| URL |
Ondersteuning voor Microsoft LogicApps Ondersteuning voor Microsoft Power Automate Ondersteuning voor Microsoft Power Apps |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://www.twilio.com/ |
| Privacybeleid | https://www.twilio.com/legal/privacy |
Requirements
De Twilio-connector vereist de volgende informatie:
Uw Twilio-account-id en verificatietoken, die u kunt vinden op uw Twilio-dashboard, om het maken van een verbinding vanuit uw app te autoriseren. Als u een Twilio-proefaccount gebruikt, kunt u alleen sms-berichten verzenden naar geverifieerde telefoonnummers.
Eén geverifieerd Twilio-telefoonnummer dat sms-berichten kan verzenden en een ander telefoonnummer dat sms-berichten kan ontvangen.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Twilio-account-id | beveiligde string | Twilio-account-id | Klopt |
| Twilio-toegangstoken | beveiligde string | Twilio-toegangstoken | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 1200 | 60 seconden |
Acties
| Bericht ontvangen |
Met deze bewerking wordt één bericht geretourneerd dat is opgegeven door de opgegeven bericht-id. |
| Berichten weergeven [AFGESCHAFT] |
Retourneert een lijst met berichten die zijn gekoppeld aan uw account. |
| Berichten weergeven V2 |
Retourneert een lijst met berichten die zijn gekoppeld aan uw account. Deze actie ondersteunt paginering. |
| Tekstbericht verzenden (SMS) |
Deze bewerking wordt gebruikt om een nieuw bericht naar een mobiel nummer te verzenden. |
Bericht ontvangen
Met deze bewerking wordt één bericht geretourneerd dat is opgegeven door de opgegeven bericht-id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Bericht-SID
|
MessageId | True | string |
Unieke SID van het bericht. |
Retouren
Proprties van één bericht.
- Message
- Message
Berichten weergeven [AFGESCHAFT]
Retourneert een lijst met berichten die zijn gekoppeld aan uw account.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Naar telefoonnummer
|
To | string |
Alleen berichten weergeven op dit telefoonnummer. |
|
|
Van telefoonnummer
|
From | string |
Alleen berichten van dit telefoonnummer weergeven. |
|
|
Verzonden datum
|
DateSent | date |
Alleen berichten weergeven die zijn verzonden op deze datum (in GMT-indeling), gegeven als JJJJ-MM-DD. Voorbeeld: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
Hoeveel resources er op elke lijstpagina moeten worden geretourneerd. De standaardwaarde is 50. |
|
|
Page
|
Page | integer |
Paginanummer. De standaardwaarde is 0. |
Retouren
Lijst met een of meer berichten.
- Berichtenlijst
- MessageList
Berichten weergeven V2
Retourneert een lijst met berichten die zijn gekoppeld aan uw account. Deze actie ondersteunt paginering.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Naar telefoonnummer
|
To | string |
Alleen berichten weergeven op dit telefoonnummer. |
|
|
Van telefoonnummer
|
From | string |
Alleen berichten van dit telefoonnummer weergeven. |
|
|
Verzonden datum
|
DateSent | date |
Alleen berichten weergeven die zijn verzonden op deze datum (in GMT-indeling), gegeven als JJJJ-MM-DD. Voorbeeld: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
Hoeveel resources er op elke lijstpagina moeten worden geretourneerd. De standaardwaarde is 50. |
Retouren
Lijst met een of meer berichten.
- Berichtenlijst V2
- MessageListV2
Tekstbericht verzenden (SMS)
Deze bewerking wordt gebruikt om een nieuw bericht naar een mobiel nummer te verzenden.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Van telefoonnummer
|
from | True | string |
Een Twilio-telefoonnummer (in E.164-indeling) of alfanumerieke afzender-id ingeschakeld voor het type bericht dat u wilt verzenden. |
|
Naar telefoonnummer
|
to | True | string |
Het doeltelefoonnummer. Notatie met een +- en landcode, bijvoorbeeld +16175551212 (E.164-indeling). |
|
Tekst
|
body | True | string |
De tekst van het bericht dat u wilt verzenden, beperkt tot 1600 tekens. |
|
Media-URL's
|
media_url | array of uri |
Lijst met URI's van media die moeten worden verzonden. |
|
|
Statusoproep terug
|
StatusCallback | uri |
Een URL die door Twilio wordt geplaatst telkens wanneer de berichtstatus wordt gewijzigd. |
|
|
Berichtenservice-sid
|
messaging_service_sid | string |
Unieke id van de berichtenservice. |
|
|
Toepassings-SID
|
application_sid | string |
SID van Twilio-toepassing die is geconfigureerd met de vereiste berichtstatusoproep terug. |
|
|
Maximumprijs
|
max_price | string |
De totale maximumprijslimiet voor het bericht. |
|
|
Geldigheidsduur
|
validity_period | string |
Het aantal seconden dat het bericht in een Twilio-wachtrij kan blijven. |
Retouren
Proprties van één bericht.
- Message
- Message
Definities
Message
Proprties van één bericht.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Tekst
|
body | string |
Hoofdtekst van het bericht. |
|
Van getal
|
from | phone |
Telefoonnummer van waaruit het bericht is verzonden. |
|
Naar getal
|
to | phone |
Telefoonnummer waarnaar het bericht is verzonden. |
|
Toestand
|
status | string |
Verzonden status van het bericht. |
|
SID
|
sid | string |
SID van het verzonden bericht. |
|
Account-sid
|
account_sid | string |
SID van het account dat is gekoppeld aan het verzonden bericht. |
|
API
|
api_version | string |
Versie van de API die wordt gebruikt om het bericht te verzenden. |
|
Aantal segmenten
|
num_segments | string |
Het aantal segmenten in het bericht is onderverdeeld. |
|
Aantal media
|
num_media | string |
Het aantal mediabestanden dat is gekoppeld aan het verzonden bericht. |
|
Date-Time gemaakt
|
date_created | string |
jjjj-MM-ddTHH:mm:ss.fffZ (UTC-indeling) |
|
Verzonden Date-Time
|
date_sent | string |
jjjj-MM-ddTHH:mm:ss.fffZ (UTC-indeling) |
|
Bijgewerkte Date-Time
|
date_updated | string |
jjjj-MM-ddTHH:mm:ss.fffZ (UTC-indeling) |
|
Richting
|
direction | string |
Richting die is gekoppeld aan het verzonden bericht. |
|
Foutcodes
|
error_code | integer |
Foutcodes die zijn gekoppeld aan het verzonden bericht, indien van toepassing. |
|
Foutberichten
|
error_message | string |
Foutberichten die zijn gekoppeld aan het verzonden bericht, indien van toepassing. |
|
Prijs
|
price | string |
Kosten van het verzonden bericht. |
|
Unit
|
price_unit | string |
Prijseenheid die wordt gebruikt om de kosten van het bericht te evalueren. |
|
URI
|
uri | uri |
Relatieve URI voor deze resource. |
|
Subresource-URI's
|
subresource_uris | object |
Relatieve URI's voor subresources. |
|
Berichtenservice-sid
|
messaging_service_sid | string |
Unieke id van de berichtenservice. |
MessageList
Lijst met een of meer berichten.
| Name | Pad | Type | Description |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
Page
|
page | integer |
Paginanummer van het respone. |
|
Limit
|
page_size | integer |
Paginaformaat van het antwoord. |
|
Aantal pagina's
|
num_pages | integer |
Totaal aantal pagina's in het antwoord. |
|
Start
|
start | integer |
Index van het eerste bericht. |
|
Einde
|
end | integer |
Index van het laatste bericht. |
|
URI
|
uri | uri |
Relatieve URI voor deze lijst. |
|
Eerste pagina-URI
|
first_page_uri | uri |
Relatieve URI voor de eerste pagina. |
|
URI van volgende pagina
|
next_page_uri | uri |
Relatieve URI voor de volgende pagina. |
|
Aantal berichten
|
total | integer |
Totaal aantal berichten. |
|
Vorige pagina-URI
|
previous_page_uri | uri |
Relatieve URI voor de vorige pagina. |
MessageListV2
Lijst met een of meer berichten.
| Name | Pad | Type | Description |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
Relatieve URI voor de volgende pagina. |
|
waarde
|
value | array of Message |
Lijst met een of meer berichten. |