Mensagia API - Changelog

1.14.6

Hemos habilitado el parámetro clean_non_gsm7_chars para que se pueda enviar opcionalmente en los siguientes endpoints y así poder borrar del mensaje a enviar todos los caracteres que no sean GSM7:

1.14.5

Hemos añadido 4 nuevos endpoints en el servicio de SMS, para consultar la información de los envíos simples y múltiples creados en tu cuenta:

1.14.2

Hemos cambiado el valor en la respuesta de app_configuration_id en el endpoint Envíos simples de email para que muestre el ID de configuración en lugar del ID de envío simple de email.

1.14.1

Hemos habilitado el envío de la interacción que tienen tus contactos con los envíos de Email a través de los siguientes callbacks:

Aperturas: Recibirás un callback cada vez que un contacto realice una apertura del email que le hayas enviado. Para usar esta opción, envía el parámetro callback_openings_url. Más información en Callback URL para notificar las aperturas de envíos de Email.
Clics: Recibirás un callback cada vez que un contacto realice un clic en alguno de los enlaces del email que le hayas enviado. Para usar esta opción, envía el parámetro callback_clicks_url. Más información en Callback URL para notificar los clics en los enlaces de envíos de Email.
Reportes SPAM: Recibirás un callback cada vez que recibamos una queja de SPAM del dominio del remitente del envío realizado. Para usar esta opción, envía el parámetro callback_complains_url. Más información en Callback URL para notificar los reportes de SPAM de los usuarios.

1.13.3

Hemos habilitado el envío de notificaciones de entrega a través de un callback en los envíos de email. Para usar esta opción, envía el parámetro callback_url. Más información en Callback URL para las notificaciones de entrega.
Hemos habilitado el envío de información de la certificación de una comunicación (SMS o Email) a través de un callback. Para usar esta opción, debes certificar la comunicación (certified=1) y envíar el parámetro certification_callback_url con una URL válida donde recogerás dicha información. Más información en Obtener certificados a través de un callback a una URL.

1.13.2

Hemos habilitado el poder escoger los días de envío al crear una campaña de email (menos cuando el plan_name = all_at_once)

1.13.1

Añadido nuevo grupo 'Envíos certificados' para poder obtener los certificados generados en tus envíos certificados de SMS y Email:

1.13.0

Hemos habilitado los envíos certificados para SMS y Email

Hemos añadido el parámetro certified en los envíos de SMS y Email para que puedas certificar tus comunicaciones

1.12.1

Hemos habilitado la autentificación con Token fijo a través de los headers de la petición. Cómo autentificarse en la API

1.11.8

Hemos añadido dos nuevos endpoints para el servicio de Voz:

1.11.7

A partir de ahora puedes acortar enlaces para tus envíos. Hemos añadido 2 nuevos endpoints para la administración de enlaces acortados:

1.11.5

A partir de ahora, puedes envíar un ID de plantilla de email para usarlas en tus envíos de emails simples y campañas de email a través de la API.
Actualización interna
Actualización dependencias

1.11.4

A partir de ahora, los envíos simples de email enviados a determinados dominios contarán con una limitación para evitar el SPAM y problemas de reputación de las IP's asociadas al envío.
Actualización interna
Actualización dependencias

1.11.3

Se ha añadido api_token como forma de autentificación. Más información en: Como autentificarse en la API.
Actualización interna
Actualización dependencias

1.11.2

Actualización interna
Actualización dependencias

1.11.1

Actualización interna
Actualización dependencias

1.11.0

Actualización interna
Actualización dependencias

1.10.5

Actualización interna
Actualización dependencias

1.10.4

Se ha añadido el campo obligatario plan_name a Crear una campaña de email.

1.10.3

Se han añadido comprobaciones internas para los endpoints de Email para tener en cuenta si un dominio está desactivado.

1.10.2

Se ha actualizado la política de cookies.

1.10.1

Se ha actualizado el diseño de la documentación de la API.

1.10.0

Añadido nuevo grupo 'Email'

Nuevo método 'Obtener notificaciones de entrega de email'

[GET] Obtener notificaciones de entrega de email

Se ha cambiado la URL para el método Obtener notificaciones de entrega SMS

