Click here to Skip to main content
Click here to Skip to main content

Developing an App that sends SMS messages

, 15 Feb 2013 CPOL
Rate this:
Please Sign up or sign in to vote.
How great could it be to be able to send SMS messages from your IPhone using the Internet connection

Introduction 

This article explain how to write an iOS App that will use HTTP to send an SMS.  

Background

In my article How to send an SMS from a Desktop Application, I mentioned CardBoardFish, a simple and easy to use API for sending SMS messages world wide.
 

The SendSMS App   

The App is very basic and simple. It has one screen which looks like this:

The SendSMS App Screen 

Basically, you enter the sender's name or number (which could be anything), the country code and phone number of the recipient and a message, and then press "Send".

The messages is then sent, and a confirmation number pops up.

OK Confirmation 

The most important building block of the App is the Send routine (in ViewController.m)  

- (void) send {    
     @autoreleasepool {
        
        NSString *url = [NSString stringWithFormat:@"http://sms1.cardboardfish.com:9001/HTTPSMS?S=H&UN=%@&P=%@&DA=%@%@&SA=%@&M=%@&DC=4", @"<PLACE YOUR USER NAME HERE>", @"<PLACE YOUR PASSWORD HERE", txtCountryCode.text, txtDestinationNo.text, txtName.text,[self stringToHex:txtMessage.text]];
        
        url = [url stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
        NSLog(@"url %@", url);
        
        NSError* connError = 0;
        NSURLResponse* response;
        
        NSURLRequest* request = [NSURLRequest requestWithURL:[NSURL URLWithString:url] cachePolicy:NSURLRequestReloadIgnoringCacheData timeoutInterval:20];
        
        NSData* data = [ NSURLConnection sendSynchronousRequest:request returningResponse:&response error:&connError ];
        NSString* resp = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"response: %@", resp);
         

 

Interfacing with the device's Address Book

In order to easily select existing contacts from your IPhone, the openContacts routine is used, which uses a Class named ABPeoplePickerNavigationController which according to Apple, "implements a view controller that manages a set of views that allow the user to select a contact or one of its contact-information items from an address book". 

- (IBAction)openContacts:(id)sender {
    
    ABPeoplePickerNavigationController *picker = [[ABPeoplePickerNavigationController alloc] init];
    picker.peoplePickerDelegate = self;
    NSArray *displayedItems = [NSArray arrayWithObjects:[NSNumber numberWithInt:kABPersonPhoneProperty], 
                               [NSNumber numberWithInt:kABPersonEmailProperty],
                               [NSNumber numberWithInt:kABPersonBirthdayProperty], nil];
    
    picker.displayedProperties = displayedItems;
    [self presentModalViewController:picker animated:YES];
    [picker release];
} 

 After an entry from the Address Book is selected, we perform some basic cleansing on it, such as removing leading zeros and spaces, dashes and brackets. So the number "(04) 888-3333" becomes "48883333" which is the required format for the SDK.

- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker shouldContinueAfterSelectingPerson:(ABRecordRef)person 
<span class="Apple-tab-span" style="white-space: pre; ">								</span>property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
{
    NSString* phone = nil;
    ABMultiValueRef phoneNumbers = ABRecordCopyValue(person,
                                                     property);
    if (ABMultiValueGetCount(phoneNumbers) > 0) {
        phone = (__bridge_transfer NSString*)
        ABMultiValueCopyValueAtIndex(phoneNumbers, identifier);
    } else {
        phone = @"[None]";
    }
    phone = [phone stringByReplacingOccurrencesOfString:@"(" withString:@""];
    phone = [phone stringByReplacingOccurrencesOfString:@")" withString:@""];
    phone = [phone stringByReplacingOccurrencesOfString:@"-" withString:@""];
    phone = [phone stringByReplacingOccurrencesOfString:@" " withString:@""];
    
    if ([[phone substringWithRange:NSMakeRange(0, 1)] isEqual:@"0"] ) {
        phone = [phone substringFromIndex:1];
    }
    
    txtDestinationNo.text = phone;
    [self dismissModalViewControllerAnimated:YES];
    
    
<span class="Apple-tab-span" style="white-space: pre; ">	</span>return NO;
}

 

Country Flags 

A nice part I have added is a list of countries along with each country's flag. Not really necesary through... I used 226 flag .PNG images named as the country code of each flag, so 49.png holds the German flag, and so on...  

The Country Code Selector 

Then CountryCodesViewController.m source file looks like this: 

#import "CountryCodesViewController.h"
@interface CountryCodesViewController ()
@end
@implementation CountryCodesViewController
@synthesize mainViewController;
- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil
{
    self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
    if (self) {
        // Custom initialization
    }
    return self;
}
- (void)viewDidLoad
{
    [super viewDidLoad];
    // Do any additional setup after loading the view from its nib.
    NSString *sourcePath = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"Flags"];
    countryCodes = [[NSFileManager defaultManager] contentsOfDirectoryAtPath:sourcePath error:NULL];
    [countryCodes retain];
}
- (void)viewDidUnload
{
    [tblCountryCodes release];
    tblCountryCodes = nil;
    [super viewDidUnload];
    // Release any retained subviews of the main view.
    // e.g. self.myOutlet = nil;
}
- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation
{
    return (interfaceOrientation == UIInterfaceOrientationPortrait);
}
- (void)dealloc {
    [tblCountryCodes release];
    [super dealloc];
}
#pragma mark UITableView methods
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return [countryCodes count];    
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    
    UITableViewCell *cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:nil] autorelease];
    
    NSString *strFlagName = [countryCodes objectAtIndex:indexPath.row];
    
    
    cell.textLabel.text = [strFlagName substringToIndex:[strFlagName length] - 4];
    
    cell.imageView.image = [UIImage imageNamed:[NSString stringWithFormat:@"Flags/%@",strFlagName]]; 
    
    return cell;
    
}
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
    NSString *strFlagName = [countryCodes objectAtIndex:indexPath.row]; 
    
    [mainViewController selectCountryCode:[strFlagName substringToIndex:[strFlagName length] - 4]];
    
    [tableView deselectRowAtIndexPath:indexPath animated:NO];
    
    [self dismissModalViewControllerAnimated:YES];
    
}
- (IBAction)okPressed:(id)sender {
    [self dismissModalViewControllerAnimated:YES];
}
@end 

Error Handling  

When an error occours, an error code appears indicating the nature of the error. The HTTPSMS SDK documentation explains each error number. 

There can be several scenarios in which the transmission fails. 

The first one is Connectivity Error. Such error can occour if the IPhone is not connected to the Internet. In such case, we would like to alert the user, and yet, place the SMS in a queue to be sent when the IPhone connects to the Internet. We also would like that in case several SMS messages were composed during the time the device was offline, they will all be placed in the queue and transmitted whenever possible. 

This example does not perform any logical error checks (such as validating the format of the phone number, country code, etc. and in any case, only after a message is sent to the Web Service, there might be additional error codes that will raise. 

 

        
        if ( connError ) {
            NSLog(@"%@",[connError description]);
            
            NSMutableDictionary *message = [[NSMutableDictionary alloc] init];
         
            [message setValue:txtCountryCode.text forKey:@"countryCode"];
            [message setValue:txtDestinationNo.text forKey:@"destinationNo"];
            [message setValue:txtName.text forKey:@"name"];
            [message setValue:txtMessage.text forKey:@"message"];
            
            [self performSelectorOnMainThread:@selector(addToQueue:) withObject:message waitUntilDone:NO];
            [message release];
            UIAlertView* alert = [[UIAlertView alloc] init];
            alert.title = @"Send SMS";
            alert.message = @"Can't access Internet. The message will be queed to be sent later";
            [alert addButtonWithTitle:@"Ok"];
            [alert show];
            [alert release];
            
            
        } else {
            UIAlertView* alert = [[UIAlertView alloc] init];
            alert.title = @"Send SMS";
            alert.message = resp;
            [alert addButtonWithTitle:@"Ok"];
            [alert show];
            [alert release];
            
            if ([resp rangeOfString:@"OK"].location != NSNotFound) {
                [self performSelectorOnMainThread:@selector(sendComplete) withObject:nil waitUntilDone:YES];
            }
            
        }
        
        [resp release];
    }    
    
    loadingView.hidden = YES;
}   

 

Further Reading

How to send an SMS from a Desktop Application

Points of Interest  

If you need help getting started with iOS development, please contact me to haephrati <at> gmail <dot> com or read this article

 

 Michael Haephrati CodeProject MVP 2013    

 

 

 

 

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Michael N. Haephrati
CEO
United States United States
Michael Haephrati, is an entrepreneur, inventor and a musician. Haephrati worked on many ventures starting from HarmonySoft, designing Rashumon, the first Graphical Multi-lingual word processor for Amiga computer. During 1995-1996 he worked as a Contractor with Apple at Cupertino. Worked at a research institute made the fist steps developing the credit scoring field in Israel. He founded Target Scoring and developed a credit scoring system named ThiS, based on geographical statistical data, participating VISA CAL, Isracard, Bank Leumi and Bank Discount (Target Scoring, being the VP Business Development of a large Israeli institute).

During 2000, he founded Target Eye, and developed the first remote PC surveillance and monitoring system, named Target Eye.

Other ventures included: Data Cleansing (as part of the DataTune system which was implemented in many organizations.


Follow on   Twitter   Google+   LinkedIn

Comments and Discussions

 
GeneralMy vote of 5 PinprofessionalAmol_B25-Jul-13 0:58 
GeneralMy vote of 5 Pingroupalonbarak14-Jun-13 12:03 
GeneralRe: My vote of 5 PinmvpMichael Haephrati4-Jul-13 3:12 
GeneralMy vote of 5 PinmemberSudhakar Shinde12-Apr-13 2:24 
GeneralRe: My vote of 5 PinmvpMichael Haephrati12-Apr-13 2:27 
Thanks!
GeneralMy vote of 5 Pinmemberliliflower35525-Jan-13 2:10 
GeneralMy vote of 5 Pinmemberresi243125-Jan-13 1:10 
GeneralMy vote of 5 Pinmembermidulm25-Jan-13 0:05 
GeneralMy vote of 5 Pingroupbalam198824-Jan-13 23:20 
GeneralMy vote of 5 Pingroupevan89724-Jan-13 22:41 
GeneralMy vote of 5 PinmemberJohn Klinner24-Jan-13 20:49 
GeneralMessage Automatically Removed PinmemberPJohnMathews23-Jan-13 23:18 
GeneralMy vote of 5 PinmemberRutuanie23-Jan-13 0:13 
GeneralMy vote of 5 PinmemberJohn Klinner19-Jan-13 22:51 
GeneralMy vote of 5 PinmemberHillary Higg19-Oct-12 21:26 
GeneralMy vote of 5 PinmemberGeorge Rogers II13-Oct-12 7:38 
GeneralMy vote of 5 PinmemberEmma20123217-Sep-12 7:45 
QuestionAPI to decode a received SMS Pinmembergvascon115-Sep-12 11:41 
AnswerRe: API to decode a received SMS PinmemberMatan joice15-Sep-12 12:31 
AnswerRe: API to decode a received SMS PinmemberMichael Haephrati16-Sep-12 0:34 
GeneralMy vote of 5 PinmemberJohnBergen25-Jul-12 0:41 
GeneralMy vote of 5 PinmemberMatan joice10-Jun-12 8:25 
GeneralMy vote of 5 PinmemberMember 43208449-Jun-12 9:02 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.141220.1 | Last Updated 16 Feb 2013
Article Copyright 2012 by Michael N. Haephrati
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid