Como habréis ido leyendo en los diferentes posts de nuestro Blog, Mensagia ofrece una infinidad de funcionalidades y recursos propios que permiten la gestión integra de los envíos de una forma ágil y óptima.
Uno de estos recursos es el acortador de enlaces, el cual puede usarse tanto desde el portal como desde API.
Dedicaremos este post a explicar como enviar enlaces acortados con parámetros desde API.
Pongamos un caso práctico.
Una entidad desea enviar por SMS un contrato a cada destinatario y cada contrato tiene una URL, por ejemplo:
Destinatario 1 > https://midominio.com/crm/contratos/?codigocontrato=123456
Destinatario 2 > https://midominio.com/crm/contratos/?codigocontrato=158589
Destinatario 3 > https://midominio.com/crm/contratos/?codigocontrato=655566
¿Cómo se gestiona desde la API de Mensagia?
Primero hay que acortar la URL base del contrato, que en este caso práctico es https://midominio.com/crm/contratos/ . Puedes usar el método para acortar enlaces (más info aquí)
Después, se ha de etiquetar el enlace añadiendo url_parameters en la petición de envío.
Si se usa el método de envío simple para realizar el envío de los SMS, hay dos formas de hacerlo:
- Enviar el valor fijo del parámetro codigocontrato en cada envío simple, es decir, codigocontrato=1234567.
- Enviar como campo personalizado del contacto el valor del parámetro codigocontrato. En este caso, se necesita tener creados los contactos y el campo personalizado codigocontrato con su valor para cada contacto en Mensagia. Puedes crear campos personalizados desde API, más info aquí
El nombre del campo personalizado de ir entre corchetes como en el siguiente ejemplo: codigocontrato=#codigocontrato#
Si se usa el método de envío múltiple o envío masivo – campañas para realizar el envío, en la petición del envío, se incluirá url_parameters con el parámetro codigocontrato=#codigocontrato#
El enlace de cada contrato se construirá añadiendo los parámetros personalizados a cada uno de los nuevos enlaces creados al realizar el envío.
Recuerda: no añadas parámetros al enlace corto que te proporcionamos, usa el método de etiquetar enlaces descrito en este post.
Para el valor del campo url_parameters, no utilices un ? al inicio y concatena nuevos parámetros con & (ejemplo: name=#name#&codigocontrato=#codigocontrato#)
Más info sobre el etiquetado de enlaces en la API aquí
