Twilio
O Twilio permite que os aplicativos enviem e recebam mensagens globais de SMS, MMS e IP.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | 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) |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , 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 | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://www.twilio.com/ |
| Política de privacidade | https://www.twilio.com/legal/privacy |
Requerimentos
O conector Twilio requer as seguintes informações:
Seu ID de conta Twilio e token de autenticação, que você pode encontrar em seu painel Twilio, para autorizar a criação de uma conexão a partir 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.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta é 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 de conectores para aplicativos de tela - Power Apps | Documentos Microsoft
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID da conta Twilio | securestring | ID da conta Twilio | Verdade |
| Token de acesso Twilio | securestring | Token de acesso Twilio | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 1200 | 60 segundos |
Ações
| Enviar mensagem de texto (SMS) |
Esta operação é usada para enviar uma nova mensagem para um número de celular. |
| Listar mensagens [PRETERIDO] |
Retorna uma lista de mensagens associadas à sua conta. |
| Listar mensagens V2 |
Retorna uma lista de mensagens associadas à sua conta. Esta ação suporta paginação. |
| Obter mensagem |
Esta operação retorna uma única mensagem especificada pelo ID de mensagem fornecido. |
Enviar mensagem de texto (SMS)
Esta operação é usada para enviar uma nova mensagem para um número de celular.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Do número de telefone
|
from | True | string |
Um número de telefone Twilio (no formato E.164) ou ID de remetente alfanumérico ativado 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. Formato com «+» e código do país, por exemplo, +16175551212 (formato E.164). |
|
Texto
|
body | True | string |
O texto da mensagem que pretende enviar, limitado a 1600 carateres. |
|
Urls de mídia
|
media_url | array of uri |
Lista de URIs de mídia a serem enviados. |
|
|
Status Chamada de volta
|
StatusCallback | uri |
Um URL que o Twilio irá POSTAR cada vez que o status da sua mensagem mudar. |
|
|
Serviço de mensagens Sid
|
messaging_service_sid | string |
ID exclusivo do serviço de mensagens. |
|
|
SID de aplicação
|
application_sid | string |
SID do aplicativo Twilio que é configurado com a chamada de status de mensagem necessária de volta. |
|
|
Preço Máximo
|
max_price | string |
O limite de preço máximo total para a mensagem. |
|
|
Período de validade
|
validity_period | string |
O número de segundos que a mensagem pode permanecer em uma fila do Twilio. |
Devoluções
Proprties de uma única mensagem.
- Message
- Message
Listar mensagens [PRETERIDO]
Retorna uma lista de mensagens associadas à sua conta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Para o número de telefone
|
To | string |
Mostrar apenas mensagens para este número de telefone. |
|
|
Do número de telefone
|
From | string |
Mostrar apenas mensagens deste número de telefone. |
|
|
Data de envio
|
DateSent | date |
Mostrar apenas as mensagens enviadas nesta data (em formato GMT), dadas como AAAA-MM-DD. Exemplo: 2009-07-06. |
|
|
Limite
|
PageSize | integer |
Quantos recursos retornar em cada página de lista. O padrão é 50. |
|
|
Página
|
Page | integer |
Número da página. O padrão é 0. |
Devoluções
Lista de uma ou mais mensagens.
- Lista de Mensagens
- MessageList
Listar mensagens V2
Retorna uma lista de mensagens associadas à sua conta. Esta ação suporta paginação.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Para o número de telefone
|
To | string |
Mostrar apenas mensagens para este número de telefone. |
|
|
Do número de telefone
|
From | string |
Mostrar apenas mensagens deste número de telefone. |
|
|
Data de envio
|
DateSent | date |
Mostrar apenas as mensagens enviadas nesta data (em formato GMT), dadas como AAAA-MM-DD. Exemplo: 2009-07-06. |
|
|
Limite
|
PageSize | integer |
Quantos recursos retornar em cada página de lista. O padrão é 50. |
Devoluções
Lista de uma ou mais mensagens.
- Lista de Mensagens V2
- MessageListV2
Obter mensagem
Esta operação retorna uma única mensagem especificada pelo ID de mensagem fornecido.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
SID da mensagem
|
MessageId | True | string |
SID exclusivo da mensagem. |
Devoluções
Proprties de uma única mensagem.
- Message
- Message
Definições
Message
Proprties de uma única mensagem.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto
|
body | string |
Corpo da mensagem. |
|
Do número
|
from | phone |
Número de telefone a partir do qual a mensagem foi enviada. |
|
Para o 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. |
|
Conta Sid
|
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 |
aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Enviado Date-Time
|
date_sent | string |
aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Atualizado Date-Time
|
date_updated | string |
aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Direction
|
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 |
Preço unitário utilizado para avaliar o custo da mensagem. |
|
URI
|
uri | uri |
URI relativo para este recurso. |
|
URIs de subrecursos
|
subresource_uris | object |
URIs relativos para quaisquer subrecursos. |
|
Serviço de mensagens Sid
|
messaging_service_sid | string |
ID exclusivo do serviço de mensagens. |
Lista de mensagens
Lista de uma ou mais mensagens.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
Página
|
page | integer |
Número da página da respone. |
|
Limite
|
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. |
|
Fim
|
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 página seguinte
|
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.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
URI relativo para a próxima página. |
|
valor
|
value | array of Message |
Lista de uma ou mais mensagens. |