Guía rápida de como iniciar el API

Con la API de Campañas de SMS de Masiv cualquier empresa podrá conectarse a nuestra plataforma de mensajería a través del Software que gestiona y realizar envíos Masivos.

Con una integración fácil y directa, todas las empresas podrán gestionar sus comunicaciones SMS en sus aplicaciones existentes.

Para crear una campaña y enviarla, se deben seguir tres pasos ordenados, el primer paso es crear la campaña con la información de configuración básica, el segundo paso es cargar los destinatarios a los cuales se va a enviar la campaña, y el tercero y último paso es cerrar la campaña o marcarla como “Lista para enviar”, la especificación de cada uno de dichos pasos se especifica a continuación.

Información importante para el envió de SMS

Tipo de mensaje:

• Estándar: Es un mensaje de texto tradicional que se almacena en la bandeja de entrada del teléfono móvil como texto sin formato.
• Instantáneo: Son mensajes de texto que al ser entregados se muestran o aparecen automáticamente en la pantalla del teléfono, bloqueándolo y permanece allí hasta que presionando cualquier tecla del teléfono móvil automáticamente desaparece y no generan ninguna interacción del usuario. Debes tener en cuenta que este tipo de mensaje, no esta disponible en todos los países y debes validarlo antes de realizar tu envió.

Formato de mensaje:

• Corto: Permite un máximo de 160 caracteres que equivale a un mensaje y no admite caracteres especiales.
• Largo: Permite un máximo de 600 caracteres que equivalen a 4 mensajes, en este caso cada 153 caracteres se cuenta como un mensaje, sin embargo cuando los destinatarios reciben el mensaje se muestra como uno solo y no admite caracteres especiales.
• Texto enriquecido: Permite añadir emojis y caracteres especiales, tiene un máximo de 600 caracteres que equivalen a 9 mensajes y en este caso cada 70 caracteres se cuenta como un mensaje, sin embargo cuando los destinatarios reciben el mensaje se muestra como uno solo.

Colección de Postman

MasivSmsCampaignApi.postman_collection.json

Autenticación

Todos los endpoints del API de Campañas de SMS requieren autenticación. Para ello es necesario que en cada una de las solicitudes que se realicen, se incluya una cabecera de autenticación de tipo Basic Authentication correspondiente a un usuario de Masiv válido

Creación de campañas

Para la creación de una campaña, debe realizarse una solicitud POST al endpoint especificado para tal fin, incluyendo los datos de autenticación y un Body JSON que contenga todos los datos o atributos de configuración de la campaña que se desee crear.