Compartir a través de


Mensagia (versión preliminar)

Mensagia ofrece mensajes de SMS, correo electrónico y voz confiables para la comunicación de automatización empresarial.

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 Mensagia
URL https://mensagia.com/
Correo Electrónico support@mensagia.com
Metadatos del conector
Publicador Mensagia
Sitio web https://mensagia.com/
Directiva de privacidad https://mensagia.com/legal#privacidad
Categorías Communication

Mensagia ofrece mensajes de SMS, correo electrónico y voz confiables para la comunicación de automatización empresarial.

Prerrequisitos

Necesitará lo siguiente para continuar:

  • Una cuenta de "cliente de API" de Mensagia.
  • Asegúrese de que tiene suficiente saldo en su cuenta de Mensagia.

Obtención de credenciales

La clave de API se puede obtener escribiendo el portal de la cuenta de Mensagia.

Introducción al conector

Problemas y limitaciones conocidos

Los métodos GET no permiten parámetros.

Errores y soluciones comunes

No hay errores y remedios de coma.

Preguntas más frecuentes

Por favor , cotact nosotros si tiene alguna pregunta.

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 de API securestring Clave de API para esta API. Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Crear un contacto

Cree un contacto dentro de la cuenta de Mensagia.

Enviar campañas SMS

Envía campañas SMS a tus contactos a través de tu cuenta de Mensagia.

Enviar correo electrónico transaccional

Envíe un correo electrónico transaccional a sus contactos mediante las plantillas personalizadas de Mensagia.

Enviar mensaje de voz

Este método le permite llevar a cabo campañas de voz en números de teléfono en España. Los destinatarios de la campaña de voz pueden ser: agendas, agendas y números de teléfono, o números de teléfono.

Envío de SMS

Envía SMS a tus contactos a través de tu cuenta de Mensagia.

Envío de SMS de 2 vías

Envía un SMS de 2 vías a tus contactos a través de tu cuenta de Mensagia.

Obtener 2 números de SMS de la forma

Obtenga una lista de los números de 2 Way SMS a través de su cuenta de Mensagia.

Obtener SMS de 2 vías

Obtenga una lista de 2 sms de 2 vías a través de su cuenta de Mensagia.

Crear un contacto

Cree un contacto dentro de la cuenta de Mensagia.

Parámetros

Nombre Clave Requerido Tipo Description
Está en la lista negra de correo
in_mail_blacklist boolean

Especifique si el contacto está en la lista negra Correo electrónico.

Está en la lista negra de SMS
in_sms_blacklist boolean

Especifique si el contacto está en in_voice_blacklist.

Está en la lista negra de voz
in_voice_blacklist boolean

Especifique si el contacto está en la lista negra voz.

Number
number True string

Número móvil del contacto sin espacios en blanco, con el prefijo internacional y sin el signo + .

Nombre
name string

Nombre del contacto en Mensagia.

Correo Electrónico
email True string

Póngase en contacto con el correo electrónico dentro de Mensagia.

City
city string

Ubicación del contacto.

Language
language string

Idioma del contacto en el código ISO.

Agenda
groups string

Agregar su contacto a una libreta de direcciones

Devoluciones

Nombre Ruta de acceso Tipo Description
ID de contacto
data.id integer

Id. de contacto en Mensagia

Número de teléfono de contacto
data.number string

Número del contacto

Operador push
data.push_operator_destination_id string

Destino del operador push del contacto

Nombre de contacto
data.name string

Nombre del contacto

Correo electrónico de contacto
data.email string

Correo electrónico del contacto

Ubicación de contacto
data.city string

Ubicación del contacto

Idioma de contacto
data.language string

Idioma del contacto

País de contacto
data.country_id integer

Id. de país del contacto

Nombre del país
data.country_name string

Nombre del país del contacto

Está en la lista negra de SMS
data.in_sms_blacklist boolean

Determina si el contacto está en la lista negra de SMS.

Está en la lista negra de voz
data.in_voice_blacklist boolean

Determina si el contacto está en la lista negra de voz

Está en la lista negra de correo electrónico
data.in_mail_blacklist boolean

Determina si el contacto está en la lista negra de correo electrónico.

Creado en
data.created_at string

Contacto creado en

Actualizado en
data.updated_at string

Contacto actualizado en

datos
data.groups.data array of object

datos

Identificador de grupo
data.groups.data.id integer

Identificador de grupo

