Developers and More

  • Home
  • >
  • Developers and More

Getting Started with API

elfoA2P is a powerful SMS messaging platform that provides a robust set of APIs for developers to integrate seamless SMS capabilities into their applications. The elfoA2P Developers Documentation is a comprehensive resource that outlines the various APIs, endpoints, and data models available for developers to leverage the platform’s functionalities effectively.

In this article, we’ll explore the key features and components of the elfoA2P Developers Documentation, helping you get started with the platform and enabling you to build innovative SMS-based solutions.

Generating API Keys

This section provides instructions on how to generate a valid API key, which is essential for authenticating and authorizing API requests: https://apis-a2p.elfo.com

Note: the provided BASE_URL (https://apis-a2p.elfo.com) for making API requests.

To use these API, you need a valid and active API key. Please generate one from your API Credentials at elfoA2P.


Response Object Structure:

This section outlines the standardized format of the API responses from elfoA2P, ensuring consistency and ease of understanding. It explains the structure of the response object, including the status code, message, error flag, data payload, and pagination data (if applicable).

All API responses will be sent with 200 HTTP response status code, and the actual status code will be represented using a status code key in the response object itself.

KeyTypeDescription
status_codeIntegerThe status code of response: (200, 400, 401, 404, 500).
messageStringA string message to explain the response.
errorBooleanA flag to identify errors in the response.
codeIntegerA code that uniqely identify each response message.
dataObjectAn object or array of objects corresponsing the requested resources. null in case of error.
pagination_dataObjectAn object only sent for listing API endpoints for pagination data.
We will always mention in the success response sample.

WEBHOOK SMS NOTIFICATION URL:

At elfoA2P, we understand the importance of keeping you informed about the status of your SMS messages in real-time. That’s why we’ve introduced the Webhook SMS Notification feature, which allows you to receive instant updates whenever the status of an SMS message changes.

Developers can set up a Webhook SMS Notification URL to receive real-time updates when the status of an SMS changes, allowing for timely updates on SMS delivery statuses.

While creating your API Key, you can now add an SMS Webhook Notification URL that will be used to send the SMS status notification for the Send Single SMS flow only.

How It Works

  1. Set up Your Webhook URL: When creating or updating your API Key in your account, you’ll find an input field for the “SMS Webhook Notification URL.” This is where you’ll provide the URL that elfoA2P will use to send you SMS status notifications for the “Send Single SMS” flow.
  2. Receive Notifications: Once elfoA2P has an updated status for one of your SMS messages, our system will make a POST API call to the Webhook URL you’ve provided. This call will be authorized with your API Key, which will be sent in the Authorization header, allowing you to secure the incoming requests on your end.
  3. Notification Payload: The body of the API call will contain the following information:

{
  "sms_id": "The ID of this SMS",
  "status": "Check the possible statuses in the SMS Object"
}

The sms_id field represents the unique identifier of the SMS message, and the status field indicates the current status of the SMS message. You can find the list of possible status values in the “SMS Object” section of our documentation.

  • Updating Your Webhook URL: If you update your Webhook Notification URL in your account settings, elfoA2P will update all the SMS records in our system that haven’t been notified yet, ensuring that you receive notifications with the latest URL.
  • Single Notification: Please note that the Webhook URL will be called only once for each SMS message. Therefore, it’s crucial to ensure that the URL is working correctly before adding it to your account settings.

By setting up the Webhook SMS Notification feature, you’ll always be in the loop regarding the delivery status of your SMS messages, allowing you to take appropriate actions and provide a seamless experience to your customers.

SEND A SINGLE SMS

SENDING A SINGLE SMS:

To send a single SMS message, you need to make a POST request to the following endpoint:

 POST {BASE_URL}/api/sms/send

Please note that the SMS message won’t be sent immediately. Instead, it will be queued and sent shortly after your request.

Request Headers

HeaderTypeDescription
AuthorizationStringYour API Key (Required)
Content-TypeStringapplication/json (Required)
  • Authorization: Your API Key (Required)
  • Content-Type: application/json (Required)

 

Body Parameters

FieldRequiredTypeDescription
messagetrueStringThe content of your SMS message. The length should be 1 to 459 characters.
msisdntrueStringThe phone number that will receive the SMS message. Include the country code for international SMS. Format: +{country_code}{phone_number} or 00{country_code}{phone_number}.
  • message  (Required, String): The content of your SMS message. The length should be between 1 and 459 characters.
  • msisdn (Required, String): The phone number that will receive the SMS message. For international SMS, make sure to include the country code in the format +{country_code}{phone_number} or 00{country_code}{phone_number}.

Example Request

Bash

curl --location --request POST '{BASE_URL}/api/sms/send' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "message": "This is a test message.",
    "msisdn": "+1234567890"
}'