La nueva url es: https://api.mensagia.com/docs/v1/reports/push/delivery
La antigua url https://api.mensagia.com/docs/v1/reports/delivery se mantiene activa como un alias.

1.9.0

Se han añadido un parámetro nuevo para los Envíos SMS

Se ha añadido el parametro url_extrafields_mode por si incluyes enlaces acortados o landings en tus envíos, poder escoger que valor mostrarán los campos personalizados cuando el destinatario visualice el contenido..

Actualización interna
Actualización dependencias

1.7.10

Actualización interna del método Importar contactos mediante JSON

1.7.9

Se ha añadido más información en la respuesta del método Obtener una campaña referente a PACKS.

En reports_to_send:

Se ha añadido el parametro total_price_to_send_using_packs que hace referencia al precio total del envío si se usan los mensajes disponibles en tus PACKS en este envío.
Se ha añadido el parametro total_messages_to_send_using_packs que hace referencia al total de mensajes que se utilizarán de tus PACKS si se pueden usar en este envío.
En el listado de mensajes a enviar por países hemos añadido:

messages_to_send_using_packs que hace referencia al total de mensajes por cada país que podrían usarse de tus PACKS en este envío
price_using_packsque hace referencia al preció del envío por cada país si se pueden usar los mensajes disponibles de tus PACKS en este envío.

En reports_sent:

Se ha añadido el parametro total_messages_sent_using_packs que hace referencia al total de mensajes que se han utilizado de tus PACKS.
En el listado de mensajes enviados por países hemos añadido:

messages_sent_using_packs que hace referencia al total de mensajes que se han utilizado de tus PACKS para cada país.
pack_id El ID del pack utilizado.

Se ha añadido más información en la respuesta del método Simulador de coste de campaña referente a PACKS.

En reports_to_send:

Se ha añadido el parametro total_price_to_send_using_packs que hace referencia al precio total del envío si se usan los mensajes disponibles en tus PACKS en este envío.
Se ha añadido el parametro total_messages_to_send_using_packs que hace referencia al total de mensajes que se utilizarán de tus PACKS si se pueden usar en este envío.
En el listado de mensajes a enviar por países hemos añadido:

messages_to_send_using_packs que hace referencia al total de mensajes por cada país que podrían usarse de tus PACKS en este envío
price_using_packsque hace referencia al preció del envío por cada país si se pueden usar los mensajes disponibles de tus PACKS en este envío.

Se ha añadido más información en la respuesta del método Envío Simple referente a PACKS.

Se ha añadido el parametro price_with_packs que hace referencia al precio total del envío si se usan los mensajes disponibles en tus PACKS en este envío.
Se ha añadido el parametro total_messages_sent_with_packs que hace referencia al total de mensajes que se utilizarán de tus PACKS si se pueden usar en este envío.

Se ha añadido más información en la respuesta del método Envío Múltiple referente a PACKS.

Se ha añadido el parametro price_with_packs que hace referencia al precio total del envío si se usan los mensajes disponibles en tus PACKS en este envío.
Se ha añadido el parametro total_messages_sent_with_packs que hace referencia al total de mensajes que se utilizarán de tus PACKS si se pueden usar en este envío.

Actualización interna

v1.7.7

Añadidos métodos internos para la monitorización de la API

v1.7.6

Se ha corregido el resultado del atributo reports_to_send en las respuestas del método Obtener una campaña.

v1.7.5

Se ha añadido el parámetro language para Contactos.
Se han modificado los caracteres válidos del campo nombre en Crear un campo personalizado.

Solo se permiten letras, números y el guión bajo.
Todos los demás caracteres serán substituidos por un guión bajo cuando se guarde el nuevo campo personalizado.
El nombre se guardará con todos sus caracteres en minúscula.

Actualización interna API.

v1.7.4

Nuevo método para VOZ para obtener el desglose de llamadas en Obtener Desglose de llamadas.

v1.7.3

Nuevos filtros de búsqueda a partir de campos personalizados en Obtener Notificaciones de entrega.

extra_field_name
extra_field_value

v1.7.2

Actualización interna API.
Corrección de errores.

v1.7.1

