Regístrate y prueba AHORA sin compromisos ➜
 ES
Iniciar sesión Regístrate
EN
  • Inicio
  • API SMS

Ejemplos de código en Objective-C para la API SMS de LabsMobile

A continuación se presentan los ejemplos de código de programación en lenguaje Objective-C para enviar mensajes SMS a través de la API de la plataforma LabsMobile.

Esta documentación está diseñada para que puedas conectar tus aplicaciones con la plataforma LabsMobile y automatizar el envío de mensajes SMS. El principal objetivo de la integración de estas aplicaciones es el envío de mensajes SMS y comunicaciones relacionadas.

Consejo Recomendamos utilizar nuestra API SMS http/POST en formato JSON para cualquier integración con la plataforma LabsMobile. Pero tenemos otras versiones API que puedes utilizar según tu entorno y requisitos.

Con estos ejemplos podrás realizar la integración de las siguientes funcionalidades:

  • Enviar mensajes SMS de forma individual o masiva.
  • Consultar el saldo de tu cuenta.
  • Recibir las notificaciones de confirmaciones de entrega y/o error que corresponden a los mensajes enviados.
  • Obtener notificación y datos de los mensajes recibidos en los números virtuales contratados.

La API SMS de LabsMobile utiliza una URL base común para todas las peticiones: https://api.labsmobile.com.

Es altamente recomendable emplear una URL que incluya el protocolo HTTPS en cualquier versión de la API.

La autenticación se realiza con el nombre de usuario y un token API, myUsername:myToken. Debes crear el token API desde la sección Configuración API de tu cuenta.

Enviar SMS con http/POST

Aquí tienes un ejemplo de código en lenguaje Objective-C para enviar mensajes SMS utilizando la API SMS http/POST que utiliza el formato JSON para las variables de intercambio de información.

Como puedes observar, necesitas crear una estructura en formato JSON que contenga todos los parámetros necesarios para el envío y realizar una llamada HTTP/POST con estos datos en el cuerpo de la solicitud.

Envío simple a un único destinatario con http/POST (Objective-C) 
#import <Foundation/Foundation.h>
int main(int argc, const char * argv[]) {
   @autoreleasepool {
       dispatch_semaphore_t sema = dispatch_semaphore_create(0);
      

       NSString *username = @"myUsername";
       NSString *token = @"myToken";
      
       NSString *authString = [NSString stringWithFormat:@"%@:%@", username, token];
       NSData *authData = [authString dataUsingEncoding:NSUTF8StringEncoding];
       NSString *base64AuthString = [authData base64EncodedStringWithOptions:0];
      
       NSDictionary *headers = @{
           @"Content-Type": @"application/json",
           @"Authorization": [NSString stringWithFormat:@"Basic %@", base64AuthString]
       };
      
       NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.labsmobile.com/json/send"]
                                                                 cachePolicy:NSURLRequestUseProtocolCachePolicy
                                                             timeoutInterval:10.0];
       [request setAllHTTPHeaderFields:headers];
       NSData *postData = [[NSData alloc] initWithData:[@"{\r\n \"message\":\"Your verification code is 123\",\r\n  \"tpoa\":\"Sender\",\r\n  \"recipient\":\r\n    [\r\n      {\r\n        \"msisdn\":\"12015550123\"\r\n      }\r\n    ]\r\n}\r\n\r\n" dataUsingEncoding:NSUTF8StringEncoding]];
       [request setHTTPBody:postData];
       [request setHTTPMethod:@"POST"];
      
       NSURLSession *session = [NSURLSession sharedSession];
       NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                                   completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
           if (error) {
               NSLog(@"%@", error);
               dispatch_semaphore_signal(sema);
           } else {
               NSError *parseError = nil;
               NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
               NSLog(@"%@",responseDictionary);
               dispatch_semaphore_signal(sema);
           }
       }];
       [dataTask resume];
       dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
   }
}