Successful Response Example

json

{
   "status_code": 200,
   "message": "SMS queued successfully.",
   "error": false,
   "code": 12134,
   "data": SMS Object
}

Important Notes

  • If the SMS length exceeds the maximum allowed limit or if your account doesn’t have enough credit to send the SMS, the SMS won’t be sent, and no credit will be deducted from your account.
  • You can always check the status of each SMS message using the “Get SMS” API endpoint.

If you encounter any other errors, please don’t hesitate to contact our support team for further assistance.

By following these simple steps, you can easily send single SMS messages through our platform, ensuring that your communication reaches its intended recipients promptly and efficiently.

Potential Errors

status_codecodeDescription
401-1Unauthorized! API Key is not valid or disabled.
40012150msisdn parameter is required.
40012148msisdn parameter is invalid.
40012099message parameter length is invalid, should be between 1 and 459 characters.
40012151Invalid phone number.
40012149Insufficient credit to send SMS.

If you encounter any other errors, please don’t hesitate to contact our support team for further assistance.

By following these simple steps, you can easily send single SMS messages through our platform, ensuring that your communication reaches its intended recipients promptly and efficiently.

GET SMS STATUS

At elfoA2P, we understand the importance of keeping track of your SMS messages and managing your lead lists effectively. Our platform provides you with the ability to retrieve the status of a sent SMS and get a list of your lead lists. Here’s a guide on how to utilize these features:

Retrieving SMS Status

To retrieve the status of a single SMS message, you need to make a GET request to the following endpoint:


GET {BASE_URL}/api/sms/:id

Replace :id with the unique identifier of the SMS message you want to retrieve.

Request Headers

HeaderTypeDescription
AuthorizationStringYour API Key (Required)

Authorization:  Your API Key (Required)
Content-Type: application/json   (Required)


Body Parameters

FieldRequiredTypeDescription
idtrueStringSMS ID to be retrieved.

Example Request

curl --location --request GET '{BASE_URL}/api/sms/:id' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json'

Successful Response Example
{
   "status_code": 200,
   "message": "SMS found successfully.",
   "error": false,
   "code": 12165,
   "data": SMS Object
}

Potential Errors

status_codecodeDescription
401-1Unauthorized! API Key is not valid or disabled.
40012015id parameter is invalid.
40412093SMS(s) not found.


If you encounter any other errors, please don’t hesitate to contact our support team for further assistance.

Retrieving Lead Lists

To retrieve a list of your lead lists, you need to make a GET request to the following endpoint:

GET {BASE_URL}/api/lead-list

Request Headers

HeaderTypeDescription
AuthorizationStringYour API Key (Required)

Authorization: Your API Key (Required)


Query Parameters

ParameterRequiredTypeDescription
pageOptionalIntegerPage number, default is 1.
limitOptionalIntegerLimit for each page, default is 10, maximum is 50.
typeOptionalIntegerFilter lead lists by their type.
searchOptionalStringFilter lead lists by their names. Search query must be at least 2 characters.
  • page (Optional, Integer): Page number, default is 1.
  • limit (Optional, Integer): Limit for each page, default is 10, maximum is 50.
  • type (Optional, Integer): Filter lead lists by their type.
  • search (Optional, String): Filter lead lists by their names. Search query must be at least 2 characters.

Example Request

Bash

curl --location --request GET '{BASE_URL}/api/lead-list?page=1&limit=3&type=1' \
--header 'Authorization: YOUR_API_KEY'

