Le ofrecemos la interfaz mas simple y flexible para que rápidamente puedas integrar sus aplicaciones web o sus programas, a nuestra plataforma de envió de mensajes SMS masivos.
El API SMS utiliza la tecnología web actual. El envió de mensajes SMS mediante el API se realiza utilizando el protocolo HTTP a través del gateway que se encuentra en la nube Gamanet.
La URL para el envió de mensajes es http://server_gamanet/smssend
Para enviar un mensaje se usa el método POST con 04 variable obligatorias de envió.
Variables de envió
APIKEY
Clave de acceso al API SMS.
APICARD
Numero de cuenta de cliente.
SMSNUMBER
Numero de celular destino, el numero debe ser de 9 dígitos. (ejemplo: 996927599)
SMSTEXT
Contenido del mensaje a enviar. El numero de caracteres no debe superar los 140 caracteres.
Códigos de Respuesta Comunes
Toda petición o llamada HTTP sera verificada por la plataforma de mensajería. Tanto si la petición es correcta como si se encuentra un error devolverá un código.
0: Procesando
2: Texto supera la cantidad de caracteres permitidos
3: Key no valida
4: Datos obligatorios vacíos o nulos, revisar apikey, apicard, smstext,smsnumber
5: No hay saldo disponible en cuenta.
6: Numero no existe o no es correcto.
7: Se supero Troughput permitido, se recomiendo reducir la velocidad de envió a 10 sms /seg.
Caracteres Soportados
La plataforma de mensajería Gamanet soporta el alfabeto estándar GSM(GSM 3.38 7-bits). Por lo tanto los campos de contenido del mensaje, SMSTEXT, Deben contener caracteres de este alfabeto.
Los mensajes enviados con caracteres no soportados serán normalizados a caracteres si permitidos.
Recomendamos reemplazar los siguientes caracteres:
á => a
í => i
ó => o
ú => u
ñ => n
Registro de mensajes
Se le dará una cuenta con acceso a la pagina web para ver el registro de saldo disponible así como reportes de los mensajes enviados. La información podrá ser consultada desde cualquier lugar y a cualquier hora. Puede consultar la sección de mensajes sms para mas información sobre costos, pagina web, forma de pago, etc.
Cuenta para pruebas y solicitud de cuenta
Puede solicitar una cuenta propia llenando el formulario correspondiente de inscripción. Esta cuenta se puede usar desde la plataforma on-line (web) o en la interface API. La cuenta contara con un crédito para realizar pruebas reales de envió SMS.
Recomendaciones
Se presentan las principales puntos a comprobar en toda integración para asegurar que todo envió SMS se realice sin problemas.
Campos obligatorios. Los campos correspondientes a la APIKEY y APICARD asi como telefono destino SMSNUMBER y contenido del texto SMSTEXT don obligatorios.
Longitud del mensaje. El contenido del mensaje de texto debe de tener un valor no nulo y no sobrepasar los 140 caracteres.
Teléfonos validos. Los teléfonos debe tener un formato numérico de nueve dígitos (ejemplo: 996927599)
Caracteres no validos. El campo del mensaje SMSTEXT debe de contener solo caracteres validos. Recomendamos realizar la conversión de algunos caracteres no soportados o reemplazables.
á => a
í => i
ó => 0
¡ => !
Pruebas. durante el periodo de integración es posible realizar envíos reales. De esta forma se puede realizar todo tipo de pruebas sin coste.
Ejemplo de Código PHP
<?php
/*
* Programa de ejemplo que usa la libreria api sms para enviar mensajes y para consultar saldo
* Ejemplo PHP. Para verificar libreria CURL use phpinfo()
*
*/
$apikey = “XXXXXXXXXX”;
$apicard = “YYYYYYYYYY”;
$fields_string = “”;
$smsnumber = “999999999”;
$smstext = “Hola mundo”;
$smstype = “0”;
//Preparamos las variables que queremos enviar
$url = ‘SERVER_CLOUD_GAMANET’;
$fields = array(
‘apicard’=>urlencode($apicard),
‘apikey’=>urlencode($apikey),
‘smsnumber’=>urlencode($smsnumber),
‘smstext’=>urlencode($smstext),
‘smstype’=>urlencode($smstype)
);
//Preparamos el string para hacer POST (formato querystring)
foreach($fields as $key=>$value) {
$fields_string .= $key.’=’.$value.’&’;
}
$fields_string = rtrim($fields_string,’&’);
//abrimos la conexion
$ch = curl_init();
//configuramos la URL, numero de variables POST y los datos POST
curl_setopt($ch,CURLOPT_URL,$url);
curl_setopt($ch,CURLOPT_POST,count($fields));
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch,CURLOPT_POSTFIELDS,$fields_string);
//ejecutamos POST
$result = curl_exec($ch);
//cerramos la conexion
curl_close($ch);
//Resultado
$array = json_decode($result,true);
echo “error:”.$array[“message”];
echo “uniqueid:”.$array[“uniqueid”];
?>
Nota:
Cierta información no se presenta aquí por seguridad de la plataforma y nuestros usuarios.
Si todavía no tiene una cuenta, solicita tu Prueba gratis llenando el siguiente formulario de contacto.
Vídeo que Muestra la Fácil Integración del API SMS en PHP
Glosario de términos
GSM
Es el sistema global para las comunicaciones. Sobre esta tecnología se envían todos los mensajes SMS.
API
Significa Application programming interface y establece las reglas y especificaciones para comunicar con la plataforma de mensajería de Gamanet.
HTTP/POST
HTTP es el protocolo de comunicación entre paginas web. Este tipo de invocación POST envía los parámetros de la invocación en el cuerpo de la petición y no en la URL.