Envío masivo a múltiples destinatarios con http/POST (Objective-C) 
#import <Foundation/Foundation.h>
int main(int argc, const char * argv[]) {
   @autoreleasepool {
       dispatch_semaphore_t sema = dispatch_semaphore_create(0);
      

       NSString *username = @"myUSername";
       NSString *token = @"myToken";
      
       NSString *authString = [NSString stringWithFormat:@"%@:%@", username, token];
       NSData *authData = [authString dataUsingEncoding:NSUTF8StringEncoding];
       NSString *base64AuthString = [authData base64EncodedStringWithOptions:0];
      
       NSDictionary *headers = @{
           @"Content-Type": @"application/json",
           @"Authorization": [NSString stringWithFormat:@"Basic %@", base64AuthString]
       };
      
       NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.labsmobile.com/json/send"]
                                                                 cachePolicy:NSURLRequestUseProtocolCachePolicy
                                                             timeoutInterval:10.0];
       [request setAllHTTPHeaderFields:headers];
       NSData *postData = [[NSData alloc] initWithData:[@"{\r\n  \"message\":\"Don't miss our Sale! Use code XXXX123 for 20% off.\",\r\n  \"tpoa\":\"Sender\",\r\n  \"recipient\":\r\n    [\r\n      {\r\n        \"msisdn\":\"12015550123\"\r\n      },\r\n      {\r\n        \"msisdn\":\"12015550124\"\r\n      },\r\n      {\r\n        \"msisdn\":\"12015550125\"\r\n      }\r\n    ]\r\n}\r\n"  dataUsingEncoding:NSUTF8StringEncoding]];
       [request setHTTPBody:postData];
       [request setHTTPMethod:@"POST"];
      
       NSURLSession *session = [NSURLSession sharedSession];
       NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                                   completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
           if (error) {
               NSLog(@"%@", error);
               dispatch_semaphore_signal(sema);
           } else {
               NSError *parseError = nil;
               NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
               NSLog(@"%@",responseDictionary);
               dispatch_semaphore_signal(sema);
           }
       }];
       [dataTask resume];
       dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
   }
}

Resultado positivo 
{
  "subid": "65f33a88ceb3d",
  "code": "0",
  "message": "Message has been successfully sent."
}

Resultado erróneo 
{
  "subid": "65f7f7041385d",
  "code": "35",
  "message": "The account has no enough credit for this sending"
}

Es posible consultar todos los códigos de error en Documentación API, códigos de error.

Para obtener más detalles sobre los parámetros disponibles y las opciones de configuración, consulta la documentación oficial en:

Documentación API SMS http/POST

Enviar SMS con http/GET

Este es un ejemplo de código en lenguaje Objective-C para enviar mensajes SMS utilizando la API SMS http/GET.

Como podrás observar, debes pasar una serie de variables GET en la misma URL y realizar una llamada HTTP. Es importante codificar todos los valores como URL utilizando la función stringByAddingPercentEncodingWithAllowedCharacters.

Importante La API SMS http/GET transmite las credenciales (username y token API) sin cifrar y de forma no segura. Recomendamos utilizar esta API GET sólo cuando sea totalmente imprescindible y utilizar en su lugar la API SMS http/POST.

Envío simple a un único destinatario con http/GET (Objective-C) 
#import <Foundation/Foundation.h>
int main(int argc, const char * argv[]) {
   @autoreleasepool {
       dispatch_semaphore_t sema = dispatch_semaphore_create(0);
      

       NSString *username = @"myUsername";
       NSString *token = @"myToken";
       NSString *message = @"Your verification code is 123";
       NSArray *msisdns = @[@"12015550123"];

      NSString *encodedUsername = [username stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
      NSString *encodedToken = [token stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
      NSString *encodedMessage = [message stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
      NSString *encodedMsisdns = [[msisdns componentsJoinedByString:@","] stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];

      
      
       NSString *urlString = [NSString stringWithFormat:@"https://api.labsmobile.com/get/send.php?username=%@&password=%@&msisdn=%@&message=%@", encodedUsername, encodedToken, encodedMsisdns, encodedMessage];

     
       NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:urlString]
                 cachePolicy:NSURLRequestUseProtocolCachePolicy
                 timeoutInterval:10.0];

       [request setHTTPMethod:@"GET"];
      
       NSURLSession *session = [NSURLSession sharedSession];
       NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                                   completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
           if (error) {
               NSLog(@"%@", error);
               dispatch_semaphore_signal(sema);
           } else {
               NSString *xmlString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
               NSLog(@"%@", xmlString);
               dispatch_semaphore_signal(sema);
           }
       }];
       [dataTask resume];
       dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
   }
}