Successful Response Example

json

{
   "status_code": 200,
   "message": "Lead list created successfully.",
   "error": false,
   "code": 11016,
   "data": [ Array of Lead List Object ],
   "pagination_data": Pagination Object
}

Potential Errors

status_codecodeDescription
401-1Unauthorized! API Key is not valid or disabled.
40011063type parameter is invalid.
40011023page parameter is invalid.
40011024limit parameter is invalid.
40011027search parameter length is invalid.
40411018Lead lists not found. In case of no data found or no more data.

If you encounter any other errors, please don’t hesitate to contact our support team for further assistance.

GETTING LEAD LISTS

At elfoA2P, we understand the importance of managing your lead lists effectively. Our platform provides you with the ability to retrieve a list of your lead lists, which can be filtered and paginated according to your needs. Here’s a guide on how to utilize this feature:

Retrieving Lead Lists

To retrieve a list of your lead lists, you need to make a GET request to the following endpoint:

GET {BASE_URL}/api/lead-list

Request Headers

HeaderTypeDescription
AuthorizationStringYour API Key (Required)

Authorization: Your API Key (Required)


Query Parameters

ParameterRequiredTypeDescription
pagefalseIntegerPage number, default is 1.
limitfalseIntegerLimit for each page, default is 10, maximum is 50.
typefalseIntegerFilter lead lists by their type.
searchfalseStringFilter lead lists by their names. Search query must be at least 2 characters.
  • page (Optional, Integer): Page number, default is 1.
  • limit (Optional, Integer): Limit for each page, default is 10, maximum is 50.
  • type (Optional, Integer): Filter lead lists by their type.
  • search (Optional, String): Filter lead lists by their names. Search query must be at least 2 characters.

Example Request

Json

{
   "status_code": 200,
   "message": "Lead list created successfully.",
   "error": false,
   "code": 11016,
   "data": [ Array of Lead List Object ],
   "pagination_data": Pagination Object
}



Potential Errors

status_codecodeDescription
401-1Unauthorized! API Key is not valid or disabled.
40011063type parameter is invalid.
40011023page parameter is invalid.
40011024limit parameter is invalid.
40011027search parameter length is invalid.
40411018Lead lists not found. In case of no data found or no more data.

If you encounter any other errors, please don’t hesitate to contact our support team for further assistance.

By following these guidelines, you can easily retrieve a list of your lead lists, filter them by type or name, and paginate the results according to your requirements. This feature allows you to manage your lead lists effectively, ensuring that you have the necessary information to streamline your marketing and communication efforts.

CREATING A LEAD LIST

Creating Lead Lists

At elfoA2P, we understand the importance of organizing and managing your leads effectively. Our platform allows you to create custom lead lists, which can be tailored to your specific needs. Here’s a guide on how to create a new lead list:

Creating a Lead List

To create a new lead list, you need to make a POST request to the following endpoint:

POST {BASE_URL}/api/lead-list

Request Headers

HeaderTypeDescription
AuthorizationStringYour API Key (Required)
Content-TypeStringapplication/json (Required)

Authorization: Your API Key (Required)
Content-Type: application/json (Required)


Body Parameters

ParameterRequiredTypeDescription
nametrueStringThe name of your lead list. The length should be between 3 and 100 characters.
fields_listtrueStringAn encoded array of JSON objects representing the custom fields for your lead list.
  • name (Required, String): The name of your lead list. The length should be between 3 and 100 characters.
  • fields_list (Required, String): An encoded array of JSON objects representing the custom fields for your lead list. The format should be [{ “key”: “key”, “label”: “Label” }].

Example Request

Bash

curl --location --request POST '{BASE_URL}/api/lead-list' \ --header 'Authorization: YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "Lead List Name", "fields_list": "[{\"key\": \"name\", \"label\": \"Name\"}, {\"key\": \"age\", \"label\": \"Age\"}]" }'

Successful Response Example

Json

{
   "status_code": 200,
   "message": "Lead list created successfully.",
   "error": false,
   "code": 11013,
   "data": Lead List Object
}


Potential Errors

status_codecodeDescription
401-1Unauthorized! API Key is not valid or disabled.
40011003name parameter length is invalid.
40011010name parameter is required.
40011012Lead list name already exists.
40011032fields_list parameter is invalid.

If you encounter any other errors, please don’t hesitate to contact our support team for further assistance.

By following these guidelines, you can easily create custom lead lists tailored to your specific needs. These lead lists can be used for targeted SMS campaigns, personalized communication, and effective lead management, ensuring that your marketing and communication efforts are streamlined and effective.

CREATING A LEAD

Creating Leads

At elfoA2P, we understand the importance of managing your leads effectively. Our platform allows you to create individual leads within your existing lead lists, which can be used for targeted SMS campaigns, personalized communication, and effective lead management. Here’s a guide on how to create a new lead:

Creating a Lead

To create a new lead, you need to make a POST request to the following endpoint:

POST {BASE_URL}/api/lead


Important Note

If the lead list you’re adding this lead to is used by a running campaign that’s set to send SMS messages individually to newly added leads, an SMS will be queued to be sent to that lead in case it has a valid phone number in the key used in this campaign.

Request Headers

HeaderTypeDescription
AuthorizationStringYour API key.

Authorization: Your API Key (Required)
Content-Type: application/json (Required)


Body Parameters

FieldRequiredTypeDescription
lead_list_idtrueStringLead List ID to add this lead to.
payloadtrueStringEncoded JSON object of lead data with the format: { key1: “Value 1”, key2: “Value 2” }.
  • lead_list_id (Required, String): The unique identifier of the lead list you want to add this lead to. You can retrieve your lead list IDs by calling the “Get Lead Lists” API endpoint or create a new lead list using the “Create Lead List” API endpoint.
  • payload (Required, String): An encoded JSON object containing the lead data. The format should be { “key1”: “Value 1”, “key2”: “Value 2” }. The keys in the payload should match the custom fields defined in the lead list.

Example Request

Bash

curl --location --request POST '{BASE_URL}/api/lead' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "lead_list_id": "XXXXXXXXXXXXXXXXXXXXXXXX",
    "payload": "{\"name\": \"Lead Name\", \"age\": \"Lead Age\"}"
}'


Successful Response Example

Json

{
   "status_code": 200,
   "message": "Lead created successfully.",
   "error": false,
   "code": 11005,
   "data": Lead Object
}


Potential Errors

status_codecodeDescription
401-1Unauthorized! API Key is not valid or disabled.
40011039lead_list_id parameter is invalid.
40011033payload parameter is invalid.
40011035Payload fields do not match lead list fields. In case none of the keys sent in the payload exist in the lead list fields_list.


If you encounter any other errors, please don’t hesitate to contact our support team for further assistance.

By following these guidelines, you can easily create new leads within your existing lead lists, ensuring that your marketing and communication efforts are targeted and effective. Additionally, if the lead list is associated with a running campaign, an SMS will be automatically queued for leads with valid phone numbers, ensuring seamless communication with your new leads.

DATA MODELS

When working with the elfoA2P API, you will encounter various models in the response. Understanding these models is crucial for effectively integrating the API into your application. Below, we provide a detailed guide to the models you will encounter in the elfoA2P API responses.

SMS Model

KeyTypeDescription
idStringID of the SMS that was sent. Use this ID to check the SMS status later.
campaign_idIntegerID of the campaign to which this SMS belongs.
costDoubleCost of the SMS in your currency. For the send API endpoint, the value is 0 until the SMS is sent.
statusIntegerStatus of the SMS. Possible values: {-1: queued, 1: sent_to_carrier, 2: delivered, 3: undelivered, … }
countryStringISO2 country code of the recipient MSISDN.
phone_numberStringMSISDN of the recipient.
transaction_countIntegerNumber of transactions in this SMS, based on length and encoding.
created_atTimestampEpoch time of the SMS creation date.
completed_atTimestampEpoch time of the SMS completion date (for Delivered or Undelivered status).
previewStringPreview of the SMS content received by the user.
message_idStringID of the message sent to the recipient.


Lead List Model

KeyTypeDescription
idStringID of the Lead List.
nameStringName of the Lead List.
statusIntegerStatus of the Lead List. Possible values: {1: ready, 2: syncing}.
typeIntegerType of the Lead List. Possible values: {1: contact, 2: quick_sms, 3: api_messaging}.
countIntegerNumber of leads in the Lead List. Always 0 for newly created lead lists.
fields_listArrayArray of Lead List’s fields. Format: [{ key: “key”, label: “Label” }].


Lead Model

KeyTypeDescription
idStringID of the Lead.
lead_list_idStringID of the Lead List to which this lead belongs.
payloadJSONJSON Object of the lead payload. Format: { key1: “Value 1”, key2: “Value 2” }.


Pagination Object

KeyTypeDescription
current_pageIntegerCurrent page number.
current_countIntegerCurrent count of the current page.
total_countIntegerTotal count based on the current criteria.

Understanding these models will help you effectively utilize the elfoA2P API in your application. If you have any questions or need further assistance, please refer to the full API documentation or contact our support team.

elfoA2P User Manual

  • Home
  • >
  • elfoA2P User Manual

Sign up for an elfoA2P account

1.Go to Account Registration page.
2.You are required to fill in signup form and click Sign Up. (You can also opt to register account using Gmail or Social Media Accounts).

3. Check your mailbox for verification email from elfoA2P.
4. Open the email and click Verify Email Address.

5. This will take you to elfoA2P account setup journey.
6. To complete your account, you are required to verify your phone number. To do this, simply fill in your phone number and click Send.
7. Check your phone for incoming SMS with one time password (OTP).

8. Fill in the OTP in the fields provided and click Verify.
9. Should you do not receive the password, click Resend Code to receive the OTP code again.
10. Once verification completed, you will see a successful notification and this will take you to elfoA2P Home Dashboard and you can start enjoying free credits that is available in your account.

Sign in for an elfoA2P account
1. Go to Account Login Page.
2. Fill in form and click Sign In

3. You can also login via Gmail or Social Media Accounts.
4. Once login, you will be redirected to elfoA2P Home Dashboard.

Top Up your account

1. You can purchase more credits by clicking Top Up.

2. Then, you will be redirected to Top Up Credit page.
3. Select which package that you want to purchase or you can also insert the amount that you wish to purchase and you can see the payable amount summary.

4. Click on Pay Now button to proceed with the payment via Stripe payment gateway.
5. Once you complete your the payment transaction, you will receive email notification and your available Credits will be reflected instantly.

Account Management

Manage your Profile

1. To manage your profile, simply click the arrow next to your name on the top right, then click Account Settings.

2. On your Account Setting page, you will see your Account Overview under Profile.

3. You may update your profile information and then click Save.

Add User(s)
1. To add new users linked to your account, go to Account Settings, then click User Management.

2. Then, click Add New User and fill in the information required about the new user you want to add and then click Add.

3. An invitation link will be sent to users via email. Once user accepts the invite, you will be able to see their info in the list of users.
4. You can also Delete User or appoint user as master account by clicking Make Owner.

5. Only user with ‘Owner’ role is able to add or delete users from linking to your account.
6. Deleting user does not delete the user’s account. It will only remove them from your linked accounts.

Manage linked accounts
1. Go to Account Setting and click on Linked Accounts. Here you will see all accounts that have linked to your account under same organization.

2. If you have ‘Owner’ access, you will be able to manage credits for your users. To do this, click on Transfer Credits and a pop up will appear.

3. Select From and To accounts and insert the amount of credits that you want to transfer from one user account to another account and click Transfer Credits.
4. You should be able to see the new amount transferred reflected right away.
5. You would not be able to transfer credits from and the same account you want to receive the credits.
6. Please ensure you have enough credits before you make the transfer.

Secure your account
1. Go to Account Setting and click on Security. Here you can change your password.

2. Do not forget to click Save to update your new password.

Verify your account
1. To verify your account, go to Account Settings and click Account Verification.

