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 y RCS en sus flujos de trabajo, lo que simplifica y automatiza las comunicaciones de los clientes.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de 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 - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de 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 de 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 | |
|---|---|
| Publicador | 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 a varios destinatarios móviles. -
Send Rich Text Message (RCS): Enviar mensaje de texto enriquecido (RCS). -
Get sender IDs: esta acción devolverá una lista de identificadores de remitente vinculados a su cuenta. -
Get message status: obtención de un estado de mensaje mediante el identificador de mensaje -
When SMS or RCS is received: esta operación se desencadena cuando recibe un mensaje entrante (SMS o RCS). -
When delivery receipt is received: esta operación se desencadena cuando recibe un recibo de entrega para un mensaje saliente (SMS o RCS).
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) |
Esta acción se usa para enviar un mensaje de texto (SMS) a un número de móvil. |
| Enviar mensaje de texto enriquecido (RCS) |
Enviar mensaje de texto enriquecido (RCS) |
| Obtención de identificadores de remitente |
Esta acción devolverá una lista de identificadores de remitente vinculados a su cuenta. |
| Obtener el estado del mensaje |
Obtención de un estado de mensaje mediante el identificador de mensaje |
Enviar mensaje de texto (SMS)
Esta acción se usa para enviar un mensaje de texto (SMS) a un número de móvil.
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 mensaje de texto enriquecido (RCS)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
Obtención de identificadores de remitente
Esta acción devolverá 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 |
|
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
Obtención de un estado de mensaje mediante el 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 de texto saliente (SMS). |
| Cuando se recibe SMS o RCS |
Esta operación se desencadena cuando recibe un mensaje de texto entrante (SMS). |
Cuando se recibe el recibo de entrega
Esta operación se desencadena cuando recibe un recibo de entrega para un mensaje de texto saliente (SMS).
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 SMS o RCS
Esta operación se desencadena cuando recibe un mensaje de texto entrante (SMS).
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 |