Envío individual
Una de las formas de envío de mensajes con la que cuenta la aplicación Claro Notifícame, es el envío directo de mensajes a un teléfono específico o mejor conocido como Envío Individual.
Para poder realizar este tipo de envío, se debe realizar una llamada al URL de la siguiente forma:
https://url_pais/api/http/send_to_contact?msisdn=%SMSNUMBER&message=%SMSTEXT&id=%ID&api_key=%API_KEY
En donde:
%SMSNUMBER se refiere al número de teléfono destino, el cual debe incluir el código de país de acuerdo a los parámetros internacionales (por ejemplo 502 para Guatemala). Si no se tuviera configurado este parámetro, se puede elaborar la modificación a la llamada para incluirlo directamente.
%SMSTEXT es el cuerpo del mensaje que se desea enviar.
%ID (que se puede incluir de forma opcional) es un valor que contiene un ID único de mensaje. Este valor sirve para evitar envíos duplicados de mensajes al realizar reintentos. Cualquier mensaje que lleve el mismo ID dentro de una ventana de 2 horas será rechazado por duplicidad. Si no se envía este campo, la validación de duplicación se realiza sobre el destinatario más el mensaje enviado.
%API_KEY es la llave de autenticación suministrada, la cual puede obviarse si se utiliza el método de autenticación por medio de IP
Respuesta
Claro Notifícame devolverá un código de respuesta que indicara al usuario, si el envío del mensaje fue exitoso o bien si ocurrió un error. Por favor consultar la tabla de códigos de respuesta de plataforma.