Envío masivo a múltiples destinatarios con http/GET (Objective-C) 
#import <Foundation/Foundation.h>
int main(int argc, const char * argv[]) {
   @autoreleasepool {
       dispatch_semaphore_t sema = dispatch_semaphore_create(0);
      

       NSString *username = @"myUsername";
       NSString *token = @"myToken";
       NSString *message = @"Don't miss our Sale! Use code XXXX123 for 20% off.";
       NSArray *msisdns = @[@"12015550123",@"12015550124",@"12015550125"];
      
       NSString *encodedUsername = [username stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
       NSString *encodedToken = [token stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
       NSString *encodedMessage = [message stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
       NSString *encodedMsisdns = [[msisdns componentsJoinedByString:@","] stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];

      
       NSString *urlString = [NSString stringWithFormat:@"https://api.labsmobile.com/get/send.php?username=%@&password=%@&msisdn=%@&message=%@", encodedUsername, encodedToken, encodedMsisdns, encodedMessage];

     
       NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:urlString]
                 cachePolicy:NSURLRequestUseProtocolCachePolicy
                 timeoutInterval:10.0];

       [request setHTTPMethod:@"GET"];
      
       NSURLSession *session = [NSURLSession sharedSession];
       NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                                   completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
           if (error) {
               NSLog(@"%@", error);
               dispatch_semaphore_signal(sema);
           } else {
               NSString *xmlString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
               NSLog(@"%@", xmlString);
               dispatch_semaphore_signal(sema);
           }
       }];
       [dataTask resume];
       dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
   }
}

Resultado positivo 
{
  "subid": "65f33a88ceb3d",
  "code": "0",
  "message": "Message has been successfully sent."
}

Resultado erróneo 
{
  "subid": "65f7f7041385d",
  "code": "35",
  "message": "The account has no enough credit for this sending"
}

Es posible consultar todos los códigos de error en Documentación API, códigos de error.

Para obtener más detalles sobre los parámetros disponibles y las opciones de configuración, consulta la documentación oficial en:

Documentación API SMS http/GET

Consulta de saldo de una cuenta

Con este ejemplo de código en Objective-C se puede consultar el saldo de la cuenta utilizando la API SMS de LabsMobile

Mediante una llamada a este endpoint, puedes obtener información sobre la cantidad de créditos disponibles en tu cuenta de LabsMobile. La conexión se establece a través de una solicitud HTTP/GET con autenticación en el encabezado de la conexión HTTP.

Consulta de saldo de una cuenta (Objective-C) 
#import <Foundation/Foundation.h>
int main(int argc, const char * argv[]) {
   @autoreleasepool {
       dispatch_semaphore_t sema = dispatch_semaphore_create(0);
      

       NSString *username = @"myUsername";
       NSString *token = @"myToken";
      
       NSString *authString = [NSString stringWithFormat:@"%@:%@", username, token];
       NSData *authData = [authString dataUsingEncoding:NSUTF8StringEncoding];
       NSString *base64AuthString = [authData base64EncodedStringWithOptions:0];
      
       NSDictionary *headers = @{
           @"Content-Type": @"application/json",
           @"Authorization": [NSString stringWithFormat:@"Basic %@", base64AuthString]
       };
      
       NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.labsmobile.com/json/balance"]
                                                                 cachePolicy:NSURLRequestUseProtocolCachePolicy
                                                             timeoutInterval:10.0];
       [request setAllHTTPHeaderFields:headers];
       NSData *postData = [[NSData alloc] initWithData:[@"" dataUsingEncoding:NSUTF8StringEncoding]];
       [request setHTTPBody:postData];
       [request setHTTPMethod:@"GET"];
      
       NSURLSession *session = [NSURLSession sharedSession];
       NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                                   completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
           if (error) {
               NSLog(@"%@", error);
               dispatch_semaphore_signal(sema);
           } else {
               NSError *parseError = nil;
               NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
               NSLog(@"%@",responseDictionary);
               dispatch_semaphore_signal(sema);
           }
       }];
       [dataTask resume];
       dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
   }
}

Resultado 
{"code":0,"credits":"10"}

Consulta la documentación completa en:

Documentación Consulta de saldo

Recibir estado de mensajes enviados

Este script de ejemplo recibe una llamada por parte de la plataforma LabsMobile cuando un mensaje SMS enviado cambia de estado. Para implementar esta solución, es esencial configurar los parámetros adecuados, la URL de confirmación en el parámetro ackurl en la petición o la URL por defecto en la Configuración API de tu cuenta.

Por tanto, es necesario publicar un script como este en tu sistema para que nuestra plataforma llame a la URL cuando ocurra un cambio de estado en cualquiera de los mensajes enviados.

El código de ejemplo obtiene los parámetros de la URL utilizando la variable global $_GET y luego asigna estos parámetros a variables locales.

Script de recepción de estados de mensajes enviados (Objective-C) 
#import <Foundation/Foundation.h>#import <GCDWebServer/GCDWebServer.h>
@interface MyWebServer : NSObject

@property (nonatomic, strong) GCDWebServer *webServer;

- (void)startServer;

@end

@implementation MyWebServer

- (instancetype)init {
   self = [super init];
   if (self) {
       _webServer = [[GCDWebServer alloc] init];
   }
   return self;
}

- (void)startServer {
   [self.webServer addDefaultHandlerForMethod:@"GET" requestClass:[GCDWebServerRequest class] processBlock:^GCDWebServerResponse *(GCDWebServerRequest *request) {
       NSDictionary *queryParams = request.query;
       NSString *acklevel = queryParams[@"acklevel"];
       NSString *credits = queryParams[@"credits"];
       NSString *msisdn = queryParams[@"msisdn"];
       NSString *status = queryParams[@"status"];
       NSString *subid = queryParams[@"subid"];
       NSString *timestamp = queryParams[@"timestamp"];

       NSLog(@"Variable acklevel : %@", acklevel);
       NSLog(@"Variable credits : %@", credits);
       NSLog(@"Variable msisdn : %@", msisdn);
       NSLog(@"Variable status : %@", status);
       NSLog(@"Variable subid : %@", subid);
       NSLog(@"Variable timestamp : %@", timestamp);

       return [GCDWebServerResponse responseWithStatusCode:200];
   }];

   [self.webServer startWithPort:3000 bonjourName:nil];
   NSLog(@"Server started at port 3000");
}

@end

int main(int argc, const char * argv[]) {
   @autoreleasepool {
       MyWebServer *server = [[MyWebServer alloc] init];
       [server startServer];
       [[NSRunLoop currentRunLoop] run];
   }
   return 0;
}

Consulta la documentación completa en:

Documentación Recepción estados SMS enviados

Recepción de mensajes SMS

Una vez contratado un número virtual, podrás recibir mensajes vía API en una URL específica mediante una llamada HTTP/GET a un script de tu sistema. Cada mensaje recibido invocará la URL, transmitiendo todos sus datos en variables en formato JSON

Para activar esta funcionalidad se debe informar la URL de recepción de mensajes en la Configuración de tu cuenta.

Es necesario configurar un endpoint en tu sistema para que la plataforma LabsMobile llame a este script cuando se reciba un SMS en cualquiera de los números virtuales contratados.

El código de ejemplo obtiene los parámetros de la URL utilizando la variable global $_GET y luego asigna estos parámetros a variables locales

Script de recepción de mensajes recibidos (Objective-C) 
#import <Foundation/Foundation.h>#import <GCDWebServer/GCDWebServer.h>
@interface MyWebServer : NSObject

@property (nonatomic, strong) GCDWebServer *webServer;

- (void)startServer;

@end

@implementation MyWebServer

- (instancetype)init {
   self = [super init];
   if (self) {
       _webServer = [[GCDWebServer alloc] init];
   }
   return self;
}

- (void)startServer {
   [self.webServer addDefaultHandlerForMethod:@"GET" requestClass:[GCDWebServerRequest class] processBlock:^GCDWebServerResponse *(GCDWebServerRequest *request) {
       NSDictionary *queryParams = request.query;
       NSString *inbound_number = queryParams[@"inbound_number"];
       NSString *service_number = queryParams[@"service_number"];
       NSString *msisdn = queryParams[@"msisdn"];
       NSString *message = queryParams[@"message"];
       NSString *timestamp = queryParams[@"timestamp"];

       NSLog(@"Variable inbound_number : %@", inbound_number);
       NSLog(@"Variable service_number : %@", service_number);
       NSLog(@"Variable msisdn : %@", msisdn);
       NSLog(@"Variable message : %@", message);
       NSLog(@"Variable timestamp : %@", timestamp);

       return [GCDWebServerResponse responseWithStatusCode:200];
   }];

   [self.webServer startWithPort:3000 bonjourName:nil];
   NSLog(@"Server started at port 3000");
}

@end

int main(int argc, const char * argv[]) {
   @autoreleasepool {
       MyWebServer *server = [[MyWebServer alloc] init];
       [server startServer];
       [[NSRunLoop currentRunLoop] run];
   }
   return 0;
}

Consulta la documentación completa en:

Documentación Recepción mensajes SMS

Recomendamos consultes y tengas en cuenta los siguientes recursos de soporte en tu integración: