Categories
How To ...

Getting Started with our Free SMS API

Requests to our SMS API are sent to the following URL:
https://yegara.com/sms/transactional/v1

Request ParameterExplanation
userThe cPanel Username
PINYour PIN to access the API, available in manage Section of your domain
phoneThe users’ phone number you want to send the SMS to, It Must start with ’09’
templateThe transactional SMS Template Number you want to send

Transactional SMS Templates

Your SMS content must match a template that has been pre-approved when sending from our free numbers. All templates are listed below. If you need to compose your message consider using your own phone number.

TempleteContent
1
%Your Domain Name%
Your verification code is: %verification Code%
Example

ETHIOPIAIS.COM
Your verification code is : 628381
2%Your Domain Name%
Dear User, OTP to complete your registration process is: %verification Code%
Example

ETHIOPIAIS.COM
Dear User, OTP to complete your registration process is: : 628381
3
%Your Domain Name%
Your One time password (OTP) for Login is: %verification Code%
This can be used only once and is valid for 60 minutes. Please do not share this with anyone
Example

ETHIOPIAIS.COM
Your One time password (OTP) for Login is: 628381
This can be used only once and is valid for 60 minutes. Please do not share this with anyone
4
Welcome to %Your Domain Name%
For any support or query please contact %Phone Number%
Example

Welcome to ETHIOPIAIS.COM
For any support or query please contact 0960171717
5%Your Domain Name%
Thank you for contacting us. We will get back to you soon
Example

ETHIOPIAIS.COM
Thank you for contacting us. We will get back to you soon
6%Your Domain Name%
Yes! You did it. We hope you love your purchase. We will keep in touch with updates. Thank you!
Example

ETHIOPIAIS.COM
Yes! You did it. We hope you love your purchase. We will keep in touch with updates. Thank you!

Using OTP sms
Template ( 1, 2 & 3 )

If sending OTP SMS, the following parameters should be included:

ParameterExplanation
otpThe OPT /authentication code you want to send the user. it must be between 3-6 characters and contain only numbers

Request Example

https://yegara.com/sms/transactional/v1?template=1&phone=0960171717&otp=123456&user=username&pin=123456

Using Welcome sms
Template ( 4 )

If sending Welcome sms, the following parameters should be included:

ParameterExplanation
contactThe phone number To include in the message. It must start ’09’

Request Example

https://yegara.com/sms/transactional/v1?template=4&phone=0960171717&contact=0960171717&user=username&pin=123456

Using Thank you SMS
Template ( 5 & 6 )

If sending Thank you sms, No Parameter is required

Request Example

https://yegara.com/sms/transactional/v1?template=5&phone=0960171717&user=username&pin=123456

SMS Pricing

Number FromSetup FeePrice SMS
Free NumberFREEFREE
Your Own Mobile Number3,000 ETB
Alphanumeric3,000 ETB3 ETB

Free Number: we provide a pool of free Random numbers (eg +25194011xxxx ) you can use these for free as long as you have an active account with us. You can send up to 100 SMS per Month Free.

Own Number: You can also use your own phone number like we do to communicate with your customers. You will also have the freedom to send any type of SMS message. Your sms charge will be applied to your phone and standard ethiotelecom sms fee apply

Alphanumeric Sender ID: allows you to set your company name or brand as the Sender ID when sending one-way SMS messages. Users will not be able to reply to you.

Recommendation

From our experience and using SMS to communicate with our customers we recommend you use your own phone number. This gives you opportunities other numbers don’t provide

  • Users Can call you or text you back on the same number to contact you or request more information
  • No negative Stigma associated with Short Codes ( 81xx )

Need Help?

If you need help to integrate the SMS with your existing website please contact us on telegram and we will help you get started.

One reply on “Getting Started with our Free SMS API”

Leave a Reply

Your email address will not be published.