1 - The API key
Authentication requires an API key. This key is indispensable because it identifies you to carry out all your requests via our SMS API.
- Log in to your iSendPro Telecom account here
- Then click on the tab "My account" then on the sub-heading "My API"
- Note your API key "xxxxxxxxxxxxxxxxxxxxxxxxxx"
2 - Allow access
IP control improves security by limiting access to your API key. You can either populate a list of allowed IPs, or completely disable IP control.
- Click on the tab "My account" then on the sub-heading "My API"
- In the "Manage IP addresses" section, add the calling IP address or simply disable the IP control.
3 - Make your first call to the API
- Install the isendpro package from the Manager Nuget linked package : visualBasic-client-examples
Sample script for sending a simple SMS :
Imports IO.Swagger.Client
Imports IO.Swagger.Api
Imports IO.Swagger.Model
Module Module1
Sub Main()
Dim iapiclient As ApiClient
Dim keyid As String
Dim ismsapi As SmsApi
keyid = "API_KEY_HERE"
iapiclient = New ApiClient()
'SMS sending
ismsapi = New SmsApi(iapiclient)
Dim susreq = New SmsUniqueRequest()
susreq.Keyid = keyid
susreq.Num = "PHONE_NUMBER_HERE"
susreq.Sms = "This is a one-time test!"
Dim smsreponse As SMSReponse
smsreponse = New SMSReponse()
Try
Console.WriteLine("We forget" + Chr(10))
smsreponse = ismsapi.SendSms(susreq)
Console.WriteLine("json=" + smsreponse.ToJson())
Catch Exc As Exception
Console.WriteLine(Exc.ToString())
End Try
Console.ReadLine()
End Sub
End Module
Here is the expected response after executing this script :
{
"etat":{
"etat":[
{
"code":0,
"tel":"06xxxxxxxx",
"message":"Your message has been sent"
}
]
}
}
4 - Parameters
It is possible to specify different parameters (optional) :
date_envoi | Date in YYYY-MM-DD format hh: mm. Use only in case of delayed sending |
sender | The Sender must be an alphanumeric string between 4 and 11 characters. Accepted characters are numbers between 0 and 9, letters between A and Z and space. It can not consist only of numbers. |
tracker | The tracker must be an alphanumeric string of less than 50 characters. This tracker will then be returned as a urls parameter for return receipts. |
smslong | The maximum number of concatenated SMS you authorize for sending this SMS. The long SMS allows to exceed the limit of 160 characters by sending a message consisting of several SMS. To obtain a dynamic calculation of the number of SMS then you have to fill in smslong = 999 |
ucs2 | It is also possible to send SMS in non-Latin alphabet (Russian, Chinese, Arabic, etc.) on numbers outside mainland France. To do this, the request should be encoded in UTF-8 format and contain the following argument ucs2 = 1 Due to technical constraints, a single SMS can not exceed 70 characters (instead of the usual 160) and in the case of SMS long, each SMS can not exceed 67 characters. |
Example to define the sender in a message : $smsrequest["emetteur"] ="iSendPro";
5 - Technical support
If you have technical questions, please contact support at support@isendpro.com. The support is available every day of the week from 9am to 1pm and from 2pm to 5pm (GMT+1).