Twilio
Twilio permite a las aplicaciones enviar y recibir mensajes SMS globales, MMS e IP.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://www.twilio.com/ |
| Directiva de privacidad | https://www.twilio.com/legal/privacy |
Requisitos
El conector de Twilio requiere la siguiente información:
El identificador de cuenta de Twilio y el token de autenticación, que puede encontrar en el panel de Twilio, para autorizar la creación de una conexión desde la aplicación. Si usa una cuenta de prueba de Twilio, solo puede enviar mensajes de texto a números de teléfono comprobados.
Un número de teléfono de Twilio comprobado que puede enviar mensajes de texto y otro número de teléfono que puede recibir mensajes de texto.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | Compartible |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Id. de cuenta de Twilio | securestring | Id. de cuenta de Twilio | Cierto |
| Token de acceso de Twilio | securestring | Token de acceso de Twilio | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 1200 | 60 segundos |
Acciones
| Enumerar mensajes [EN DESUSO] |
Devuelve una lista de mensajes asociados a su cuenta. |
| Enumerar mensajes V2 |
Devuelve una lista de mensajes asociados a su cuenta. Esta acción admite la paginación. |
| Enviar mensaje de texto (SMS) |
Esta operación se usa para enviar un nuevo mensaje a un número de móvil. |
| Obtener mensaje |
Esta operación devuelve un único mensaje especificado por el identificador de mensaje proporcionado. |
Enumerar mensajes [EN DESUSO]
Devuelve una lista de mensajes asociados a su cuenta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de teléfono
|
To | string |
Mostrar solo mensajes a este número de teléfono. |
|
|
Número de teléfono
|
From | string |
Mostrar solo mensajes de este número de teléfono. |
|
|
Fecha de envío
|
DateSent | date |
Mostrar solo los mensajes enviados en esta fecha (en formato GMT), dados como AAAA-MM-DD. Ejemplo: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
Cuántos recursos se van a devolver en cada página de lista. El valor predeterminado es 50. |
|
|
Página
|
Page | integer |
Número de página. El valor predeterminado es 0. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageList
Enumerar mensajes V2
Devuelve una lista de mensajes asociados a su cuenta. Esta acción admite la paginación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de teléfono
|
To | string |
Mostrar solo mensajes a este número de teléfono. |
|
|
Número de teléfono
|
From | string |
Mostrar solo mensajes de este número de teléfono. |
|
|
Fecha de envío
|
DateSent | date |
Mostrar solo los mensajes enviados en esta fecha (en formato GMT), dados como AAAA-MM-DD. Ejemplo: 2009-07-06. |
|
|
Limit
|
PageSize | integer |
Cuántos recursos se van a devolver en cada página de lista. El valor predeterminado es 50. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes V2
- MessageListV2
Enviar mensaje de texto (SMS)
Esta operación se usa para enviar un nuevo mensaje a un número de móvil.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de teléfono
|
from | True | string |
Número de teléfono de Twilio (en formato E.164) o identificador de remitente alfanumérico habilitado para el tipo de mensaje que desea enviar. |
|
Número de teléfono
|
to | True | string |
Número de teléfono de destino. Formato con un código de país y "+", por ejemplo, +16175551212 (formato E.164). |
|
Mensaje de texto
|
body | True | string |
Texto del mensaje que desea enviar, limitado a 1600 caracteres. |
|
Direcciones URL de medios
|
media_url | array of uri |
Lista de URI de medios que se van a enviar. |
|
|
Devolución de llamada de estado
|
StatusCallback | uri |
Una dirección URL que Twilio publicará en cada vez que cambie el estado del mensaje. |
|
|
Sid del servicio de mensajería
|
messaging_service_sid | string |
Identificador único del servicio de mensajería. |
|
|
SID de aplicación
|
application_sid | string |
SID de la aplicación de Twilio que está configurada con la devolución de llamada de estado de mensaje necesaria. |
|
|
Precio máximo
|
max_price | string |
Límite de precio máximo total para el mensaje. |
|
|
Período de validez
|
validity_period | string |
Número de segundos que el mensaje puede permanecer en una cola de Twilio. |
Devoluciones
Propiedades de un único mensaje.
- Message
- Message
Obtener mensaje
Esta operación devuelve un único mensaje especificado por el identificador de mensaje proporcionado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
SID de mensaje
|
MessageId | True | string |
SID único del mensaje. |
Devoluciones
Propiedades de un único mensaje.
- Message
- Message
Definiciones
Message
Propiedades de un único mensaje.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Mensaje de texto
|
body | string |
Cuerpo del mensaje. |
|
From Number
|
from | phone |
Número de teléfono desde el que se envió el mensaje. |
|
Para número
|
to | phone |
Número de teléfono al que se envió el mensaje. |
|
Estado
|
status | string |
Estado enviado del mensaje. |
|
SID
|
sid | string |
SID del mensaje enviado. |
|
Sid de cuenta
|
account_sid | string |
SID de la cuenta asociada al mensaje enviado. |
|
API
|
api_version | string |
Versión de la API que se usa para enviar el mensaje. |
|
Recuento de segmentos
|
num_segments | string |
Número de segmentos en los que se dividió el mensaje. |
|
Recuento de medios
|
num_media | string |
Número de archivos multimedia asociados al mensaje enviado. |
|
Date-Time creados
|
date_created | string |
aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Date-Time enviados
|
date_sent | string |
aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Date-Time actualizado
|
date_updated | string |
aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Dirección
|
direction | string |
Dirección asociada al mensaje enviado. |
|
Códigos de error
|
error_code | integer |
Códigos de error asociados al mensaje enviado, si existe. |
|
Mensajes de error
|
error_message | string |
Mensajes de error asociados al mensaje enviado, si existe. |
|
Precio
|
price | string |
Costo del mensaje enviado. |
|
Unidad
|
price_unit | string |
Unidad de precio utilizada para evaluar el costo del mensaje. |
|
URI
|
uri | uri |
URI relativo para este recurso. |
|
URI de subrecursos
|
subresource_uris | object |
URI relativos para cualquier subrecurso. |
|
Sid del servicio de mensajería
|
messaging_service_sid | string |
Identificador único del servicio de mensajería. |
MessageList
Lista de uno o varios mensajes.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
Página
|
page | integer |
Número de página de la respuesta. |
|
Limit
|
page_size | integer |
Tamaño de página de la respuesta. |
|
Recuento de páginas
|
num_pages | integer |
Número total de páginas en la respuesta. |
|
Comenzar
|
start | integer |
Índice del primer mensaje. |
|
Fin
|
end | integer |
Índice del último mensaje. |
|
URI
|
uri | uri |
URI relativo para esta lista. |
|
URI de primera página
|
first_page_uri | uri |
URI relativo para la primera página. |
|
URI de página siguiente
|
next_page_uri | uri |
URI relativo para la página siguiente. |
|
Recuento de mensajes
|
total | integer |
Número total de mensajes. |
|
URI de página anterior
|
previous_page_uri | uri |
URI relativo para la página anterior. |
MessageListV2
Lista de uno o varios mensajes.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
URI relativo para la página siguiente. |
|
value
|
value | array of Message |
Lista de uno o varios mensajes. |