Consultel API Changelog
1.14.7
- Hemos habilitado el parámetro
concat_multiple_messages
para que se pueda enviar opcionalmente en el siguiente endpoint y así permitir que un mismo destinatario pueda recibir más de un mensaje en las campañas creadas a través de archivo:
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.4
- Actualización dependencias
1.14.3
- Actualización dependencias
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.14.0
- Actualización dependencias
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ámetrocertification_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.12.0
- Añadido nuevo grupo '2 Way SMS'
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.6
- Hemos añadido 4 nuevos endpoints:
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'
- [POST] Envío Simple (Transactional)
- [POST] Crear una campaña
- [GET] Obtener todas las campañas
- [GET] Obtener una campaña
- [POST] Activar una campaña
- [POST] Desactivar una campaña
- [POST] Enviar ahora
- [DELETE] Eliminar una campaña
- [GET] Obtener resumen Notificaciones de Entrega
- Nuevo método '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.sms.consultel.es/docs/v1/reports/push/delivery
- La antigua url
https://api.sms.consultel.es/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.8.0
- Actualización dependencias
1.7.11
- 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íoprice_using_packs
que 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íoprice_using_packs
que 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.8
- 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.
v1.7.0
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. - Actualización interna API.
- Corrección de errores.
- Restructuración interna.
- Corrección de errores.
- Mejoras notables en velocidad.
- Corrección de errores.
- Corrección de errores.
- Añadido nuevo servicio 'Premium'
- Corrección de errores.
- Mejoras en la validacíon de números internacionales
- Corrección de errores.
- Mejoras notables en velocidad.
- Corrección de errores.
- Nueva funcionalidad: Envío simple programable
- Ahora puedes programar con fecha y hora tus envíos simples
- Corrección de errores.
- Mejoras notables en velocidad.
- Añadidos nuevos controles internos.
- Se ha habilitado el soporte de Emojis desde la API
- Añadido nuevo grupo '2-Factor Authentication'
- Corrección de errores.
- Mejoras notables en velocidad.
- Actualización interna API.
- Arreglos en documentación.
- Corrección de errores.
- Mejoras notables en velocidad.
- Añadido nuevo grupo 'Configuraciones de envío'
- Mejoras en la documentación.
- 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 tipostring
que permite buscar por búsqueda exacta o que contenga el valor envíado. Se ha implementado en los siguientes métodos: - Obtener todas las agendas
- Obtener todos los contactos
- Obtener todos los campos personalizados
- Obtener todas las campañas
- Arreglos en documentación.
- Corrección de errores.
- Mejoras en velocidad.
- Actualización interna API.
- Arreglos en documentación.
- Corrección de errores.
- Mejoras en velocidad.
- 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.- Las importaciones de contactos a través de fichero y las campañas a través de fichero ahora aceptan también archivos .txt
- Implementación de Marcas Blancas
- Actualización interna API.
- Arreglos en documentación.
- Corrección de errores.
- Mejoras en velocidad.
- Implementados nuevos servicios de facturación.
- Actualización interna API.
- Arreglos en documentación.
- Corrección de errores.
- Mejoras en velocidad.
- Actualización interna API.
- Arreglos en documentación.
- Corrección de errores.
- Mejoras en velocidad.
- Actualización interna API.
- Arreglos en documentación.
- Corrección de errores.
- Mejoras en velocidad.
- 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.
- Nuevos métodos para el grupo 'Saldo'.
- Actualización interna API.
- Arreglos en documentación.
- Corrección de errores.
- Mejoras en velocidad.
- Añadido dos nuevos métodos en el grupo 'Campañas'.
- 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
- 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.
- Añadido nuevo método 'Crear contactos masivamente' (/contacts/massive) del grupo 'Contactos'.
- Añadido aviso de cookies
- Cambios en diseño página principal
- Corrección de errores y optimización de velocidad de la API.
- Añadido nuevo método 'Obtener URL Formulario de Baja' (/tools/unsubscribe_url) del grupo 'Herramientas'.
-
[DEPRECATED]
configuration_id
en respuestas de envíos y métodos de campañas. A partir de ahora, debe usarseid
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
- 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:
- id de campaña
- active
- state_id
- state_name
- Corrección de errores y optimización de velocidad de la API.
- Mejoras en la documentación.
- Actualización interna API.
- Arreglos en documentación.
- Corrección de errores.
- Arreglado error que no permitia crear campañas sin usuarios.
- Corrección de errores.
- Traducción al español de la documentación técnica de la API.
- Corrección de errores.
- Nueva home para api.sms.consultel.es
- Corrección de errores.
- Mejorado el sistema de LOG de la API.
- Arreglos en documentación.
- Corrección de errores.
- Normalizadas respuestas de la API
- Añadido nuevo grupo 'Herramientas'
- [POST] Preview Mensaje a enviar
- Corrección de errores.