 API - Gateway
Nuestro servicio de CreaSMS, ofrecemos la posibilidad de que pueda integrar el envío de SMS en tus aplicaciones. Disfruta de una integración sencilla y rápida para enviar tus mensajes SMS por ejemplo, a sus clientes.
Gracias a nuestro servicio SMS API, podrás automatizar el envío de mensajes SMS integrando el servicio de envío directamente en tus aplicaciones comerciales, sitios web u otro software.
Disponemos de varios lenguajes de programación para que utilice la manera que más le convenga. Ofrecemos el código PHP, HTTP/S Y FTP, no obstante nuestra API es válida para cualquier lenguaje. ASP, .NET, Visual, etc.
 PHP
Implemente el envío de SMS, utilizando el código PHP siguiente:
Código Ejemplo:
<?php
$user = "user";
$password = "password";
$baseurl ="https://www.creasms.com";
$mensaje = urlencode("mensaje de ejemplo de sms");
$pais = "34";
$movil = "0123456789";
$remitente = "Remiente";
$url = "$baseurl/externo/enviar.php?usuario=$user&clave=$password&pais=$pais&movil=$movil&
remitente=$remitente&mensaje=$mensaje";
$resultado=@file_get_contents($url);
/*
los valores retornados pueden ser
1 Todo esta correcto, se ha realizado el envío.
-5 No tiene Activado envios Externos.
-10 Ip No válida.
-15 Error de autentificación.
-20 No dispone de Créditos suficientes para realizar el envío.
-25 No es posible enviar el sms a ese Pais.
-30 El número al que desea enviar, es incorrecto.
-35 El Remitente que desea usar, no esta activo o validado.
-40 El texto a enviar es superior al permitido (160)
-100 Error Genérico, faltan parametros o error desconocido.
*/
if ($resultado==1){
echo "Mensaje Enviado!";
} else {
//algun error
echo "Error : $resultado";
};
?>
|
 HTTP/S
La pasarela HTTP forma parte de la infraestructura que Creasms.com le ofrece para el envío de mensajes cortos a móviles (SMS) a través de protocolos estándar de Internet. Puede usar esta pasarela como medio de comunicación para sus propias aplicaciones, o como medio para enviar mensajes desde una página web.
La pasarela HTTP/S se comporta como un CGI. Recibe las variables por el método GET, y una vez validada la operación, inicia el proceso del mensaje. A su vez, responde con una confirmación del proceso.
Detalles técnicos
El método de envío de los datos debe ser GET. La pasarela requiere las siguientes variables:
usuario: el nombre de usuario validado por creaSMS.com
clave: password para validar el acceso al servicio.
pais: Pais de teléfono de destino. El código Internacional del pais. Ejemplo: España = 34.
numero: Número de teléfono de destino. No requiere el código de país. Ejemplo: 600123456.
remitente: El remitente del SMS con el que se enviará el sms.
mensaje: Texto del mensaje a enviar al número de teléfono definido en el campo numero. La longitud máxima de este campo debe ser 160 caracteres, para sms normales y 100 para sms con publicidad.
La llamada es muy simple y fácil, solo debe hacer una llamada a la siguiente url.
https://www.creasms.com/externo/enviar.php?usuario=usuario &clave=clave&pais=pais&movil=numeromovil&remitente=remitente_autorizado&
mensaje=mensaje que quieres enviar
|
Si desea ocultar su clave en el codigo fuente puede utilizar el asistente que le encriptará su clave, para esto en su panel de control, en la opción de Envios Externos, podrá ver un código similar a este:
La llamada es muy simple y fácil, solo debe hacer una llamada a la siguiente url.
https://www.creasms.com/externo/enviar.php?usuario=usuario &encripta=1&clave=suclaveencriptada&pais=pais&movil=numeromovil &remitente=remitente_autorizado&mensaje=mensaje que quieres enviar
|
RESPUESTAS DEL ENVÍO A LA PETICIÓN REALIZADA:
1 Todo esta correcto, se ha realizado el envío.
-5 No tiene Activado envios Externos.
-10 Ip No válida.
-15 Error de autentificación.
-20 No dispone de Créditos suficientes para realizar el envío.
-25 No es posible enviar el sms a ese Pais.
-30 El número al que desea enviar, es incorrecto.
-35 El Remitente que desea usar, no esta activo o validado.
-40 El texto a enviar es superior al permitido (160)
-100 Error Genérico, faltan parametros o error desconocido.
 FTP
La conexión por FTP , es ideal para el envío de un gran volúmen de SMS con un largo periodo de entrega. Los mensajes que usted suba a nuestro servidor de FTP, serán enviados a los números indicados . Además, CreaSMS crea un archivo de registro de la historia en su cuenta de usuario con los datos de estado de todos los mensajes enviados.
¿Qué se puede hacer cuando se conecta a través de FTP:
La conexión FTP soporta texto
Le da soporte para aplicaciones que desee crear con ftp.
Genera un sms por cada fichero que suba al FTP.
Podrá programar el envío de los mensajes para los días que necesite.
Cómo subir los ficheros por FTP:
Regístrese en CreaSMS.com para obtener una cuenta de Usuario y se le dará un nombre de usuario, contraseña.
Pongase en Contacto Con nosotros para aplicarle el Servicio de FTP.
Una vez le indiquemos sus datos de ftp, debe preparar los mensajes que desea enviar al crear un archivo de texto en este formato:
<sms>
<usuario>su codigo de usuario</usuario>
<clave>su clave</clave>
<remitente>remitente que desee</remitente>
<pais>pais en numerico</pais>
<movil>movil al que enviar</movil>
<mensaje>texto del mensaje</mensaje>
<fecha_envio>12-12-2025</fecha_envio>
<hora_envio>23:57:00</hora_envio>
</sms>
Debe guardar el fichero en formato de texto, llamandolo como desee, pero con extensión .txt. Si no tiene exta extensión el sistema ignorara los sms.
Puede Llamarlo por ejemplo suempresasms321423.txt o como prefiera pero siempre en formato texto, con esta extensión.
Si se quisiera otra extensión o formato deberá contactar con nuestro departamento de desarrollo.
|
|