Actualización interna API.
Corrección de errores.

El cambio más importante en esta versíon es la eliminación de la Lista Negra de SMS como agenda y el traspaso de esta información a nivel de contacto. Estos cambios solo te afectan si gestionas la Lista Negra de SMS a través de la API.

Cambios en agendas

Se ha cambiado la gestión de la Lista Negra de SMS. A partir de ahora, no se utilizará una agenda para los contactos que no deseen recibir más SMS, si no que pasa a ser una propiedad del contacto.
Se ha traspado la información de la Agenda Lista Negra SMS a información de contacto.
Se ha eliminado la Agenda Lista Negra de todas las cuentas.

Cambios en contactos

Se ha añadido 3 nuevos parametros en contactos para la gestión de Listas Negras. Una lista por cada uno de nuestros servicios:

in_sms_blacklist (boolean)
in_voice_blacklist (boolean)
in_mail_blacklist (boolean)

Cambios en importaciones

Añadido nuevo parámetro priority_field en importaciones por archivo y JSON. Con este nuevo parámetro puedes indicar el campo principal (número o email) que se usará para buscar si existe o no el contacto durante la importación. Este parámetro es útil para importar bases de datos en las que sea más importante el email que el número de teléfono en un contacto.

v1.6.1

Nuevo modo mantenimiento

v1.6.0

Actualización interna API.
Corrección de errores.

v1.5.0

Restructuración interna.
Corrección de errores.
Mejoras notables en velocidad.

v1.4.2

Cambios en servicio 'VOZ'

[POST] Campañas de voz ahora admite programar el tiempo que se debe esperar para realizar cada uno de los reintentos.

Corrección de errores.

v1.4.1

Corrección de errores.

v1.4.0

Añadido nuevo servicio 'Premium'

[POST] Premium Gateway

Corrección de errores.

v1.3.1

Mejoras en la validacíon de números internacionales
Corrección de errores.
Mejoras notables en velocidad.

v1.3.0

Añadido nuevo servicio 'VOZ'

[POST] Campañas de voz

Corrección de errores.

v1.2.5

Nueva funcionalidad: Envío simple programable

Ahora puedes programar con fecha y hora tus envíos simples

v1.2.4

Corrección de errores.
Mejoras notables en velocidad.
Añadidos nuevos controles internos.

v1.2.3

Se ha habilitado el soporte de Emojis desde la API

v1.2.2

Añadido nuevo grupo '2-Factor Authentication'

v1.2.1

Corrección de errores.
Mejoras notables en velocidad.

v1.2.0

Actualización interna API.
Arreglos en documentación.
Corrección de errores.
Mejoras notables en velocidad.

v1.1.21

Añadido nuevo grupo 'Configuraciones de envío'

Mejoras en la documentación.

v1.1.20

Se han implementado nuevos métodos en el grupo 'Procesos'

Se ha implementado la búsqueda por nombre en los siguientes métodos:

Se ha implementado el parámetro search_type para búsquedas de parámetros de tipo string que permite buscar por búsqueda exacta o que contenga el valor envíado. Se ha implementado en los siguientes métodos:

Arreglos en documentación.
Corrección de errores.
Mejoras en velocidad.

v1.1.19

Actualización interna API.
Arreglos en documentación.
Corrección de errores.
Mejoras en velocidad.

v1.1.18

Añadidos dos nuevos filtros de búsqueda para Obtener todas las compras de saldo

finish_date_min: buscar compras de saldo que su fecha de finalización sea más grande o igual que el valor de finish_date_min.
finish_date_max: buscar compras de saldo que su fecha de finalización sea más pequeña o igual al valor de finish_date_max.

v1.1.17

Las importaciones de contactos a través de fichero y las campañas a través de fichero ahora aceptan también archivos .txt

v1.1.16

Implementación de Marcas Blancas

v1.1.15

Actualización interna API.
Arreglos en documentación.
Corrección de errores.
Mejoras en velocidad.

v1.1.14

Implementados nuevos servicios de facturación.
Actualización interna API.
Arreglos en documentación.
Corrección de errores.
Mejoras en velocidad.

v1.1.13

Actualización interna API.
Arreglos en documentación.
Corrección de errores.
Mejoras en velocidad.

v1.1.12

Actualización interna API.
Arreglos en documentación.
Corrección de errores.
Mejoras en velocidad.

v1.1.11

Nuevo método para el grupo 'Contactos'.

Importar contactos mediante archivo. Nuevo método para importar contactos a través de API. Este método es el más eficiente y rápido para importar contactos.

v1.1.10

Nuevos métodos para el grupo 'Saldo'.

v1.1.9

Actualización interna API.
Arreglos en documentación.
Corrección de errores.
Mejoras en velocidad.

v1.1.8

Añadido dos nuevos métodos en el grupo 'Campañas'.

v1.1.7

Añadido nuevo grupo 'Procesos'. Estos métodos son útiles para comprobar el estado de importaciones que se realizan en segunda plano en tu cuenta.

[GET] Obtener todas los procesos
[GET] Obtener un proceso
[DELETE] Eliminar un proceso

Implementados cambios en Campañas para poder obtener información de las nuevas campañas a través de fichero:

Añadido atributo origin cuyos valores pueden ser:

from_agenda (string): Es una campaña normal a través de agendas
from_file (string): Es una campaña a través de fichero

Añadido atributo filename cuyo valor será el nombre del archivo de contactos que usaste para crear la campaña a través de archivo (string). Para campañas normales a través de agenda el valor de este campo será "" (string vacío)
Añadido atributo need_approval cuyos valores pueden ser:

true (boolean): La campaña a través de fichero necesita aprobación despues de procesar el archivo de contactos.
false (boolean): La campaña a través de fichero no necesita aprobación despues de procesar el archivo de contactos.

El atributo groups en campañas a través de fichero será [ ] (un array vacío)
El atributo message en campañas a través de fichero será "" (string vacío)
Para más información sobre esta nueva funcionalidad, visita la documentación de Envíos masivos (Campañas) a través de fichero

v1.1.6

Se ha reemplazado el método 'Crear contactos masivamente' (/contacts/massive) del grupo 'Contactos' creado en v1.1.5 por 'Importar contactos mediante JSON' (/contacts/import/json). Este método es asíncrono, permite multiples importaciones simultáneas y mejora la velocidad de importación notablemente.

v1.1.5

Añadido nuevo método 'Crear contactos masivamente' (/contacts/massive) del grupo 'Contactos'.

v1.1.4

Añadido aviso de cookies
Cambios en diseño página principal
Corrección de errores y optimización de velocidad de la API.

v1.1.3

Añadido nuevo método 'Obtener URL Formulario de Baja' (/tools/unsubscribe_url) del grupo 'Herramientas'.

v1.1.2

[DEPRECATED] configuration_id en respuestas de envíos y métodos de campañas. A partir de ahora, debe usarse id en su lugar.

El dia 15 de febrero de 2017 será eliminado definitivamente.

Los métodos afectados son los siguientes:

Envío Simple
Envío Múltiple
Envío Masivo - Campañas
Obtener todas las campañas
Obtener una campaña
Crear una campaña
Activar una campaña
Desactivar una campaña
Enviar ahora

v1.1.1

Añadido nuevo grupo 'Envío Másivo - Campañas'

[GET] Obtener todas las campañas
[GET] Obtener una campaña
[POST] Crear una campaña
[POST] Activar una campaña
[POST] Desactivar una campaña
[POST] Enviar ahora
[DELETE] Eliminar una campaña
[POST] Simulador de coste de campaña

Se ha eliminado el método 'Información de Campaña' (/push/campaigns/{campaign_id}/info) del grupo 'Envíos SMS'. Ahora debe utilizarse el método 'Obtener una campaña' (/campaigns/{id}) del nuevo grupo 'Envio Masivo - Campañas'.
Se ha eliminado el método 'Simulador de coste de campaña' (/push/campaigns/cost_simulator) del grupo 'Envíos SMS'. Ahora debe utilizarse el método 'Simulador de coste de campaña' (/campaigns/cost_simulator) del nuevo grupo 'Envio Masivo - Campañas'.
Normalizadas respuestas en Campañas. Todas las respuestas siguen la misma estructura. Se han añadido nuevos campos: