Sms Works (publicador independiente) (versión preliminar)
SMS Works es un servicio sms de bajo costo para desarrolladores basados en El Reino Unido. Solo se le facturan los mensajes de texto entregados.
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 | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| Correo Electrónico | ttaylor@hitachisolutions.com |
| Metadatos del conector | |
|---|---|
| Publicador | Troy Taylor |
| Sitio web | https://thesmsworks.co.uk/ |
| Directiva de privacidad | https://thesmsworks.co.uk/privacy |
| Categorías | Communication |
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 |
|---|---|---|---|
| JWT Token | securestring | Token JWT para esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Buscar mensajes |
Recupere hasta 1000 mensajes que coincidan con los criterios de búsqueda. |
| Cancelar lote programado |
Cancela un mensaje SMS programado. |
| Cancelar mensaje programado |
Cancela un mensaje SMS programado. |
| Eliminar mensaje |
Elimine el mensaje con el messageid coincidente. |
| Enviar colección de mensajes |
Envía una colección de mensajes SMS únicos. Los lotes pueden contener hasta 5000 mensajes a la vez. |
| Enviar mensaje flash |
Envía un mensaje flash SMS, que aparece en la pantalla de bloqueo de los destinatarios. |
| Enviar un mensaje SMS |
Envía un mensaje SMS basado en los parámetros. |
| Envío de lotes |
Envíe un único mensaje SMS a varios destinatarios. |
| Mensaje de programación |
Programa un mensaje SMS que se enviará en la fecha y hora que especifique. |
| Obtención de mensajes con errores |
Recupere mensajes con errores que coincidan con los criterios de búsqueda. |
| Obtención de mensajes no leídos |
Obtenga mensajes entrantes no leídos que coincidan con los criterios de búsqueda. |
| Obtención del identificador de cliente |
Devuelve el identificador de cliente al autor de la llamada. |
| Obtener créditos |
Devuelve el número de créditos disponibles actualmente en la cuenta. |
| Obtener mensaje |
Recupere un mensaje registrado por el identificador del mensaje. |
| Obtener mensajes programados |
Devuelve una lista de mensajes programados desde su cuenta, que comprende los mensajes programados en los últimos 3 meses y los programados para enviarlos en el futuro. |
| Programación del lote |
Programa un lote de mensajes SMS que se enviarán en la fecha y hora especificada. |
| Recuperación de mensajes por lotes |
Recupere todos los mensajes de un lote con el identificador de lote especificado. |
Buscar mensajes
Recupere hasta 1000 mensajes que coincidan con los criterios de búsqueda.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
query
|
query | True |
Devoluciones
- response
- array of MessageResponse
Cancelar lote programado
Cancela un mensaje SMS programado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de Batch
|
batchid | True | string |
Identificador del lote que desea que se devuelva |
Devoluciones
- response
- CancelledMessageResponse
Cancelar mensaje programado
Cancela un mensaje SMS programado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
messageid | True | string |
Identificador del mensaje que desea que se devuelva |
Devoluciones
- response
- CancelledMessageResponse
Eliminar mensaje
Elimine el mensaje con el messageid coincidente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
messageid | True | string |
Identificador del mensaje que desea que se devuelva |
Devoluciones
- response
- DeletedMessageResponse
Enviar colección de mensajes
Envía una colección de mensajes SMS únicos. Los lotes pueden contener hasta 5000 mensajes a la vez.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
messages
|
messages | True |
Matriz de mensajes |
Devoluciones
- response
- BatchMessageResponse
Enviar mensaje flash
Envía un mensaje flash SMS, que aparece en la pantalla de bloqueo de los destinatarios.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Remitente
|
sender | True | string |
Remitente del mensaje. No debe tener más de 11 caracteres para caracteres alfanuméricos o 15 para los identificadores numéricos del remitente. No hay espacios ni caracteres especiales. |
|
Destino
|
destination | True | string |
Número de teléfono del destinatario |
|
Content
|
content | True | string |
Mensaje que se va a enviar al destinatario. El contenido puede tener hasta 1280 caracteres de longitud. Los mensajes de 160 caracteres o menos se cobran 1 crédito. Si el mensaje tiene más de 160 caracteres, se desglosará en fragmentos de 153 caracteres antes de enviarlos al teléfono del destinatario y se le cobrará 1 crédito por cada 153 caracteres. Los mensajes enviados a números registrados fuera del Reino Unido normalmente se cobrarán créditos dobles, pero para determinados países se pueden cobrar fracciones de créditos (por ejemplo, 2.5). Por favor póngase en contacto con nosotros para las tarifas de cada país. |
|
Dirección URL del informe de entrega
|
deliveryreporturl | string |
Dirección URL a la que deberíamos enviar post los informes para este mensaje. Si no se especifica ninguno, usaremos la dirección URL del informe de entrega global que ha configurado en la página de la cuenta. |
|
|
Programación
|
schedule | string |
Fecha en la que se va a enviar el mensaje. Esto solo lo usa el servicio message/schedule y se puede dejar vacío para otros servicios. |
|
|
Etiqueta
|
tag | string |
Una etiqueta de identificación para el mensaje, que puede usar para filtrar e informar sobre los mensajes que ha enviado más adelante. Ideal para campañas. Un máximo de 280 caracteres. |
|
|
TTL
|
ttl | number |
Número opcional de minutos antes de eliminar el informe de entrega. Optional. Omitir para evitar la eliminación del informe de entrega. |
|
|
Correo electrónico de respuesta
|
responseemail | array of string |
Lista opcional de direcciones de correo electrónico a las que reenviar las respuestas a este mensaje específico. Se requiere un número de respuesta de SMS Works para usar esta característica. |
|
|
Metadatos
|
Metadata | object | ||
|
Validez
|
validity | number |
Número opcional de minutos para intentar la entrega antes de que el mensaje esté marcado como EXPIRED. Optional. El valor predeterminado es 2880 minutos. |
Devoluciones
- response
- SendMessageResponse
Enviar un mensaje SMS
Envía un mensaje SMS basado en los parámetros.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Remitente
|
sender | True | string |
Remitente del mensaje. No debe tener más de 11 caracteres para caracteres alfanuméricos o 15 para los identificadores numéricos del remitente. No hay espacios ni caracteres especiales. |
|
Destino
|
destination | True | string |
Número de teléfono del destinatario |
|
Content
|
content | True | string |
Mensaje que se va a enviar al destinatario. El contenido puede tener hasta 1280 caracteres de longitud. Los mensajes de 160 caracteres o menos se cobran 1 crédito. Si el mensaje tiene más de 160 caracteres, se desglosará en fragmentos de 153 caracteres antes de enviarlos al teléfono del destinatario y se le cobrará 1 crédito por cada 153 caracteres. Los mensajes enviados a números registrados fuera del Reino Unido normalmente se cobrarán créditos dobles, pero para determinados países se pueden cobrar fracciones de créditos (por ejemplo, 2.5). Por favor póngase en contacto con nosotros para las tarifas de cada país. |
|
Dirección URL del informe de entrega
|
deliveryreporturl | string |
Dirección URL a la que deberíamos enviar post los informes para este mensaje. Si no se especifica ninguno, usaremos la dirección URL del informe de entrega global que ha configurado en la página de la cuenta. |
|
|
Programación
|
schedule | string |
Fecha en la que se va a enviar el mensaje. Esto solo lo usa el servicio message/schedule y se puede dejar vacío para otros servicios. |
|
|
Etiqueta
|
tag | string |
Una etiqueta de identificación para el mensaje, que puede usar para filtrar e informar sobre los mensajes que ha enviado más adelante. Ideal para campañas. Un máximo de 280 caracteres. |
|
|
TTL
|
ttl | number |
Número opcional de minutos antes de eliminar el informe de entrega. Optional. Omitir para evitar la eliminación del informe de entrega. |
|
|
Correo electrónico de respuesta
|
responseemail | array of string |
Lista opcional de direcciones de correo electrónico a las que reenviar las respuestas a este mensaje específico. Se requiere un número de respuesta de SMS Works para usar esta característica. |
|
|
Metadatos
|
Metadata | object | ||
|
Validez
|
validity | number |
Número opcional de minutos para intentar la entrega antes de que el mensaje esté marcado como EXPIRED. Optional. El valor predeterminado es 2880 minutos. |
Devoluciones
- response
- SendMessageResponse
Envío de lotes
Envíe un único mensaje SMS a varios destinatarios.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
smsMessage
|
smsMessage | True |
Propiedades del mensaje |
Devoluciones
- response
- BatchMessageResponse
Mensaje de programación
Programa un mensaje SMS que se enviará en la fecha y hora que especifique.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Remitente
|
sender | True | string |
Remitente del mensaje. No debe tener más de 11 caracteres para caracteres alfanuméricos o 15 para los identificadores numéricos del remitente. No hay espacios ni caracteres especiales. |
|
Destino
|
destination | True | string |
Número de teléfono del destinatario |
|
Content
|
content | True | string |
Mensaje que se va a enviar al destinatario. El contenido puede tener hasta 1280 caracteres de longitud. Los mensajes de 160 caracteres o menos se cobran 1 crédito. Si el mensaje tiene más de 160 caracteres, se desglosará en fragmentos de 153 caracteres antes de enviarlos al teléfono del destinatario y se le cobrará 1 crédito por cada 153 caracteres. Los mensajes enviados a números registrados fuera del Reino Unido normalmente se cobrarán créditos dobles, pero para determinados países se pueden cobrar fracciones de créditos (por ejemplo, 2.5). Por favor póngase en contacto con nosotros para las tarifas de cada país. |
|
Dirección URL del informe de entrega
|
deliveryreporturl | string |
Dirección URL a la que deberíamos enviar post los informes para este mensaje. Si no se especifica ninguno, usaremos la dirección URL del informe de entrega global que ha configurado en la página de la cuenta. |
|
|
Programación
|
schedule | string |
Fecha en la que se va a enviar el mensaje. Esto solo lo usa el servicio message/schedule y se puede dejar vacío para otros servicios. |
|
|
Etiqueta
|
tag | string |
Una etiqueta de identificación para el mensaje, que puede usar para filtrar e informar sobre los mensajes que ha enviado más adelante. Ideal para campañas. Un máximo de 280 caracteres. |
|
|
TTL
|
ttl | number |
Número opcional de minutos antes de eliminar el informe de entrega. Optional. Omitir para evitar la eliminación del informe de entrega. |
|
|
Correo electrónico de respuesta
|
responseemail | array of string |
Lista opcional de direcciones de correo electrónico a las que reenviar las respuestas a este mensaje específico. Se requiere un número de respuesta de SMS Works para usar esta característica. |
|
|
Metadatos
|
Metadata | object | ||
|
Validez
|
validity | number |
Número opcional de minutos para intentar la entrega antes de que el mensaje esté marcado como EXPIRED. Optional. El valor predeterminado es 2880 minutos. |
Devoluciones
- response
- array of ScheduledMessageResponse
Obtención de mensajes con errores
Recupere mensajes con errores que coincidan con los criterios de búsqueda.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
query
|
query | True |
Devoluciones
- response
- array of MessageResponse
Obtención de mensajes no leídos
Obtenga mensajes entrantes no leídos que coincidan con los criterios de búsqueda.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
query
|
query | True |
Devoluciones
- response
- array of MessageResponse
Obtención del identificador de cliente
Obtener créditos
Devuelve el número de créditos disponibles actualmente en la cuenta.
Devoluciones
- response
- CreditsResponse
Obtener mensaje
Recupere un mensaje registrado por el identificador del mensaje.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
messageid | True | string |
Identificador del mensaje que desea que se devuelva |
Devoluciones
- response
- MessageResponse
Obtener mensajes programados
Devuelve una lista de mensajes programados desde su cuenta, que comprende los mensajes programados en los últimos 3 meses y los programados para enviarlos en el futuro.
Devoluciones
detalles de un mensaje programado para enviarse en una fecha y hora especificadas
- response
- ScheduledMessagesResponse
Programación del lote
Programa un lote de mensajes SMS que se enviarán en la fecha y hora especificada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
smsMessage
|
smsMessage | True |
Propiedades del mensaje |
Devoluciones
- response
- ScheduledBatchResponse
Recuperación de mensajes por lotes
Recupere todos los mensajes de un lote con el identificador de lote especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de Batch
|
batchid | True | string |
Identificador del lote que desea que se devuelva |
Devoluciones
- response
- array of MessageResponse
Definiciones
TestResponse
CreditResponse
ScheduledMessagesResponse
detalles de un mensaje programado para enviarse en una fecha y hora especificadas
detalles de un mensaje programado para enviarse en una fecha y hora especificadas