Sinch (versión preliminar)
Sinch ayuda a su empresa a conectarse con los clientes a través de alertas, recordatorios, invitaciones, campañas de marketing, etc. Con tecnología de Sinch Engage, Sinch MessageMedia, One NZ, eTXT y GroupText, nuestras plataformas entregan miles de millones de mensajes globalmente. Con este conector, puede integrar fácilmente SMS, RCS y MMS en sus flujos de trabajo, optimizando y automatizando las comunicaciones de los clientes.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - 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 Government - Azure regiones de China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Canal de soporte técnico |
| URL | https://messagemedia.com/contact/ |
| Correo Electrónico | support@messagemedia.com |
| Metadatos del conector | |
|---|---|
| Publisher | Sinch Suecia AB |
| Website | https://messagemedia.com |
| Directiva de privacidad | https://messagemedia.com/legal/privacy-policy/ |
| Categorías | Communication |
Nombre del conector
Sinch
Documentación de la API
https://messagemedia.github.io/documentation/#tag/Messages/operation/SendMessages
Operaciones admitidas
https://support.messagemedia.com/hc/en-us/categories/10710547404559-Power-Automate-App-Support
Obtención de credenciales
Este conector usa API Key y API secret autenticación (consulte los pasos del vínculo siguiente sobre cómo obtener uno). https://support.messagemedia.com/hc/en-us/articles/4413627066383-Creating-New-API-Credentials
Operaciones admitidas
Este conector admite las siguientes operaciones:
-
Send Text Message (SMS): envíe un mensaje de texto (SMS) a varios destinatarios móviles. -
Send Rich Text Message (RCS): envíe un mensaje RCS a un destinatario móvil. -
Send MMS Message (MMS): envíe un mensaje multimedia (MMS) a varios destinatarios móviles. -
Get sender IDs: obtenga una lista de identificadores de remitente vinculados a su cuenta. -
Get message status: obtiene un estado de mensaje mediante un identificador de mensaje. -
When a message is received: esta operación se desencadena cuando recibe un mensaje entrante (SMS, RCS, MMS). -
When delivery receipt is received: esta operación se desencadena cuando recibe un recibo de entrega para un mensaje saliente (SMS, RCS, MMS).
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 | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| clave_api | securestring | La api_key de esta API | Cierto |
| api_secret | securestring | La api_secret de esta API | Cierto |
| Servicios sinch | cuerda / cadena | Esta es la API a la que se está conectando, elija una de las siguientes opciones: Sinch MessageMedia (mejor para cuentas específicas de Asia); Sinch engage (Mejor para Europa, cuentas de EE. UU.) | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Enviar mensaje de texto (SMS) |
Envíe un mensaje de texto (SMS) a varios destinatarios móviles. |
| Enviar mensaje de texto enriquecido (RCS) |
Enviar un mensaje RCS a un destinatario móvil. |
| Enviar mensaje MMS |
Esta acción se usa para enviar un mensaje multimedia (MMS) a un número de móvil. |
| Obtención de identificadores de remitente |
Obtenga una lista de identificadores de remitente vinculados a su cuenta. |
| Obtener el estado del mensaje |
Obtenga un estado de mensaje mediante un identificador de mensaje. |
Enviar mensaje de texto (SMS)
Envíe un mensaje de texto (SMS) a varios destinatarios móviles.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del remitente
|
source_number | string |
Especificar un número de origen que se va a usar |
|
|
Número de destino
|
to | True | string |
Número de móvil del destinatario en formato E.164. Máximo de 100 destinatarios, separados por un espacio |
|
Message
|
message | True | string |
Cuerpo del mensaje SMS |
|
Informe de entrega
|
delivery_report | boolean |
Los informes de entrega se pueden solicitar con cada mensaje. Si se solicitan informes de entrega, se enviará un webhook a la propiedad callback_url especificada para el mensaje (o a los webhooks). |
|
|
Dirección URL de devolución de llamada
|
callback_url | string |
Se puede incluir una dirección URL con cada mensaje al que se insertarán webhooks a través de una solicitud HTTP POST. |
|
|
Clave de metadatos
|
metadata_key | string |
clave de metadatos |
|
|
Valor de los metadatos
|
metadata_value | string |
valor de metadatos |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Los informes de entrega se pueden solicitar con cada mensaje. Si se solicitan informes de entrega, se enviará un webhook a la propiedad callback_url especificada para el mensaje (o a los webhooks). |
|
destination_number
|
messages.destination_number | string |
número de destino |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
marca de tiempo de expiración del mensaje |
|
message_flags
|
messages.message_flags | array of |
marcas de mensaje |
|
message_id
|
messages.message_id | string |
id. de mensaje |
|
Fuente
|
messages.metadata.Source | string |
Fuente |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
estado
|
messages.status | string |
estado |
|
contenido
|
messages.content | string |
contenido |
|
source_number
|
messages.source_number | string |
número de origen |
|
medios
|
messages.media | array of string |
medios |
|
Asunto
|
messages.subject | string |
Asunto |
Enviar mensaje de texto enriquecido (RCS)
Enviar un mensaje RCS a un destinatario móvil.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
Enviar mensaje MMS
Esta acción se usa para enviar un mensaje multimedia (MMS) a un número de móvil.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de destino
|
to | True | string |
Número de móvil del destinatario en formato E.164. Máximo de 100 destinatarios, separados por un espacio |
|
Message
|
message | True | string |
Cuerpo del mensaje MMS |
|
Contenido multimedia
|
media | byte |
Contenido multimedia que se va a incluir en el mensaje MMS, codificado como una cadena Base64. Los tipos de medios admitidos incluyen imágenes (JPEG, PNG, GIF), vídeos (MP4) y archivos de audio (MP3). El tamaño máximo de archivo para cada archivo adjunto multimedia es 600kB. |
|
|
Id. del remitente
|
source_number | string |
Especificar un número de origen compatible con MMS que se va a usar |
|
|
Clave de metadatos
|
metadata_key | string |
Clave de metadatos |
|
|
Valor de los metadatos
|
metadata_value | string |
Valor de los metadatos |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Los informes de entrega se pueden solicitar con cada mensaje |
|
destination_number
|
messages.destination_number | string |
número de destino |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
marca de tiempo de expiración del mensaje |
|
message_id
|
messages.message_id | string |
id. de mensaje |
|
Fuente
|
messages.metadata.Source | string |
Fuente |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
estado
|
messages.status | string |
estado |
|
contenido
|
messages.content | string |
contenido |
|
source_number
|
messages.source_number | string |
número de origen |
|
medios
|
messages.media | array of string |
medios |
|
Asunto
|
messages.subject | string |
Asunto |
Obtención de identificadores de remitente
Obtenga una lista de identificadores de remitente vinculados a su cuenta.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
página
|
pagination.page | integer |
página |
|
page_size
|
pagination.page_size | integer |
page_size |
|
total_count
|
pagination.total_count | integer |
total_count |
|
page_count
|
pagination.page_count | integer |
page_count |
|
type
|
default_sender.type | string |
type |
|
number
|
default_sender.number | string |
number |
|
source_type
|
default_sender.source_type | string |
source_type |
|
mms_capable
|
default_sender.mms_capable | boolean |
mms_capable |
|
Remitentes
|
senders | array of object |
Remitentes |
|
display_type
|
senders.display_type | string |
display_type |
|
is_default
|
senders.is_default | boolean |
is_default |
|
label
|
senders.label | string |
label |
|
mms_capable
|
senders.mms_capable | boolean |
mms_capable |
|
number
|
senders.number | string |
number |
|
display_name
|
senders.display_name | string |
Nombre para mostrar con formato para el remitente |
|
number_id
|
senders.number_id | string |
number_id |
|
source_type
|
senders.source_type | string |
source_type |
|
type
|
senders.type | string |
type |
|
number_status
|
senders.number_status | string |
number_status |
|
account_id
|
account_id | string |
account_id |
|
vendor_id
|
vendor_id | string |
vendor_id |
Obtener el estado del mensaje
Obtenga un estado de mensaje mediante un identificador de mensaje.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador único de este mensaje
|
messageId | True | string |
Identificador único de este mensaje |
Devoluciones
- Body
- message
Desencadenadores
| Cuando se recibe el recibo de entrega |
Esta operación se desencadena cuando recibe un recibo de entrega para un mensaje saliente (SMS, RCS, MMS). |
| Cuando se recibe un mensaje |
Esta operación se desencadena cuando recibe un mensaje entrante (SMS, RCS, MMS). |
Cuando se recibe el recibo de entrega
Esta operación se desencadena cuando recibe un recibo de entrega para un mensaje saliente (SMS, RCS, MMS).
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
Identificador del mensaje original |
|
estado
|
status | string |
Los informes de entrega indican el estado del mensaje |
|
source_address
|
source_address | string |
dirección de origen |
|
destination_address
|
destination_address | string |
dirección de destino |
|
contenido
|
content | string |
contenido |
|
type
|
type | string |
type |
|
delivery_report_id
|
delivery_report_id | string |
id. de informe de entrega |
|
status_code
|
status_code | string |
Los códigos de estado proporcionan información más detallada sobre el estado de un mensaje |
|
submitted_date
|
submitted_date | string |
Marca de tiempo del mensaje |
|
date_received
|
date_received | string |
Marca de tiempo del proveedor |
|
Attachments
|
attachments | array of object |
Attachments |
|
Tipo de datos adjuntos
|
attachments.attachment_type | string |
Tipo de datos adjuntos |
|
Contenido adjunto
|
attachments.attachment_content | string |
Contenido adjunto |
|
Nombre de datos adjuntos
|
attachments.attachment_name | string |
Nombre de datos adjuntos |
|
Metadatos
|
metadata | array of object |
Todos los metadatos que se incluyeron en el mensaje de envío original |
|
Clave de metadatos
|
metadata.metadata_key | string |
Clave de metadatos |
|
Valor de los metadatos
|
metadata.metadata_value | string |
Valor de los metadatos |
Cuando se recibe un mensaje
Esta operación se desencadena cuando recibe un mensaje entrante (SMS, RCS, MMS).
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
Identificador del mensaje original |
|
reply_id
|
reply_id | string |
Identificador único de la respuesta que representa esta notificación |
|
estado
|
status | string |
Los informes de entrega indican el estado del mensaje |
|
source_address
|
source_address | string |
dirección de origen |
|
destination_address
|
destination_address | string |
dirección de destino |
|
contenido
|
content | string |
Contenido de la respuesta |
|
Contenido del mensaje V2: texto
|
contact_message.text_message.text | string |
Contenido del mensaje V2: texto |
|
type
|
type | string |
type |
|
status_code
|
status_code | string |
Los códigos de estado proporcionan información más detallada sobre el estado de un mensaje |
|
submitted_date
|
submitted_date | string |
Marca de tiempo del mensaje |
|
date_received
|
date_received | string |
Marca de tiempo del proveedor |
|
Attachments
|
attachments | array of object |
Lista que contiene todos los datos adjuntos incluidos en la respuesta. Este campo solo está presente si ha habilitado MMS de entrada en su cuenta y la respuesta contiene datos adjuntos. |
|
Tipo de datos adjuntos
|
attachments.attachment_type | string |
Tipo MIME asociado a estos datos adjuntos |
|
Contenido adjunto
|
attachments.attachment_content | string |
Datos adjuntos codificados en Base64 |
|
Nombre de datos adjuntos
|
attachments.attachment_name | string |
Nombre de los datos adjuntos |
|
Metadatos
|
metadata | array of object |
Todos los metadatos que se incluyeron en la solicitud de mensaje de envío original |
|
Clave de metadatos
|
metadata.metadata_key | string |
Clave de metadatos |
|
Valor de los metadatos
|
metadata.metadata_value | string |
Valor de los metadatos |
Definiciones
Mensaje
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
callback_url
|
callback_url | string |
Se puede incluir una dirección URL con cada mensaje al que se insertarán webhooks a través de una solicitud HTTP POST. |
|
delivery_report
|
delivery_report | boolean |
Los informes de entrega se pueden solicitar con cada mensaje. Si se solicitan informes de entrega, se enviará un webhook a la propiedad callback_url especificada para el mensaje (o a los webhooks). |
|
destination_number
|
destination_number | string |
Número de destino al que se debe entregar el mensaje |
|
format
|
format | string |
El formato especifica qué formato se enviará el mensaje como, SMS (mensaje de texto), MMS (mensaje multimedia) o TTS (texto a voz) |
|
message_expiry_timestamp
|
message_expiry_timestamp | string |
Se puede proporcionar una marca de tiempo de expiración de mensajes para especificar la hora más reciente en la que se debe entregar el mensaje. |
|
message_flags
|
message_flags | array of |
message_flags |
|
message_id
|
message_id | string |
Id. de mensaje |
|
Fuente
|
metadata.Source | string |
Fuente |
|
scheduled
|
scheduled | string |
Fecha de entrega programada del mensaje |
|
estado
|
status | string |
Estado del mensaje |
|
contenido
|
content | string |
contenido |
|
source_number
|
source_number | string |
número de origen |
|
medios
|
media | array of string |
medios |
|
Asunto
|
subject | string |
Asunto |