2. On this page you are required to fill in company information, details of person in charge and upload necessary documents.
3. Click Submit to proceed with the application and you will receive a confirmation email that your application has been successfully submitted.
4. While your application is reviewed by elfoA2P Team, you will see status of Pending Verification on this page.


5. The verification process could take up to 2 working days. If your application is successful you would see the status on Account Verification page.

6. You will also see blue tick next to your name on the top right of the page.

7. If your application is not successful, you can re-apply for the verification once you Update Document.

Grow Customers

  • Contacts
  • Add contact
  • Upload contacts
  • Edit/delete contacts
  • Manage segments
  • Manage contact dashboard

Engage Customer
Campaign Builder

Send SMS using Campaign Builder
1. On elfoA2P Home Dashboard, click on Campaign Builder from the main menu listed on the left side of the dashboard.

2. On Campaign Builder page, you are required to fill in four compulsory fields:

i. Contacts/Quick SMS
ii. Campaign Name
iii. Brand Name (Only for Malaysia destination)
iv. Message Body

3. Optional fields that are available are:

i. Template – You may save message body as template by clicking Save as Template.

You can select saved templates from dropdown list:


ii. Custom Fields – You can personalized SMS based on unique information towards each recipients:

4. Click Send Now to send the SMS in an instant.

5. Click Save as Draft to save campaign temporarily.

6. Click Schedule Later to schedule the campaign at later date and time.

7. Click Schedule Campaign to confirm scheduled campaign.

Analyze Performance
SMS Campaign Insights

Campaign Overview
1. All created campaigns are listed on this page.
2. You may view campaigns by its status by clicking on the status of the campaign that you want to see.

3. To view campaign details, double click on anywhere on the row and a drawer with campaign details will appear.

4. On this drawer, you can see complete information such as time, date, total recipients, message preview and the summary status of the campaign.
5. You can also perform few actions based on each campaign’s status by clicking the action button.

6. Different campaign status will have different action item as below:

Campaign StatusAction Item
DraftEdit, View, Delete, Duplicate
ScheduledEdit, View, Delete, Duplicate
CompletedView, Duplicate
FailedView, Duplicate
IncompleteView, Duplicate, Resume
In progressView, Stop

7. You can also Continue Editing and Resume each campaign by clicking on the button on the campaign drawer.

8. You can also filter the campaign summary by clicking on the preset duration filter on the top right corner.
9. Campaign summary can be exported into excel simply by clicking Export to Excel button.

SMS Analytics

1. This page shows the summary of campaigns that have been executed.
2. To view the summary of multiple campaigns, click on the dropdown filter of Campaign Name, Country, and Start and End Date and select each campaign information.

3. You may select more than 1 campaigns to view its overall analytics.

3. You can also export the detailed campaign report into excel by clicking Reset to clear all the filtered information or Download to get the excel version of the report.

SMS Pricing and Billing
SMS price list

1. To view global SMS pricing, click on SMS Pricing on the top right of the page.

2. On this SMS pricing page, you will see the full global destination price.
3. You may search for certain destination to view the pricing.
4. You can also export the global SMS price list into excel format by clicking on the Download button.

Manage account billing
Billing logs

1. Click on the arrow next to your name on the top right of the page, and then click Account Billing.

2. This is where you can view and download all your credits purchase invoices.

Click on  next to the invoice number to download the particular invoice.

Campaign cost history

1. To view Campaign Cost History, click on the dropdown arrow next to your name, and then click Campaign Cost.
2. This is where you can check the cost of your campaigns that have been carried out.

3. You can also filter Start and End Date of the campaign and select multiple Campaign Name to view the cost.
4. You are also allowed to download the summary of the campaign cost in excel format by clicking on Export to Excel.

elfoA2P SMS API

SMS API documentation
1. To setup API integration, click on Developer menu on the left page.
2. Click on API Credentials to setup your own API connectivity.
3. Click on API Documentation to view elfoA2P SMS API documentation.

Configure your SMS API settings
1. On the Developer menu, click on +API Key on the right side of the page and a pop-up form will appear.


2. Fill in the form and click Add to confirm your API addition.


3. Notification webhook URL is needed if you required to receive the SMS status.
4. Copy the API key and follow the API documentation to establish and send SMS via API.

Report an Issue

Report an Issue
1. Click on the Report icon on the bottom left menu and a pop-up form will appear.


2. Fill in the form accordingly and with related images explaining the issue you are experiencing and click Send Report once finalized.
3. You may attached screenshot or video of the issue as attachment.

3. Once report is submitted, you will see acknowledgement pop-up that you report has been successfully submitted to the elfoA2P Team.


4. You will also receive a confirmation email as proof the report was submitted to the elfoA2P team.

Help Centre

  • Home
  • >
  • Help Centre

SEARCH

IN THIS DOCS

    Menu not found.

Contacts

  1. Getting started with contacts
  2. Add/Upload Contacts
  3. Contact Segments
  4. FAQs

SMS

  1. Getting started with SMS

(Brief introduction about elfoA2P and how users can utilize the platform)

  • Quick SMS

This is where you can do simple test before blasting SMS Campaign to intended recipients. The purpose of the test is so that you can test if the contents follows the rules of SMS regulatons that is set by Malaysia regulator (MCMC). You can read more about MCMC rules and regulations in SMS Policies and Guidelines.

  • SMS Campaign Builder

Brief intro about Quick SMS purpose (objective, use case) and show step by step to use the feature

  • FAQs
    • Why is my message failed?
    • What does the status of my message mean (clear explanation of each status mean)
    • Message log indicates a message is delivered but the end user did not receive it
    • What causes a delay in delivering messages?
    • Will I still be charged for failed SMS?
    • Why is my message have RM0 in the beginning of the content although I did not insert it?
    • Why is brand name compulsory for Malaysia destination?
    • Why does character length less than 160 characters but users received it as 2 parts and I was I charged for 2 parts SMS?
    • What does my SMS Campaign has different status?

SMS Analytics

  1. Getting started with SMS Analytics
  2. SMS Campaign Overview
  3. SMS Analytics
  4. FAQs

Account Settings

  • Home
  • >
  • Account Settings

Getting Started with Account settings

  • Profile
  • Users
  • Linked Accounts
  • Security
  • Having issues?

Profile: Personalize Your Presence

Profile shows a summary of your name and email address. You can click on your username to go to Personal Settings, where you can edit more details about your profile.

User Profile Page:

User Profile Page is where you can update your profile information, such as your name, email, phone number, time zone, and default currency. You can access User Profile Page by clicking on your profile image or name at home page > Account Settings > Profile.

Profile Avatar or Image:

You can change your profile avatar or image by clicking on it. You can upload a new image from your device or choose from the default avatars.

Profile Information:

You can edit the following information on your profile:

  • First Name & Last Name: You can change your first and last name. Your name will be displayed to your team and contacts, so make sure you use an appropriate name.
  • Email Address: You can change your email address. This is the email you use to log in to elfoA2P and receive notifications and alerts. You will need to verify your new email address before it is updated.
  • Phone Number: You can add or change your phone number. This is the number you can use to send and receive SMS messages through elfoA2P. You will need to verify your phone number before it is activated.
  • Time Zone: You can select your time zone from the drop-down menu. This will affect how the date and time are displayed on your dashboard and reports.
  • Default Currency: You can select your default currency from the drop-down menu. This will affect how the prices and billing are displayed on your dashboard and invoices.

Users: Efficient Credit Management

The users page shows a list of users who are linked to your account. You can add, edit, or delete users, as well as manage their roles. You can access Users by clicking on Account Settings > Users.

The roles of the linked accounts are listed on the user’s page. ElfoA2P allow two roles for linked accounts:

Roles:

  • Owner: The primary account in charge of comprehensive credit management.
  • Manager: Account listed as “Manager’ are sub-accounts efficiently managed by the owner.

The Users page streamlines credit management for linked accounts

  • Add New User:  You can add a new user as a sub-account or a manager. A sub-account is a user who can send and receive SMS messages using the credits received from the owner account but cannot access your billing or account settings of owner account.
    Step 1: To add a new user, click on the “+Add User” button. A form will appear where you can enter the new user’s email and name.

    Step 2: You can select the role of the new user, either owner or manager.

    Step 3: Click on “Add” to send an activation email to the new user. The new user will receive an email with a link to activate their account. They will need to create an account and agree to the terms and conditions before they can log in to elfoA2P. The new user will be listed as “Pending Activation” until they complete the activation process.

  • Delete User: You can edit or delete an existing user by clicking on the “Delete user” button under options next to their name. You also can change their name, email, role, or status. You can also delete the user from the Linked account or unlink the account as owner. Note that deleting a user will remove their access to owner elfoA2P, but their main account will remain as it is. Sub-account users can access their account.
  • Make Owner: Owner can list another sub-account manager as owner to manage credits transfer for other managers or sub-accounts.

Linked Accounts: Central Hub for Credit Management

Linked Accounts shows a list of accounts that are linked to your account. Owner can add/remove the sub-account to the linked account dashboard. The owner will be able to manage credits transfer with sub-account. Discover seamless credit management through the Linked Accounts feature.

  • Account Details: Gain insights into accounts, roles, total credits, available credits, and credit transfer history.
  • Credit Transfer History: Track dates and amounts of credit transfers.

 

Managing Credits Transfer:
Click “Transfer Credits” to Initiate credit transfers securely. Only owners can transfer credits to sub-accounts.

Buy Credits:
Owners can effortlessly top up credits by clicking “Buy Credits,” guiding them to the credit purchase page.

Security: Safeguard Your elfoA2P Account

Ensure your account’s safety with our dedicated Security settings. Security shows your security settings and preferences. You can change your password by clicking on the “Change Password” button. You will need to enter your current and new password and confirm it. You will need to log in with your new password the next time you access elfoA2P

You can access Security by clicking on Account Settings > Security.

Resetting Your Password:

Login Page:
  • Press “Forgot Password” on the login window.
  • Enter your email, and press RESET.
  • Check your inbox for the reset link.
  • Reset your password to regain access, following password security requirements.

Security Page:
  • Navigate to the Security page.
  • Enter existing and new passwords.
  • Retype your password for verification.
  • Press SAVE to apply changes, adhering to password security requirements.

Password Security Requirements:
  • Contains at least 8 characters.
  • Includes at least 1 number.
  • Contains at least 1 special character.
  • Includes at least 1 uppercase letter.
  • Contains at least 1 lowercase letter.

Account Verification: Secure and Compliant Messaging

To send bulk SMS through elfoA2P, account verification is crucial for a secure and compliant messaging environment. Account Verification shows your verification status and documents. You may need to verify your account to comply with the regulations and policies of elfoA2P and its partners. Verification will also allow you to access more features and benefits, such as higher sending limits, lower rates, and premium support.

To verify your account, click on the “Verify Account” button. You will need to provide some information about yourself and your business, such as your name, address, phone number, and industry. You will also need to upload some documents to prove your identity and address, such as your passport, driver’s license, or utility bill. The documents should be clear, legible, and valid.

  • Fill in Company Details: Provide essential information such as Company Name, Email, Address, and Registration Number.
  • Details of Person In-Charge: Add the contact details of the person responsible for verification.
  • Upload Documents (Optional): Submit documents like the Company Registration Certificate and ASP License in PDF format.
  • User Declaration: Agree to terms, conditions, and accuracy of information.
  • Pending Verification: Your submission is under review. Expect an email confirmation within 1-2 working days.
  • Account Verified: Once verified, receive a confirmation email and start using A2P SMS services.

Once you submit your verification request, our team will review your information and documents and get back to you within 24-48 hours (about 2 days). You will receive an email notification when your verification is approved or rejected. You can also check your verification status on your dashboard.

Denied Verification:
  • Account Verification Denied: If denied, contact elfoa2psupport@elfo.com. Use the “Update Verified Application” button for corrections or document re-submission.


Congratulations on unlocking the full potential of your elfoA2P Account Settings. For further assistance or faster verification, drop us a message. Happy messaging!

©2024 Elfo Sdn. Bhd.