Descubre
nuestras API
Llega al corazón de nuestra tecnología con nuestra documentación dedicada a la API.
API SMS
Podrás integrar la posibilidad de enviar SMS directamente desde tus aplicaciones empresariales. Con una sola cuenta, MTarget puede enviar tus SMS en Francia y en el extranjero. Sólo tienes que especificar los destinos adicionales que necesites.
Ten en cuenta que estás obligado a tener en cuenta los deseos de los destinatarios que ya no deseen recibir mensajes SMS.
Dependiendo del país de destino (determinado por el prefijo telefónico de su número de móvil), se les pueden ofrecer diferentes canales para ejercer este derecho (una respuesta de «STOP» en un código corto o un número largo indicado en el mensaje enviado, el uso de un enlace a una página para darse de baja, etc.) y diferentes leyes y normativas pueden regir los términos y condiciones.
Puedes abrir una cuenta para probar nuestro servicio gratuitamente. No es obligatorio crear una cuenta. Para abrir una cuenta, envía un correo electrónico a support@mtarget.fr especificando :
- Vuestros datos de contacto :
– email de la cuenta
– apellido
– nombre
– nombre de la empresa
– Siret
– número de teléfono - Las direcciones IP fijas de los servidores desde los que se enviarán los mensajes si quieres un control por IP.
A cambio, te proporcionamos los identificadores que necesitas para utilizar la API.
La cuenta de envío que abrimos para ti puede admitir varias ofertas y tarifas diferentes en función de los destinos y los operadores, así que no dudes en decirnos qué destinos te gustaría probar.
Para asegurar tu cuenta, te ofrecemos una restricción de IP en tu cuenta. Debes facilitarnos la(s) IP(s) de tus servidores cuando crees tu cuenta o antes de tus pruebas. No olvides facilitarnos las IP de tus PCs o servidores de prueba, si los tienes.
Podemos facilitarte nuestra IP de envío para que puedas establecer restricciones equivalentes por tu cuenta.
El uso combinado de la protección IP, la protección por contraseña API y el protocolo TLS para asegurar los intercambios garantiza un alto nivel de seguridad compatible con la mayoría de los requisitos. No obstante, nuestros equipos técnicos están a tu disposición para estudiar contigo la implantación de mecanismos de seguridad adicionales susceptibles de responder a las necesidades de tu Política de Seguridad de los Sistemas de Información.
En principio, nuestros tiempos de respuesta a tus solicitudes son muy inferiores a un segundo. Sin embargo, te aconsejamos que establezcas un tiempo de espera de 45s por tu parte. Una falta de respuesta por nuestra parte no debe considerarse un comportamiento normal y no debe justificar la devolución de la solicitud.
Acceso al servicio
La API está disponible a través de dos URL. Si tu cuenta está configurada con acceso restringido a determinadas IP,
la URL que debes utilizar es : https://api.mtarget.fr/
De lo contrario, la URL a utilizar sin control de IP es : https://api-public.mtarget.fr/.
Esta URL devolverá sistemáticamente un mensaje de error si tu cuenta es una cuenta controlada por IP.
Si, durante tus pruebas, nuestro servicio no responde y entra en tiempo de espera, significa que tienes una cuenta con restricción de IP y que la IP que estás utilizando no está autorizada.
Por razones de compatibilidad con versiones anteriores, estas URL también responden en HTTP, pero este comportamiento no está garantizado a largo plazo y te recomendamos encarecidamente que utilices el protocolo seguro HTTPS para tus peticiones.
En Francia, el envío de SMS está sujeto a una estricta normativa horaria (otros países pueden tener normas horarias, consulta el). On distingue deux types de SMS et nous vous proposons donc plusieurs offres :
- Marketing por SMS
Los mensajes de marketing SMS son publicidad à de naturaleza promocional para la comunicación de masas (promociones, ventas, etc.).
Estos envíos están autorizados en Francia de lunes a sábado, de 8 a 22 h. Están prohibidos los domingos y festivos.
Además, los mensajes de marketing deben contener las palabras «STOP 36180».permitiendo a los clientes solicitar que dejen de recibir mensajes.
Si nos envías contenido sobre una oferta de Marketing entre las 22.00 y las 8.00 horas, los SMS se pondrán en espera y se enviarán a las 8.00 horas. Los SMS enviados en días festivos y domingos serán rechazados.
- Alerta por SMS
Las alertas SMS son mensajes de notificación destinados a la comunicación individual, como la programación de citas, la entrega de paquetes, las alertas domóticas, etc.
Los mensajes de alerta no se ven afectados por las restricciones temporales del Marketing por SMS. Por supuesto, el contenido de marketing está estrictamente prohibido en esta oferta.
Cualquier abuso puede dar lugar al cierre de la cuenta y a la imposición de sanciones contractuales.
API RCS
RCS (Rich Communication Services) es un protocolo para enviar mensajes multimedia a tus clientes a través de un agente dedicado a tu marca o empresa.
El uso de estas API depende de dos factores:
- Abre una cuenta para probar nuestro servicio. Crear una cuenta es gratis y sin compromiso. Para abrir una cuenta, envía un correo electrónico a support@mtarget.fr y csm@mtarget.fr con el asunto «Creación de una cuenta API RCS» y especificando tus datos de contacto:
- correo electrónico de la cuenta
- nombre
- Nombre de pila
- nombre de la empresa
- Siret
- número de teléfono móvil
A cambio, te proporcionamos los datos de acceso a nuestro portal.
- Abrir un agente con operadores franceses en Francia continental. Para ello, una vez abierta tu cuenta API, puedes conectarte a nuestro portal para rellenar un formulario, incluyendo los recursos gráficos necesarios para el BOT.
Voz API
Puedes enviar mensajes de voz pregrabados a tus contactos. Dependiendo del destino, los mensajes pueden enviarse mediante llamadas directas o depositarse en un contestador automático.
Para solicitar acceso envía un correo electrónico a support@mtarget.fr. avec comme sujet de mail «Demande d’accès à l’API de Push Vocal» et en précisant vos coordonnées :
- correo electrónico de la cuenta
- nombre
- Nombre de pila
- nombre de la empresa
- Siret
- número de teléfono móvil
Una vez que hayas solicitado el acceso, te proporcionaremos los datos de acceso a nuestra API en línea para que puedas programar tus pulsaciones de voz y recuperar tus estadísticas.
Simplifícate la vida con nuestra documentación de libre acceso.
CRM Y CMS
Utiliza nuestros conectores específicos para integrar fácilmente nuestra solución de envío de SMS en tu arquitectura técnica actual, facilitando la automatización de tareas específicas.
El sistema es compatible con varios CRM y CMS, como Salesforce, Adobe Campaign y Selligent, así como WordPress, Marketo y numerosos CMR específicos del sector, como Immofacile y Horus.
Te permitimos enviar mensajes SMS utilizando tu herramienta Marketo.
Inscripción
Puedes abrir una cuenta para probar nuestro servicio. Crear una cuenta es gratis y sin compromiso. Para abrir una cuenta, envía un correo electrónico a support@mtarget.fr con el asunto «Crear una cuenta API Marketo» y tus datos de contacto:
- correo electrónico de la cuenta
- nombre
- Nombre de pila
- nombre de la empresa
- Siret
- número de teléfono móvil
A cambio, te proporcionamos los identificadores que necesitas para utilizar la API.
La cuenta de envío que abrimos para ti puede admitir varias ofertas y tarifas diferentes en función de los destinos y los operadores, así que no dudes en decirnos qué destinos te gustaría probar.
Crear un nuevo webhook
Para iniciar la integración, primero tienes que crear un nuevo archivo :
- > > Ir a Admin Webhook Nuevo Webhook
- Introduce los siguientes parámetros:
- Nombre del webhook: el nombre de tu nuevo webhook
- URL: https://api-public-2.mtarget.fr/messages
- Tipo de petición: POST
- Plantilla: username={mi.nombre.de.usuario.SMS}}&password={mi.contraseña.SMS}}&serviceid={mi.serviceid.SMS}}&msisdn=%2B{número.de.teléfono}}&msg={mi.mensaje.SMS}}&timetosend={mi.hora.de.envío.SMS}}&sender={mi.remitente.SMS}}
- Codificación del token de solicitud : Formulario/Url
- Tipo de respuesta: XML
Nota: Marketo puede tardar unos minutos en tener en cuenta los cambios en estos parámetros.
Crea los tokens correspondientes
Una vez creado el webhook, tienes que asociarle los parámetros correspondientes. Para ello, ve a Actividades de marketing y crea un token para cada parámetro recibido durante el registro:
- Nombre de usuario SMS: nombre de usuario transmitido en la recepción
- Contraseña SMS: contraseña enviada al registrarte
- SMS serviceid: serviceid enviado en el registro
A continuación, en la sección Actividad del programa, introduce los siguientes parámetros (obligatorios)
- Mensaje SMS: El contenido de tu mensaje.
- Remitente del SMS : Personalización del remitente: 11 caracteres alfanuméricos, por ejemplo «Tienda» (el valor por defecto difiere según el país y el operador). Algunos operadores se niegan a personalizar el remitente (por ejemplo, NRJ Mobile o Transatel en Francia).
- SMS timetosend : Fecha y hora en que se envió el mensaje (formato: aaaa-MM-dd HH:mm:ss ej: 2038-01-19 04:14:08). El plazo de envío no puede ser superior a 24 horas, por lo que los plazos de entrega más largos deben ser gestionados por tu parte. Aunque se programe con antelación, no es posible cancelar un mensaje. La zona horaria es la de Francia. Si, entretanto, un destinatario te informa de que ya no desea recibir mensajes SMS (BAJA), ya no podrás gestionar estos mensajes preprogramados. Nota: este campo es opcional, pero si se introduce en la plantilla, debe tener el formato esperado (y no estar vacío).
Prueba
El webhook ya está configurado, llámalo una vez para comprobar que funciona. Si hay algún problema, mira detalladamente la respuesta del webhook.
Te damos la opción de enviar mensajes de texto desde tu sitio WordPress integrando el WP SMS PLUG-IN.
Inscripción
Puedes abrir una cuenta para probar nuestro servicio. Crear una cuenta es gratis y sin compromiso. Para abrir una cuenta, envía un correo electrónico a support@mtarget.fr con el asunto «Crear una cuenta API WordPress» y tus datos de contacto:
- correo electrónico de la cuenta
- nombre
- Nombre de pila
- nombre de la empresa
- Siret
- número de teléfono móvil
A cambio, te proporcionamos los identificadores que necesitas para utilizar la API.
La cuenta de envío que abrimos para ti puede admitir varias ofertas y tarifas diferentes en función de los destinos y los operadores, así que no dudes en decirnos qué destinos te gustaría probar.
Utiliza
- > Instala el complemento y, a continuación, ve a la pestaña Configuración de la puerta de enlace para configurar tu cuenta.
- Selecciona Mtarget en el campo Nombre de la pasarela.
- Configura tu nombre de usuario y contraseña con los que se te proporcionaron al registrarte. Puedes elegir un remitente personalizado en el campo Número de remitente (11 caracteres).
- La opción Enviar como unicode debe estar marcada si quieres enviar caracteres no admitidos por los mensajes SMS estándar. Ten en cuenta que al marcar esta opción se reduce la longitud de un SMS de 160 a 70 caracteres.
- Si quieres enviar tus propios mensajes SMS, el plugin incluye una función wp_sms_send que tiene en cuenta dos parámetros: una matriz de msisdns y el mensaje que se va a enviar (consulta el ejemplo siguiente).
$to[] = ‘+33xxxx1’;
$to[] = ‘+33xxxx2’;
$msg = «Prueba»;
wp_sms_send($a, $msg);
Para más información sobre las funciones del plug-in, visita https://wordpress.org/plugins/wp-sms/.
SMPP Y SFTP
Te ofrecemos la flexibilidad que necesitas para optimizar tus campañas de SMS según tus necesidades.
Elige entre el protocolo SMPP, una solución robusta para enviar mensajes SMS masivos, y el modo de conexión SFTP, ideal para integrar y automatizar tus campañas de forma segura.
Para más información sobre estas tecnologías, consulta nuestras guías detalladas.
SMPP
Puedes obtener más información sobre el SMPP en el sitio web https://smpp.org .
Para utilizar esta conexión, ponte en contacto con support@mtarget.fr con el asunto «crear una cuenta SMPP» y la siguiente información:
- tus direcciones IP desde las que lanzarás la conexión SMPP.
- tus datos de contacto: apellidos, nombre, nombre de la empresa, Siret y número de teléfono
SFTP
Deposita tus archivos en nuestro servidor SFTP para enviar tus campañas SMS. Los mensajes se envían y recuperas un archivo con los acuses de recibo de cada mensaje, así como las bajas (STOP).
Este protocolo es uno de los más seguros y fiables. Es perfectamente adecuado para envíos masivos (como campañas de marketing por SMS) de hasta 1 millón de destinatarios. Para números mayores, necesitarás enviar varios archivos.
Ten en cuenta que, dependiendo del país de destino, estás obligado a tener en cuenta el deseo de los destinatarios de SMS de poder darse de baja. Esto suele ocurrir cuando las personas envían un STOP a cambio de un mensaje. Esta información se detalla en la sección Informe STOP.
Para utilizar el repositorio SFTP para enviar mensajes SMS, ponte en contacto con support@mtarget.fr indicando en el asunto «crear una cuenta SFTP».
Aquí tienes la información que debes enviarnos en el correo electrónico:
- datos de contacto: apellidos, nombre, nombre de la empresa, Siret y número de teléfono
- direcciones IP fijas de los servidores desde los que se enviarán los archivos
- Si deseas activar los MB (respuestas)
- Si quieres recibir el seguimiento de la campaña por correo electrónico
Enrutamiento
Con una sola cuenta, MTarget puede enviar tus mensajes SMS en Francia y en el extranjero. Estamos conectados con más de 700 operadores en 280 destinos, así que sólo tienes que decirnos de antemano qué destinos quieres.
IMPORTANTE : Restricciones horarias SMS MARKETING Francia. El SMS Marketing se refiere a los mensajes publicitarios de carácter promocional para la comunicación de masas (promociones, ventas, etc.).
Los envíos de marketing están autorizados: De lunes a sábado de 8 a 22 h. Domingos y festivos excluidos.
Para cualquier campaña enviada fuera de los días y horas autorizados, los mensajes se mantendrán en espera y se enviarán el siguiente día laborable a las 8 de la mañana.
Deducción de crédito: Tu cuenta se descuenta cuando se envía tu campaña (y no cuando se programa). Asegúrate de que tienes suficiente crédito en tu cuenta cuando envíes tu campaña, de lo contrario podría cancelarse o enviarse sólo parcialmente.
Protocolo
Tenemos servidores SFTP con filtrado de IP.
El envío de archivos se procesa inmediatamente, y tu archivo se tendrá en cuenta en cuanto se cargue en el SFTP. La velocidad de transmisión depende de la carga de los enlaces con los operadores.
El bloqueo SFTP consta de 2 directorios:
- Envía
- Informe
Seguridad
Por razones de seguridad, bloqueamos las direcciones IP desconocidas. Tendrás que informarnos de tus direcciones IP fijas en la siguiente dirección: support@mtarget.fr.
Se pueden implementar otros mecanismos de seguridad, como la autenticación mediante claves asimétricas RSA (el departamento técnico estará encantado de trabajar contigo para estudiar las opciones compatibles con tus requisitos).
Como parte de las buenas prácticas, te pedimos que borres los datos recuperados del SFTP. Nos reservamos el derecho de hacerlo para los archivos que tengan más de un mes de antigüedad.
Seguimiento de la aceptación de la campaña por correo electrónico
Opcionalmente, puedes recibir información por correo electrónico sobre el estado de tu campaña. Se enviará un primer correo electrónico cuando se envíe el archivo para confirmar que éste se ajusta a la nomenclatura establecida. Se enviará un segundo correo electrónico cuando se lance la campaña, informándote del número de mensajes de texto que se han programado.
Formato de archivo
El archivo debe estar en formato csv (separador de punto y coma) según la norma: https: //www.ietf.org/rfc/rfc4180.txt
Codificación del archivo La codificación del archivo fuente enviado debe estar en UTF-8 (la codificación puede modificarse en el lado MTarget si es necesario).
Formatear el fichero : El archivo no debe contener cabeceras de columna. Cada línea del archivo CSV tendrá la forma: IDREMOTE;NUMTEL;EMETTEUR;MSG
IDREMOTO: Se trata de un campo libre limitado a 40 caracteres alfanuméricos, es decir, caracteres de la A a la Z sin acentos en mayúsculas ni minúsculas y números del 0 al 9. Te permite darnos un identificador de empresa que te devolveremos en el informe de acuse de recibo.
NUMTEL:Corresponde al número de móvil, que debe estar en formato internacional (+33). Tu archivo debe estar deduplicado.
REMITENTE: Este campo se puede personalizar con 11 caracteres alfanuméricos sin acentos.
MSG: Contenido del mensaje. Es posible enviar mensajes de texto largos (+160 caracteres) si la opción está activa en tu cuenta.
Recuento de caracteres: Ten en cuenta que en el alfabeto GSM, algunos caracteres ocupan 2 bytes, por ejemplo el signo EURO €, «€ [ ] {}». Para calcular la longitud, hay que contar los caracteres del texto del mensaje independientemente de la codificación de origen (es decir, aplicando la regla 1 byte=1 coche) y añadir un byte más por cada carácter doblemente contado, para que el total no supere los 160 bytes.
Para envíos unicode, ponte en contacto con nosotros.
Para mensajes largos (+160 caracteres), permitimos hasta 5 * 153 caracteres GSM. (Se utilizan 7 caracteres para concatenar mensajes).
Codificación del texto Codificación final del texto del mensaje para su envío: GSM 03.38
Tabla de caracteres gsm: http: //en.wikipedia.org/wiki/GSM_03.38
Los caracteres que no formen parte del alfabeto gsm se sustituirán automáticamente.
Delimitador de campo: Importante: Todos los delimitadores de campo ( ; ) deben estar presentes.
Ejemplo: El archivo que se va a cargar contendrá un conjunto de líneas como las que se muestran a continuación:
VSQR0339;+33787798753;Vivienda;http://www.URL.com/fr/ref-VSQR0339 4P 79m2 3er piso Imm antiguo 2Chbres Volúmenes vista Perfecto estado
Nombre del archivo
El nombre del archivo debe formalizarse como sigue SEND-SERVICEID-DATE-HEURE-IDCAMPAGNE.csv
ENVIAR : Prefijo obligatorio que puede escribirse en mayúsculas o minúsculas.
SERVICEID: es un número de 5 cifras que te dan cuando abres tu cuenta.
FECHA : en formato AAAAMMDD
HORA : en formato HHMM
IDCAMPAGNE : Se trata de un campo libre que puede contener un máximo de 20 caracteres alfanuméricos, es decir, caracteres sin acentuar en minúsculas o mayúsculas de la A a la Z y números del 0 al 9.
Ejemplo: SEND-12345-20160728-1827-testpushsftp.csv
Envío diferido: Puedes aplazar el envío de una campaña especificando la fecha y hora deseadas. Atención: tu archivo se tendrá en cuenta en cuanto se cargue en el SFTP. Por tanto, no será posible modificar o cancelar envíos ya programados volviendo a descargar una versión diferente del archivo inicial. En este caso, deberás ponerte en contacto con el servicio de asistencia de M-Target lo antes posible para cancelar la campaña aplazada.
Ten en cuenta que si, entretanto, un destinatario te informa de que no desea seguir recibiendo mensajes SMS (BAJA), ya no podrás gestionar estos mensajes preprogramados.
Si subes un archivo con fecha pasada, se enviará inmediatamente.
Tratamiento de archivos
Carga de archivos: Los archivos para enviar campañas se cargan en el directorio de envío. Los archivos subidos al directorio raíz no se procesarán. Para evitar que el archivo se procese antes de que finalice la transferencia, el archivo debe subirse con la extensión «.tmp». Una vez subido el archivo, debes renombrarlo a «.csv». Se tendrá en cuenta instantáneamente en cuanto se renombre y añadiremos la extensión «.lock» mientras se procesa el archivo.
Ejemplo Si subes SEND-12345-20160728-1827-testpushsftp.tmp, cámbiale el nombre a SEND-12345-20160728-1827-testpushsftp.csv. Cuando nuestro sistema acepte el archivo, lo renombrará a .lock
Archivo conforme
Si tu archivo es correcto y ha sido procesado, se renombrará a .done.
Ejemplo : SEND-12345-20160728-1827-testpushsftp.done
Archivo no conforme
Si tu archivo no es conforme y no puede procesarse, se le cambiará el nombre a .reject.
Ejemplo : SEND-12345-20160728-1827-testpushsftp.reject
Este estado significa que no se ha enviado ningún SMS.
Informe de reconocimiento
El informe de reconocimiento está disponible en este directorio en :
D+4 para envíos de más de 10.000 mensajes SMS
D+1 para envíos inferiores a 10.000 SMS, con una actualización diaria durante 4 días.
Nombre del archivo Se enviará un archivo csv con el siguiente nombre ACK-SERVICEID-FECHA-HEURE-IDCAMPAGNE.csv
Ejemplo: ACK-12345-20160728-1827-testpushsftp.csv
Contenido del archivo: El archivo contendrá los siguientes datos: IDREMOTE;TELNUMBER;SENDER;MSG;IDSTATUS;STATUS;ACKOPERATOR
Ejemplo: VZBL6259;+33787789959;Vivienda;http://www.URL.com/fr/ref-VSQR0339 4P 79m2 3er piso Imm antiguo 2Chbres Volumes vue Parfait état;2 ;sent;92c30692-705b-4433-8789-92a1e78104b4
IDSTATUS y STATUS:
Informe STOP
Estará disponible y se actualizará en tiempo real un fichero con las STOP de la Campaña. Si el fichero se borra después de ser procesado por tu parte y se recibe una nueva STOP, volveremos a crear el fichero.
Nombre del archivo Se enviará un archivo csv con el siguiente nombre STOP-SERVICEID-FECHA-HEURE-IDCAMPAGNE.csv
Ejemplo: STOP-12345-20160728-1827-testpushsftp.csv
Contenido del fichero : El archivo contendrá los siguientes datos TELNÚMERO;FECHA;HORA;CONTENIDO;NOTEID
Gestión de listas negras: MTarget te ofrece la posibilidad de configurar una lista negra en tu cuenta para asegurarte de que no te comunicas con números que han contestado STOP.
Informe SMS-MO
Un archivo que contiene las MO (respuestas) de la CAMPAÑA estará disponible y se actualizará en tiempo real. Si el archivo se elimina tras el procesamiento por tu parte y se recibe una nueva MO, volveremos a crear el archivo.
Nombre del archivo: Se archivará un archivo csv con el siguiente nombre: SMSMO-SERVICEID-DATE-HEURE-IDCAMPAGNE.csv
Ejemplo: SMSMO-12345-20160728-1827-testpushsftp.csv
Contenido del archivo: El archivo contendrá los siguientes datos: TELNÚMERO;FECHA;HORA;CONTENIDO;NOTEID
Herramientas
API acortadora de URL
Prueba API
Esta herramienta permite a nuestro equipo de asistencia recuperar los elementos enviados a la dirección de sustitución https://api-test.mtarget.fr/ para ayudarte a resolver problemas durante el despliegue de nuestra API (no se transmite tu contraseña).
Sólo tienes que sustituir la URL de la API por esta URL de prueba y enviar un correo electrónico a support@mtarget.fr para solicitar ayuda.
Recuento de caracteres
Esta herramienta te permite introducir tu mensaje y calcular el número de SMS necesarios para enviarlo. Te dirá qué caracteres no se pueden enviar utilizando elalfabeto GSM.
Si estos caracteres no están presentes en el alfabeto GSM, es necesario pasar al formato Unicode, que reduce drásticamente el tamaño de un SMS a 70 caracteres (frente a los 160 del GSM).
Excluyendo Unicode, más allá de 160 caracteres y para encadenar mensajes SMS, la norma GSM impone una longitud de SMS de 153 caracteres (mensaje normal: 160 caracteres, mensaje largo: 153 +153 + …).
Ten en cuenta que esta herramienta no puede tener en cuenta técnicamente la presencia de determinados caracteres (invisibles, etc.) vinculados a tu sistema. Sólo una prueba unitaria de envío te permitirá estar seguro del número de sms de tu mensaje.
Pie de foto: