Índice FAQs

Preguntas frecuentes sobre Integración API

  • ¿Cómo obtengo un usuario para enviar a través de API?

    Cualquier cuenta registrada en la plataforma de LabsMobile puede enviar mensajes a través de la API.Es posible crear una cuenta en el formulario de registro introduciendo una dirección email donde se recibirá la contraseña de acceso a la cuenta.

    Una vez se ha creado la cuenta recomendamos crear un token API en el apartado Contraseñas. Este token añadirá seguridad y no compromete la contraseña general de la cuenta en las llamadas a funciones de la API.

  • ¿Qué recursos y ayuda tengo para realizar una integración API?

    En LabsMobile puede encontrar toda la ayuda y soporte que necesitas para realizar cualquier integración con nuestra API.

    En https://apidocs.labsmobile.com/ puedes encontrar las instrucciones de nuestra API versión JSON que es la más compatible y la que se adapta a la mayoría de entornos. Aquí se describen todas las posibilidades de la API incluyendo las medidas de seguridad, autentificación, envío de mensajes, consulta de saldo, recepción de confirmaciones de entrega, etc. Además también se muestran ejemplos de código en PHP, Python, Java, C, Javascript y muchos otros lenguajes de programación.

    Además tienes a tu disposición todos estos recursos para completar tu integración:

    • - Ejemplos de código de programación en múltiples lenguajes y entornos.
    • - Plugins, módulo y extensiones de diferentes plataformas, frameworks, CMS, etc.
    • - Tutorial para realizar una integración en 10 sencillos pasos.
    • - Otras versiones de nuestra API que incrementan las funcionalidades y compatibilidad.
    • - Recomendaciones y buenas prácticas en toda integración.
    • - Listado de caracteres presentes en el alfabeto GSM.

  • ¿Dónde encuentro ejemplos de código en mi entorno o lenguaje para enviar SMS con la API de LabsMobile?

    En la url https://apidocs.labsmobile.com/ encontrarás los ejemplos de código para nuestra API JSON en los siguientes lenguajes: cURL, C, C#, Go, Java, jQuery, Javascript, Node.js, Objective-C, Perl, PHP, Python, Ruby, Swift, VB.net.

    Además tienes ejemplos de código para cualquier otra versión de nuestra API en https://www.labsmobile.com/es/api-sms/ejemplos-codigo.

    Puedes encontrar ejemplos en C, C++, C#, ColdFusion, Delphi, Go, Java, Javascript, jQuery, Node.js, Objective C, Perl, PHP, PL/SQL, Python, Ruby, Swift, Visual Basic, VB.net.

  • ¿Cómo puedo ver el estado de los mensajes enviados a través de API?

    A través de la API es posible consultar el estado de cada mensaje o también recibir en una URL los cambios de estado de cualquier mensaje enviado.

    También es posible acceder al panel de control web de la cuenta (aplicación WebSMS) con el nombre de usuario y contraseña. Dentro de la cuenta es posible ver la información de los mensajes enviados en el apartado Histórico del menú principal.

    Se pueden filtrar los mensajes por multitud de parámetros como fecha de envío, número de los destinatarios, remitente, etc.

    Uno de los datos más importantes es el estado del mensaje (Procesado, Enviado, Entregado, Caducado, Rechazado, No entregable, Duplicado, etc.) y la fecha/hora en el que se ha producido el último cambio de estado.

  • ¿Cómo puede aumentar la seguridad de los envíos API?

    Una vez realizada una integración recomendamos revisar algunos aspectos de seguridad como:

    • - Utilizar HTTPS para cifrar la comunicación entre el servidor que realiza la llamada y el servidor API de LabsMobile. En general basta con utilizar la url https://api.labsmobile.com/.
    • - Utilizar un token API que se crea en la sección Contraseñas del panel de control de la cuenta. De esta forma no se compromete la contraseña de la cuenta y se pueden habilitar/deshabilitar token en función de diferentes usos o integraciones.
    • - Incluir la IP del servidor de origen en las Preferencias de la cuenta. Así la plataforma sólo admitirá y procesará las peticiones que tengan esta dirección IP como origen.
    • - Configurar los máximos de tráfico de mensajes diarios y por envío (petición o llamada).

  • ¿Cómo obtengo soporte para realizar una integración API?

    En el caso que la documentación y ejemplos presentes en https://apidocs.labsmobile.com/ no sean suficientes y existan duda o preguntas es posible contactar con LabsMobile en support@labsmobile.com o creando un ticket en el Centro de Soporte (en el panel de control web de la cuenta).

    La información a enviar en función del tipo de incidencia o consulta debería incluir:

    • - Cuenta de usuario (email de registro).
    • - Lenguaje y entorno de programación (con versión y configuraciones adicionales).
    • - Versión de la API de LabsMobile escogida (JSON, GET, POST, WebService, MAIL).
    • - Enviar las líneas de código o función que produce el problema.
    • - Día y hora aproximados de los últimos intentos de peticiones a la API si son el motivo de la consulta o problema.Uno de nuestros técnicos se pondrá en contacto lo antes posible para responder o solucionar cualquier tema.

  • ¿Qué pruebas tengo que hacer o qué debo revisar en mi integración?

    Toda integración con la API de LabsMobile debería comprobar los siguientes aspectos:

    • - Verificar que todos los campos obligatorios se envían siempre y así no se producirán errores por campos requeridos no informados.
    • - Probar la integración con mensajes concatenados (más largos de 160 caracteres).
    • - Probar el envío de caracteres no incluidos en el alfabeto GSM. En muchos casos es necesario sustituir algunos caracteres no ASCII por caracteres del

  • ¿Cómo envío mensajes de test o simulados?

    Los mensajes de test se pueden enviar a través de la API añadiendo un flag o etiqueta al envío. El formato concreto de este campo depende de la versión de la API (JSON, GET, POST, WebService, Mail) y se puede consultar en la documentación online o en el manual PDF.

    Los mensajes enviados como test (o prueba) no se enviarán a los destinatarios finales ni tampoco descontarán créditos de la cuenta. Pero quedarán almacenados en el histórico de la cuenta.

    Por tanto, es posible consultar cualquier mensaje de test en el apartado Histórico del panel de control web de la cuenta.

    Recomendamos este tipo de envíos para las primeras pruebas de integración y para envíos masivos o campañas simuladas.

  • ¿Cómo puedo recibir por API los cambios de estado o confirmaciones de los mensajes enviados?

    Después del envío de un mensaje SMS es posible recibir por API los cambios de estado de estos mensajes. De esta forma la plataforma que envía puede almacenar y registrar el estado actual y los diferentes cambios de estado de cada mensaje SMS enviado.

    La recepción de estos cambios de estado se puede hacer de forma individual incluyendo los campos acklevel y ackurl en la petición de envío SMS.

    También se puede configurar en las Preferencias de la cuenta una URL de notificación de confirmaciones de entrega donde se recibirá cualquier cambio de estado. En este caso se recibirán los cambios de estado de todos los mensajes enviados desde API o WebSMS desde esta cuenta.

    La forma de recibir estas confirmaciones, errores o cambios de estado es mediante una llamada HTTP/GET a una determinada URL con la información correspondiente (acklevel, msisdn, status, desc, subid, timestamp). Más información técnica en la descripción online de la API o en los manuales PDF.

  • ¿Cómo puedo recibir por API los cambios de estado o confirmaciones de los mensajes enviados?

    Después del envío de un mensaje SMS es posible recibir por API los eventos de clic producidos en los enlaces presentes en el texto de los mensajes enviados. De esta forma la plataforma que envía puede almacenar y registrar los diferentes clics con toda la información relacionada.

    La recepción de eventos de clic se puede hacer de forma individual incluyendo el campo clickurl en la petición de envío SMS.

    También se puede configurar en las Preferencias de la cuenta una URL de notificación de visitas o clics donde se recibirá cualquier evento de clic. En este caso se recibirán los clics de todos los mensajes enviados desde API o WebSMS desde esta cuenta.

    La forma de recibir estos clics es mediante una llamada HTTP/POST JSON a una determinada URL con la información correspondiente (ip, useragent, subid, msisdn, timestamp). Más información técnica en la descripción online de la API o en los manuales PDF.

  • ¿Cómo puedo recibir por API los clics que se producen en los mensajes enviados?

    Después del envío de un mensaje SMS es posible recibir por API los eventos de clic producidos en los enlaces presentes en el texto de los mensajes enviados. De esta forma la plataforma que envía puede almacenar y registrar los diferentes clics con toda la información relacionada.

    La recepción de eventos de clic se puede hacer de forma individual incluyendo el campo clickurl en la petición de envío SMS.

    También se puede configurar en las Preferencias de la cuenta una URL de notificación de visitas o clics donde se recibirá cualquier evento de clic. En este caso se recibirán los clics de todos los mensajes enviados desde API o WebSMS desde esta cuenta.

    La forma de recibir estos clics es mediante una llamada HTTP/POST JSON a una determinada URL con la información correspondiente (ip, useragent, subid, msisdn, timestamp). Más información técnica en la descripción online de la API o en los manuales PDF.

 
loader