Twilio
O Twilio permite que os aplicativos enviem e recebam mensagens SMS, MMS e IP globais.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://www.twilio.com/ |
| Política de privacidade | https://www.twilio.com/legal/privacy |
Requirements
O conector do Twilio requer as seguintes informações:
Sua ID da conta do Twilio e o token de autenticação, que você pode encontrar no painel do Twilio, para autorizar a criação de uma conexão do seu aplicativo. Se você estiver usando uma conta de avaliação do Twilio, poderá enviar mensagens de texto apenas para números de telefone verificados.
Um número de telefone Twilio verificado que pode enviar mensagens de texto e outro número de telefone que pode receber mensagens de texto.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID da conta do Twilio | secureString | ID da conta do Twilio | Verdade |
| Token de Acesso do Twilio | secureString | Token de Acesso do Twilio | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 1200 | 60 segundos |
Ações
| Enviar Mensagem de Texto (SMS) |
Essa operação é usada para enviar uma nova mensagem para um número de celular. |
| Listar mensagens [PRETERIDAS] |
Retorna uma lista de mensagens associadas à sua conta. |
| Listar Mensagens V2 |
Retorna uma lista de mensagens associadas à sua conta. Essa ação dá suporte à paginação. |
| Obter Mensagem |
Essa operação retorna uma única mensagem especificada pela ID da Mensagem fornecida. |
Enviar Mensagem de Texto (SMS)
Essa operação é usada para enviar uma nova mensagem para um número de celular.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Do número de telefone
|
from | True | string |
Um número de telefone Twilio (no formato E.164) ou uma ID do remetente alfanumérico habilitado para o tipo de mensagem que você deseja enviar. |
|
Para o número de telefone
|
to | True | string |
O número de telefone de destino. Formatar com um código '+' e country, por exemplo, +16175551212 (formato E.164). |
|
Texto
|
body | True | string |
O texto da mensagem que você deseja enviar, limitado a 1600 caracteres. |
|
Urls de mídia
|
media_url | array of uri |
Lista de URIs de mídia a serem enviadas. |
|
|
Chamada de status de volta
|
StatusCallback | uri |
Uma URL que o Twilio POSTARá sempre que o status da mensagem for alterado. |
|
|
Sid do Serviço de Mensagens
|
messaging_service_sid | string |
ID exclusiva do Serviço de Mensagens. |
|
|
SID do aplicativo
|
application_sid | string |
SID do aplicativo Twilio configurado com a chamada de status da mensagem necessária de volta. |
|
|
Preço Máximo
|
max_price | string |
O limite de preço máximo total da mensagem. |
|
|
Período de validade
|
validity_period | string |
O número de segundos que a mensagem pode permanecer em uma fila do Twilio. |
Retornos
Proprties de uma única mensagem.
- Message
- Message
Listar mensagens [PRETERIDAS]
Retorna uma lista de mensagens associadas à sua conta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Para o número de telefone
|
To | string |
Mostre apenas mensagens para esse número de telefone. |
|
|
Do número de telefone
|
From | string |
Mostre apenas mensagens desse número de telefone. |
|
|
Data enviada
|
DateSent | date |
Mostre apenas as mensagens enviadas nesta data (no formato GMT), fornecidas como YYYY-MM-DD. Exemplo: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
Quantos recursos devem ser retornados em cada página de lista. O padrão é 50. |
|
|
Página
|
Page | integer |
Número da página. O padrão é 0. |
Retornos
Lista de uma ou mais mensagens.
- Lista de Mensagens
- MessageList
Listar Mensagens V2
Retorna uma lista de mensagens associadas à sua conta. Essa ação dá suporte à paginação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Para o número de telefone
|
To | string |
Mostre apenas mensagens para esse número de telefone. |
|
|
Do número de telefone
|
From | string |
Mostre apenas mensagens desse número de telefone. |
|
|
Data enviada
|
DateSent | date |
Mostre apenas as mensagens enviadas nesta data (no formato GMT), fornecidas como YYYY-MM-DD. Exemplo: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
Quantos recursos devem ser retornados em cada página de lista. O padrão é 50. |
Retornos
Lista de uma ou mais mensagens.
- Lista de Mensagens V2
- MessageListV2
Obter Mensagem
Essa operação retorna uma única mensagem especificada pela ID da Mensagem fornecida.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
SID da mensagem
|
MessageId | True | string |
SID exclusivo da mensagem. |
Retornos
Proprties de uma única mensagem.
- Message
- Message
Definições
Message
Proprties de uma única mensagem.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto
|
body | string |
Corpo da mensagem. |
|
De Número
|
from | phone |
Número de telefone do qual a mensagem foi enviada. |
|
Para Número
|
to | phone |
Número de telefone para o qual a mensagem foi enviada. |
|
Situação
|
status | string |
Status enviado da mensagem. |
|
SID
|
sid | string |
SID da mensagem enviada. |
|
Sid da conta
|
account_sid | string |
SID da conta associada à mensagem enviada. |
|
API
|
api_version | string |
Versão da API usada para enviar a mensagem. |
|
Contagem de Segmentos
|
num_segments | string |
Número de segmentos em que a mensagem foi dividida. |
|
Contagem de mídia
|
num_media | string |
Número de arquivos de mídia associados à mensagem enviada. |
|
Criado Date-Time
|
date_created | string |
yyyyy-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Enviado Date-Time
|
date_sent | string |
yyyyy-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Atualização Date-Time
|
date_updated | string |
yyyyy-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Direção
|
direction | string |
Direção associada à mensagem enviada. |
|
Códigos de erro
|
error_code | integer |
Códigos de erro associados à mensagem enviada, se houver. |
|
Mensagens de erro
|
error_message | string |
Mensagens de erro associadas à mensagem enviada, se houver. |
|
Preço
|
price | string |
Custo da mensagem enviada. |
|
Unidade
|
price_unit | string |
Unidade de preço usada para avaliar o custo da mensagem. |
|
URI
|
uri | uri |
URI relativo para esse recurso. |
|
URIs de sub-fonte
|
subresource_uris | object |
URIs relativas para quaisquer sub-recursos. |
|
Sid do Serviço de Mensagens
|
messaging_service_sid | string |
ID exclusiva do Serviço de Mensagens. |
MessageList
Lista de uma ou mais mensagens.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
Página
|
page | integer |
Número da página do respone. |
|
Limit
|
page_size | integer |
Tamanho da página da resposta. |
|
Contagem de Páginas
|
num_pages | integer |
Número total de páginas na resposta. |
|
Start
|
start | integer |
Índice da primeira mensagem. |
|
participante
|
end | integer |
Índice da última mensagem. |
|
URI
|
uri | uri |
URI relativo para esta lista. |
|
URI da Primeira Página
|
first_page_uri | uri |
URI relativo para a primeira página. |
|
URI da Próxima Página
|
next_page_uri | uri |
URI relativo para a próxima página. |
|
Contagem de Mensagens
|
total | integer |
Número total de mensagens. |
|
URI da página anterior
|
previous_page_uri | uri |
URI relativo para a página anterior. |
MessageListV2
Lista de uma ou mais mensagens.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
URI relativo para a próxima página. |
|
value
|
value | array of Message |
Lista de uma ou mais mensagens. |