SMS Gateway

Overview

HostBill SMS Gateway allows you to re-sell your SMS from one of the HostBill-supported vendors. This module works with built-in HostBill notification modules (like Clickatell, Nexmo) to send your customer sms out. Customers can post SMS directly from the client portal or using User API extension.

Activating the module

1. If the plugin is included in your HostBill edition you can download it from your client portal.
2. If the plugin is not included in your HostBill edition you can purchase it from our marketplace and then download it from the client area.
3. Once you download the plugin extract it in the main HostBill directory.
4. Go to Settings → Modules, find and activate SMS Gateway plugin.
5. Once the plugin is activated you will be directed to Settings→ Apps to configure the plugin.

Module configuration

1. Select one of the HostBill Notification plugins you wish to use for this connection.

Adding SMS product

1. Proceed to Settings → Products & Services to configure your SMS package.
2. Add new orderpage, from Product type select "Other Services"
   
3. Add new product in this orderpage. Set its name and save changes. For configuring billing of the SMS package refer to separate section below. 
4. In product configuration proceed to Connect with App section, select SMS Gateway module and app configured in previous steps. Save Changes
   Additionally, you can limit total number of SMS available for customer in billing period using SMS Limit option.
   
   

Configuring Client Functions   

In Products & Services → Your Order Page → Your Product → Client Functions you can control what features customer will have access to in client portal, by clicking Enable/Disable next to the given option.
Use Edit button to adjust function appearance in the client portal.

For SMS Gateway apart from the standard client functions, such as 

1. Change Billing Cycle
2. Change Label
3. Change Ownership
4. Edit Forms
5. Graphs
6. Login Details
7. Manual Service Renew
8. New Direct Link
9. Related Services
10. Service Auto Renewal

you can enable the following client functions:

1. Metered billing details - show Metered billing details table in client portal
2. SMS API - shortcut to API documentation - requires USER API module to be active
3. SMS history - ahow Sent SMS History to customer, let customer clean sms history
4. Send SMS - allow customer to send sms.

Note: It is advised to limit just one SMS package per customer under Other Settings in product configuration. 

Configuring SMS Product Billing

 SMS products can be configured with at least 3 distinctive billing models, under related product configuration, general settings tab:

1. Pre-Paid metered billing
    As per screenshot below, enable metered billing, change type to Pre-Paid. With this method customer pays X amount of money up-front and their credit account is decreased with each sms sent. 
   If customer credit balance reaches threshold level new invoice to top-up their credit will be issued.  
   
2. Post-Paid metered billing
   With this setup customer pays at the end of billing period (ie. Month) for the total amount of text messages they sent in this period. 
   
   
   
3. Regular (recurring) billing
   Using regular billing you can give customer X amount of messages to sent in month, and charge each month (no matter if customer used up all of the messages or not)