Nombre de grupo
data.groups.data.name string

Nombre de grupo

Usuarios del grupo total
data.groups.data.total_users integer

Usuarios del grupo total

El grupo está ocupado
data.groups.data.busy integer

El grupo está ocupado

Grupo creado en
data.groups.data.created_at string

Grupo creado en

Grupo actualizado en
data.groups.data.updated_at string

Grupo actualizado en

Enviar campañas SMS

Envía campañas SMS a tus contactos a través de tu cuenta de Mensagia.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de configuración
configuration_name True string

Seleccione el nombre que aparecerá en el encabezado del SMS.

Message
message True string

Texto que se va a enviar (no más de 160 caracteres).

Nombre de la campaña
name string

Nombre de la campaña

Grupo disponible
available_groups True string

Asigne el grupo al que se dirigirá la campaña.

Fecha de inicio
start_date date-time

Fecha de envío con el formato "AAAA-MM-DD hh:mm". Si no especifica este parámetro, el mensaje se enviará inmediatamente.

Llamadas por bloque
smsxblock integer

Número de destinatarios por bloque. Obligatorio en presencia de "Minutos por bloque". Si se envían los dos parámetros, la configuración de la campaña se define como "configuración personalizada" y se considerará el valor de los parámetros "Days" y "Time Intervals".

Minutos por bloque
minutesxblock integer

Cada pocos minutos se enviará el bloque de destinatarios elegidos en "Llamadas por bloque". Obligatorio en presencia de "Llamadas por bloque". Si se envían los dos parámetros, la configuración de la campaña se define como "configuración personalizada" y se considerará el valor de los parámetros "Days" y "Time Intervals".

Días
days string

Lista de días de la semana separados por comas y sin espacios en los que se pueden realizar llamadas. (1,2,3,4,5,6,7)

Intervalos de tiempo
time_intervals string

Lista de intervalos de tiempo separados por comas y sin espacios, en la que se puede enviar la llamada. Solo se tendrá en cuenta si se envían 'Minutos por bloque' y 'Llamadas por bloque'.(hh:mm-hh:mm,hh:mm-hh:mm...)

URL Paremeters
url_parameters string

Etiquetado de vínculos si hay un vínculo abreviado, Aterrizaje o Formulario en el mensaje.

Modo extracampos de url
url_extrafields_mode string

Si incluye vínculos o aterrizajes abreviados en los envíos, puede elegir qué valor mostrarán los campos personalizados cuando el destinatario vea el contenido.

Devoluciones

Nombre Ruta de acceso Tipo Description
Identificador de configuración
data.configuration_id integer

Enviar identificador de encabezado

Id. de mensaje
data.id integer

Id. de mensaje

Nombre del mensaje
data.name string

Nombre del mensaje

Cuerpo del mensaje
data.message string

Cuerpo del mensaje

Precio
data.price float

Precio del mensaje

Precio con packs
data.price_with_packs float

Precio con paquetes

Encabezado del remitente
data.push_sender_name string

Nombre del remitente de inserción

Nombre de ruta
data.route_name string

Nombre de ruta

Mensajes enviados
data.total_messages_sent integer

Total de mensajes enviados

Paquetes enviados de mensajes
data.total_messages_sent_with_packs integer

Total de mensajes enviados con paquetes

dlrs
data.dlrs array of object

dlrs

Id. de mensaje
data.dlrs.message_id string

Id. de mensaje

Para número
data.dlrs.number string

Número del receptor

Mensajes enviados
data.dlrs.messages_sent integer

Número total de mensajes al número

Está en la lista negra de SMS
data.dlrs.in_SMS_blacklist boolean

Determina si el contacto está en la lista negra de SMS.

Dirección URL de devolución de llamadas
data.callback_url string

Dirección URL de devolución de llamadas

Fecha de inicio
data.start_date string

Fecha de inicio

Enviar correo electrónico transaccional

Envíe un correo electrónico transaccional a sus contactos mediante las plantillas personalizadas de Mensagia.

Parámetros

Nombre Clave Requerido Tipo Description
De
from True string

Una dirección de correo electrónico que actuará como remitente. Debe ser una dirección de envío creada en la plataforma o una dirección de envío con un dominio validado y autenticado en la plataforma.

Nombre del remitente
from_name string

Envíe este campo si desea usar un nombre de remitente diferente al almacenado en una dirección de envío en la plataforma si usará uno que ya se haya creado.

Para
to True string

Dirección de correo electrónico a la que se realiza el envío.

Asunto
subject True string

Asunto que se va a enviar.

HTML
html string

HTML que se va a enviar. Obligatorio sin parámetro Template.

Template
template_id integer

Puede usar una plantilla de correo electrónico configurada en su cuenta de Mensagia para obtener el código HTML para el envío. Si se envía este parámetro, se omitirá el parámetro HTML.

Enviar en
start_date string

Fecha de envío con el formato "AAAA-MM-DD hh:mm". Si no envía este parámetro, el envío se realizará inmediatamente.

Parámetros de dirección URL
url_parameters string

Etiquetado de vínculos en el contenido del correo electrónico.

Attachments
attachments string

Lista separada por comas de direcciones URL con los archivos que se van a adjuntar. Puede adjuntar hasta 5M en archivos.

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. de App Configuration
data.app_configuration_id integer

Id. de App Configuration

Fecha de inicio
data.start_date string

Fecha de inicio

Identificador de dominio
data.domain_id integer

Identificador del dominio registrado desde el que se envía el correo.

Id. de dirección del remitente
data.sender_address_id integer

Id. de dirección del remitente

De
data.from string

Remitente del mensaje.

Nombre del remitente
data.from_name string

Nombre de la persona que envía el mensaje.

Correos electrónicos válidos
data.to.valids array of string

Correos electrónicos válidos,

Correos electrónicos descartados
data.to.discardeds array of string

Correos electrónicos descartados,

Correos electrónicos en la lista negra
data.to.blacklisteds array of string

Está en la lista negra

Asunto
data.subject string

Asunto de su correo electrónico.

attachments
data.attachments array of string

attachments

Enviar mensaje de voz

Este método le permite llevar a cabo campañas de voz en números de teléfono en España. Los destinatarios de la campaña de voz pueden ser: agendas, agendas y números de teléfono, o números de teléfono.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
name True string

Nombre de la nueva campaña de voz.

Teléfono validado
vm_validated_phone_id True integer

Teléfono que se usará en esta campaña de voz.

Locución de tipo
type True string

Tipo de voz que se usará en esta campaña de voz.

Message
message string

Texto que se va a sintetizar para reproducirse en la llamada. Campo obligatorio si text2speech es el tipo de voz elegido.

Idioma del mensaje
message_language string

Código del idioma con el que desea sintetizar el texto que se reproducirá en la llamada. Campo obligatorio si text2speech es el tipo de voz elegido.

Archivo de voz
voice_file_id string

Archivo de biblioteca de audio que se usará como voz. Campo obligatorio si el archivo es el tipo de voz elegido.

Numbers
numbers string

Lista de números de teléfono separados por comas, sin espacios y con el prefijo internacional.

Grupos disponibles
available_groups string

Lista de contactos a los que se enviará la campaña.

Tiempo de espera de llamada
vm_timeout integer

Duración máxima de la llamada en minutos.

Número máximo de reintentos
max_retries integer

Número de reintentos que se deben realizar si el destinatario de la llamada no responde.

Minutos en el reintento 1
minutes_retry_1 integer

Intervalo en minutos en los que el primer reintento se realizará después de que no se responda a la primera llamada. Este campo es obligatorio si "Número máximo de reintentos" es mayor que 1.

Minutos en el reintento 2
minutes_retry_2 integer

Intervalo en minutos en los que el primer reintento se realizará después de que no se responda a la primera llamada. Este campo es obligatorio si "Número máximo de reintentos" es mayor que 2.

Minutos en reintento 3
minutes_retry_3 integer

Intervalo en minutos en los que el primer reintento se realizará después de que no se responda a la primera llamada. Este campo es obligatorio si "Número máximo de reintentos" es mayor que 3.

Minutos en reintento 4
minutes_retry_4 integer

Intervalo en minutos en los que el primer reintento se realizará después de que no se responda a la primera llamada. Este campo es obligatorio si "Reintentos máximos" es mayor que 4.

Tiempo de espera de anillo
ring_timeout integer

Tiempo en segundos en el que el teléfono del destinatario te llamará para recoger la llamada.

Códigos de respuesta
response_codes string

(JSON) Códigos de respuesta que puede presionar el destinatario que generará una acción en la llamada.

Tiempo de espera de códigos de respuesta
response_codes_timeout integer

Tiempo en segundos en el que el destinatario podrá presionar un código de respuesta. Este campo es obligatorio en presencia de "Códigos de respuesta".

Fecha de inicio
start_date string

Fecha de inicio de la campaña con el formato "AAAA-MM-DD hh:mm". Si no envía este parámetro, la campaña comenzará dos minutos después de la creación de la nueva campaña.

Llamadas por bloque
callsxblock integer

Número de destinatarios por bloque. Obligatorio en presencia de "Minutos por bloque". Si se envían los dos parámetros, la configuración de la campaña se define como "configuración personalizada" y se considerará el valor de los parámetros "Days" y "Time Intervals".

Minutos por bloque
minutesxblock integer

Cada pocos minutos se enviará el bloque de destinatarios elegidos en "Llamadas por bloque". Obligatorio en presencia de "Llamadas por bloque". Si se envían los dos parámetros, la configuración de la campaña se define como "configuración personalizada" y se considerará el valor de los parámetros "Days" y "Time Intervals".

Días
days integer

Lista de días de la semana separados por comas y sin espacios en los que se pueden realizar llamadas. (1,2,3,4,5,6,7)

Intervalos de tiempo
time_intervals string

Lista de intervalos de tiempo separados por comas y sin espacios, en la que se puede enviar la llamada. Solo se tendrá en cuenta si se envían 'Minutos por bloque' y 'Llamadas por bloque'.(hh:mm-hh:mm,hh:mm-hh:mm...)

Devoluciones

Nombre Ruta de acceso Tipo Description
Nombre del remitente
data.configuration_id integer

Nombre del encabezado del remitente

Identificador de campaña de voz
data.id integer

Identificador de campaña de voz

Nombre de la campaña de voz
data.name string

Nombre de la campaña de Voz

Is Campaign Active
data.active integer

Determina si la campaña está activa actualmente

Id. de estado
data.state_id integer

Determina la identificación del estado de envío

Estado
data.state_name string

Nombre de estado

Mensaje de voz
data.message string

Cuerpo del mensaje enviado

Fecha de inicio
data.start_date string

Fecha programada para el envío

Id. de teléfono validado
data.vm_validated_phone_id integer

Identificador de teléfono validado para enviar la campaña

Número de teléfono validado
data.vm_validated_phone_number string

Número de teléfono validado

Agendas
data.groups array of object

Agendas a las que se dirige la campaña.

Id. de agenda
data.groups.id integer

Identificador de grupo

Nombre de la agenda
data.groups.name string

Nombre de la agenda

Numbers
data.numbers string

Números a los que se dirige la campaña.

Timeout
data.vm_timeout integer

Tiempo de espera de la llamada

Número máximo de reintentos
data.max_retries integer

Número máximo de reintentos de la llamada

Minutos mínimos de reintentos
data.min_retry_minutes integer

Intervalo mínimo de minutos para esperar hasta el siguiente intento.

Número máximo de minutos de reintentos
data.max_retry_minutes integer

Intervalo máximo de minutos para esperar hasta el siguiente intento.

Códigos de respuesta
data.response_codes array of object

Códigos de respuesta asignados a la llamada.

Código
data.response_codes.code string

Nombre del código

Acción
data.response_codes.action string

Acción del código

Transferir a
data.response_codes.transfer_to string

Especifica el número al que se redirigirá la llamada si es necesario.

Id. de teléfono validado
data.response_codes.vm_validated_phone_id string

Identificador de teléfono validado

Tiempo de espera de códigos de respuesta
data.response_codes_timeout string

Tiempo de espera de códigos de respuesta

Dirección URL de devolución de llamadas
data.callback_url string

Dirección URL de devolución de llamada

Tipo
data.type string

Tipo de llamada

Llamadas por bloque
data.callsxblock integer

Llamadas por bloque

Minutos por bloque
data.minutesxblock integer

Minutos por bloque

Días permitidos
data.days_allowed array of string

Días permitidos para enviar la campaña de voz,

Intervalos de tiempo permitidos
data.time_intervals_allowed array of string

Intervalos de tiempo permitidos para enviar la campaña de voz,

Tiempo de espera del anillo de voz
data.ring_timeout integer

Tiempo máximo en el que el anillo de llamada sonará hasta que se complete el intento.

Envío de SMS

Envía SMS a tus contactos a través de tu cuenta de Mensagia.

Parámetros

Nombre Clave Requerido Tipo Description
Nombre de configuración
configuration_name True string

Seleccione el nombre que aparecerá en el encabezado del SMS.

Message
message True string

Texto que se va a enviar (no más de 160 caracteres).

Numbers
numbers True string

Número de móvil del destinatario de este mensaje. IMPORTANTE: El número debe tener el prefijo de país correspondiente.

Fecha de inicio
start_date string

Fecha de envío con el formato "AAAA-MM-DD hh:mm". Si no especifica este parámetro, el mensaje se enviará inmediatamente.

URL Paremeters
url_parameters string

Etiquetado de vínculos si hay un vínculo abreviado, Aterrizaje o Formulario en el mensaje.

Modo extracampos de url
url_extrafields_mode string

Si incluye vínculos o aterrizajes abreviados en los envíos, puede elegir qué valor mostrarán los campos personalizados cuando el destinatario vea el contenido.

Devoluciones

Nombre Ruta de acceso Tipo Description
Identificador de configuración
data.configuration_id integer

Enviar identificador de encabezado

Id. de mensaje
data.id integer

Id. de mensaje

Nombre del mensaje
data.name string

Nombre del mensaje

Cuerpo del mensaje
data.message string

Cuerpo del mensaje

Precio
data.price float

Precio del mensaje

Precio con packs
data.price_with_packs float

Precio con paquetes

Encabezado del remitente
data.push_sender_name string

Nombre del remitente de inserción

Nombre de ruta
data.route_name string

Nombre de ruta

Mensajes enviados
data.total_messages_sent integer

Total de mensajes enviados

Paquetes enviados de mensajes
data.total_messages_sent_with_packs integer

Total de mensajes enviados con paquetes

dlrs
data.dlrs array of object

dlrs

Id. de mensaje
data.dlrs.message_id string

Id. de mensaje

Para número
data.dlrs.number string

Número del receptor

Mensajes enviados
data.dlrs.messages_sent integer

Número total de mensajes al número

Está en la lista negra de SMS
data.dlrs.in_SMS_blacklist boolean

Determina si el contacto está en la lista negra de SMS.

Dirección URL de devolución de llamadas
data.callback_url string

Dirección URL de devolución de llamadas

Fecha de inicio
data.start_date string

Fecha de inicio

Envío de SMS de 2 vías

Envía un SMS de 2 vías a tus contactos a través de tu cuenta de Mensagia.

Parámetros

Nombre Clave Requerido Tipo Description
Number
number True string

Número 2 SMS de la forma en que se va a enviar el mensaje

Para número
enduser_number True string

Número del receptor

Message
message True string

Texto que se va a enviar (no más de 160 caracteres).

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. de mensaje
id integer

Id. de mensaje

Id. de solicitud
application_id string

Id. de solicitud

Identificador de configuración
configuration_id integer

Enviar identificador de encabezado

Number
number string

Number

Tipo
type string

Tipo de SMS (MO o MT)

Para número
enduser_number string

Número del receptor

Cuerpo del mensaje
message string

Cuerpo del mensaje

Creado en
created_at string

Creado en

Obtener 2 números de SMS de la forma

Obtenga una lista de los números de 2 Way SMS a través de su cuenta de Mensagia.

Devoluciones

Nombre Ruta de acceso Tipo Description
datos
data array of object
Id. de mensaje
data.id integer

Id. de mensaje

Number
data.number string

Number

Dirección URL de devolución de llamadas
data.callback_url string

Dirección URL de devolución de llamadas

Creado en
data.created_at string

Creado en

Total
meta.pagination.total integer

Total

Contar
meta.pagination.count integer

Contar

Por página
meta.pagination.per_page integer

Resultados por página

Página actual
meta.pagination.current_page integer

Página actual

Total de páginas
meta.pagination.total_pages integer

Total de páginas

Enlaces
meta.pagination.links array of string

Enlaces

Obtener SMS de 2 vías

Obtenga una lista de 2 sms de 2 vías a través de su cuenta de Mensagia.

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. de mensaje
id integer

Id. de mensaje

Id. de solicitud
application_id string

Id. de solicitud

Identificador de configuración
configuration_id integer

Enviar identificador de encabezado

Number
number string

Number

Tipo
type string

Tipo de SMS (MO o MT)

Para número
enduser_number string

Número del receptor

Cuerpo del mensaje
message string

Cuerpo del mensaje

Creado en
created_at string

Creado en