{"id":560,"date":"2017-06-08T14:08:19","date_gmt":"2017-06-08T14:08:19","guid":{"rendered":"http:\/\/devser.net\/moveoapps-redesign\/blog\/?p=560"},"modified":"2019-09-25T11:19:58","modified_gmt":"2019-09-25T11:19:58","slug":"how-to-implement-phone-number-verification-with-sinch-sdk-in-ios","status":"publish","type":"post","link":"https:\/\/www.moveoapps.com\/blog\/how-to-implement-phone-number-verification-with-sinch-sdk-in-ios\/","title":{"rendered":"How to implement Phone Number Verification with Sinch SDK in iOS – A Quick Guide"},"content":{"rendered":"

Phone number <\/span>verification (or validation) services are online services used to check whether or not a given phone number is in service. Several companies provide SDKs or APIs to integrate this functionality on mobile platforms (iOS\/Android).<\/span><\/p>\n

Sinch<\/span><\/a> is platform which provides phone verification, messaging, voice calling and video calling services on mobile platforms. In this article, we will discuss phone number verification.<\/p>\n

There are two types of verification methods provided by Sinch for iOS:<\/span><\/p>\n

<\/b>1) SMS Verification: <\/b>A one-time pin code will be sent to the phone number via SMS. Sinch can verify the user\u2019s phone number with that pin code.<\/span><\/p>\n

2) Voice\/Callout Verification:<\/b> An automated voice verification call is made to the user and a voice prompt is made via text-to-speech. An appropriate response to the voice prompt determines if the phone number is in service.<\/span><\/p>\n

We will now learn about SMS verification programming. For this, first create an app on Sinch Developer account. <\/span><\/p>\n

Create App on Sinch<\/b><\/span>
\n<\/span><\/h3>\n

Upon registration, you will be asked to create a new app. This is where you need to provide an application name and description.<\/span><\/p>\n

\"Create<\/span><\/p>\n

After this, you will be asked to specify the task you want to perform \u2013 verification or calling. Select \u2018#VERIFICATION.\u2019<\/span><\/p>\n

\"Select<\/p>\n

Finally, you will be asked to specify the platform. Select \u2018iOS.\u2019<\/span><\/p>\n

\"Select<\/p>\n

Application credentials are available on Sinch Dashboard, which will be used in the code. Hostname, Key and Secret will be used inside the Xcode project.<\/span><\/p>\n

\"Sinch<\/p>\n

Setup Sinch SDK in Xcode<\/b><\/span><\/h3>\n

Install through CocoaPods<\/b>
\n<\/span><\/p>\n

Install Sinch via CocoaPods (pod ‘SinchVerification’ or pod ‘SinchVerification-Swift’) or download it on https:\/\/www.sinch.com\/downloads\/<\/a><\/span><\/p>\n

Pod File coded as follows:
\n<\/span><\/p>\n

Objective-C<\/i><\/span><\/p>\n

# Uncomment the next line to define a global platform for your project\r\nplatform :ios, '9.0'\r\n\r\ntarget 'SinchVerificationObjC' do\r\n  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks\r\n  # use_frameworks!\r\n\r\n  # Pods for SinchVerificationObjC\r\n\r\n    pod 'SinchVerification'\r\n\r\nend\r\n<\/pre>\n
Swift<\/i><\/span><\/p>\n
# Uncomment the next line to define a global platform for your project\r\nplatform :ios, '9.0'\r\n\r\ntarget 'SinchVerificationSwift' do\r\n  # Comment the next line if you're not using Swift and don't want to use dynamic frameworks\r\n  use_frameworks!\r\n\r\n  # Pods for SinchVerificationSwift\r\n\r\n    pod 'SinchVerification-Swift'\r\n\r\nend<\/pre>\n
Read also:Decoding Xcode 9 \u2013 7 Things You Should Be Aware Of<\/a><\/p><\/blockquote>\n
Let\u2019s Learn about SMS Verification by Sinch<\/b><\/span><\/h3>\n
Verification of a phone number is performed in two steps, a verification SMS is requested and a verification code (a 4-digit pin number) for that particular verification session is sent to the recipient via SMS. It\u2019s the responsibility of the developer to ask the end-user to provide the verification code from the SMS.<\/span><\/p>\n
Request for SMS Verification:<\/b><\/p>\n
For this process, you have to create an object of Sinch Verification and use that object to initialize the verification process.<\/p>\n
For the request you have to pass\u00a0two parameters with the function\u00a0\u2013 (a). The Sinch Application Key from credentials of app, which is available on the Sinch dashboard, and (b). The formatted phone number, like (+xx xxxxxxxxxx). If you don\u2019t provide a properly formatted phone number, the Sinch verification throws a specific error (In the sample code below, I have displayed error in alert).<\/span><\/p>\n
Declaration:<\/p>\n
Objective-C<\/i><\/span><\/p>\n
#import \r\n\r\n@interface PhoneNumberEntryVC : UIViewController {\r\n    id _verification;\r\n}\r\n<\/pre>\n
Swift<\/i><\/span><\/p>\n
import SinchVerification\r\n<\/span>\r\nclass PhoneNumberEntryVC: UIViewController {<\/span>\r\n\u00a0 \u00a0 <\/span>var verification : Verification!<\/span>\r\n}<\/span><\/pre>\n
Initialization:<\/span><\/p>\n
Objective-C<\/i><\/span><\/p>\n
_verification = [SINVerification SMSVerificationWithApplicationKey:@\"SINCH API KEY\" phoneNumber:@\"PHONE NUMBER\"];\r\n[_verification initiateWithCompletionHandler:^(id  _Nonnull result, NSError * _Nullable error) {\r\n    if (result.success == YES) {\r\n        \/\/Process the flow and display UI for verification of code\r\n    }\r\n    else {\r\n        UIAlertController *alertVC = [UIAlertController alertControllerWithTitle:@\"\" message:error.localizedDescription preferredStyle:UIAlertControllerStyleAlert];\r\n        [alertVC addAction:[UIAlertAction actionWithTitle:@\"Ok\" style:UIAlertActionStyleCancel handler:nil]];\r\n        [[UIApplication sharedApplication].keyWindow.rootViewController presentViewController:alertVC animated:YES completion:nil];\r\n    }\r\n}];<\/pre>\n
Swift<\/i><\/p>\n
verification = SMSVerification(\"SINCH API KEY\", phoneNumber: \"PHONE NUMBER\")\r\nverification.initiate { (initiationResult, error) in\r\n    if initiationResult.success == true {\r\n        \/\/Process the flow and display UI for verification of code\r\n    }\r\n    else {\r\n        let alertVC = UIAlertController(title: \"\", message: error?.localizedDescription, preferredStyle: UIAlertControllerStyle.alert)\r\n        alertVC.addAction(UIAlertAction(title: \"Ok\", style: UIAlertActionStyle.cancel, handler: nil))\r\n        UIApplication.shared.keyWindow!.rootViewController!.present(alertVC, animated: true, completion: nil)\r\n    }\r\n}\r\n<\/pre>\n
With the above code, you will get an SMS on the provided phone number, containing the verification code (generally a 4-digit number).<\/span><\/p>\n
\"SMS\"<\/p>\n
Validation of verification code:<\/b><\/span><\/p>\n
To complete verification of the phone number, the user has to enter the code from the SMS into the application. <\/span><\/p>\n
For validation, you have to enter the code which is SMSed to your phone. This code will be passed to the object we created in the first screen. So, if you are managing two screens for this process, then you have to pass the first screen object to the second screen.<\/span><\/p>\n
Objective-C<\/i><\/span><\/p>\n
[self.verification verifyCode:@\"VERIFICATION CODE\" completionHandler:^(BOOL success, NSError* error) {\r\n if (success) {\r\n \/\/ Phone number was successfully verified, do further process.\r\n } else {\r\n \/\/ Ask user to re-attempt verification\r\n UIAlertController *alertVC = [UIAlertController alertControllerWithTitle:@\"\" message:error.localizedDescription preferredStyle:UIAlertControllerStyleAlert];\r\n [alertVC addAction:[UIAlertAction actionWithTitle:@\"Ok\" style:UIAlertActionStyleCancel handler:nil]];\r\n [[UIApplication sharedApplication].keyWindow.rootViewController presentViewController:alertVC animated:YES completion:nil];\r\n }\r\n}];<\/pre>\n
Swift<\/i><\/p>\n
verification.verify(\"VERIFICATION CODE\") { (isSuccess, error) in\r\n if isSuccess == true {\r\n \/\/ Phone number was successfully verified, do further process.\r\n }\r\n else {\r\n let alertVC = UIAlertController(title: \"\", message: error?.localizedDescription, preferredStyle: UIAlertControllerStyle.alert)\r\n alertVC.addAction(UIAlertAction(title: \"Ok\", style: UIAlertActionStyle.cancel, handler: nil))\r\n UIApplication.shared.keyWindow!.rootViewController!.present(alertVC, animated: true, completion: nil)\r\n }\r\n}<\/pre>\n
The SMS verification process is done! You can now display to users that they have successfully verified their phone number.<\/span><\/p>\n\n\n\n
\"\"<\/td>\n\"\"<\/td>\n\"\"<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Note: Your user interface design should be like this.<\/i><\/span><\/p>\n
Let\u2019s Learn about Voice\/Callout Verification by Sinch<\/b><\/span><\/h3>\n
Verification of phone number with Callout is performed in only one step. A call will be requested with phone number. Voice verification will call to a user\u2019s phone and play a voice to verify the user. User will be asked to act as per instructions on call.
\n<\/span><\/p>\n
Similar to SMS verification, Sinch provides functionality to initialize verification object by call functionality. You have to enter the Sinch API key and formatted phone number.<\/span><\/p>\n
Initialize the verification object by callout verification.<\/p>\n
Objective-C<\/i><\/p>\n
_verification = [SINVerification calloutVerificationWithApplicationKey:SINCH_APP_KEY phoneNumber:@\"PHONE NUMBER\"];<\/pre>\n
Swift <\/i><\/span><\/p>\n
verification = CalloutVerification(SINCH_APP_KEY, phoneNumber: \"PHONE NUMBER\")<\/pre>\n
After the initialization of verification, initiate the verification process.<\/span><\/p>\n
Objective-C<\/i>
\n<\/span><\/p>\n
[_verification initiateWithCompletionHandler:^(id _Nonnull result, NSError * _Nullable error) {\r\n if (result.success == YES) {\r\n \/\/ Phone number was successfully verified, do further process.\r\n }\r\n else {\r\n UIAlertController *alertVC = [UIAlertController alertControllerWithTitle:@\"\" message:error.localizedDescription preferredStyle:UIAlertControllerStyleAlert];\r\n [alertVC addAction:[UIAlertAction actionWithTitle:@\"Ok\" style:UIAlertActionStyleCancel handler:nil]];\r\n [[UIApplication sharedApplication].keyWindow.rootViewController presentViewController:alertVC animated:YES completion:nil];\r\n }\r\n}];<\/pre>\n
Swift<\/i><\/span><\/p>\n
verification.initiate { (initiationResult, error) in\r\n if initiationResult.success == true {\r\n self.performSegue(withIdentifier: \"pushToSuccessVC\", sender: nil)\r\n }\r\n else {\r\n let alertVC = UIAlertController(title: \"\", message: error?.localizedDescription, preferredStyle: UIAlertControllerStyle.alert)\r\n alertVC.addAction(UIAlertAction(title: \"Ok\", style: UIAlertActionStyle.cancel, handler: nil))\r\n UIApplication.shared.keyWindow!.rootViewController!.present(alertVC, animated: true, completion: nil)\r\n }\r\n}<\/pre>\n
If the phone number formatting is not done properly, or the phone number field is empty or the callout verification is not verified on the user\u2019s phone, you will get an error.<\/span><\/p>\n
You can say it is a one-step authorization process. Callout Verification process is now complete! You can display to users that they have successfully verified their number.<\/span><\/p>\n\n\n\n
\"\"<\/td>\n\"\"<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Note: Your user interface design should be like this.<\/i><\/span><\/p>\n
Reports of Verification<\/b><\/span><\/h3>\n
Reports are available on the Sinch dashboard. Log in with your account and find the reports as well as charts for the verification, voice, messages, and more. <\/span><\/p>\n
\"Reports\"<\/p>\n
That\u2019s it! This is how you can perform SMS verification and Callout verification using Sinch.
\n<\/span><\/p>\n
Hope you liked the article. <\/span><\/p>\n
Happy Coding!<\/span><\/p>\n
Read also:Migrating Your Objective-C Programs to Swift \u2013 A Simplified Guide for iOS Developers<\/a><\/p><\/blockquote>\n