You are here: Clickatell | Support & Resources | Product Help Guides | Clickatell Gateway | Two-Way Number

Two-Way Number Applications

1. Two-Way Number Applications The Two-Way No. Applications section on the Manage My Products page allows customers to apply online for premium and standard rate mobile originated (MO) two-way services. Online applications are a fast, efficient way of securing a two-way number in the country of your choice. However, you first need to set up an API before applying for your new short code or long number. 1.1 Setting up an API Clickatell supports a variety of APIs (HTTP, SMTP, FTP, XML, SMPP, SOAP and COM API) – to find out more about APIs and their set-up, visit: http://support.clickatell.com/guides/clickatell/api_guide.php. 1.2 Services provided and terms and conditions You are required to select the checkbox that best represents the type of service you wish to use your two-way number for, whether it is a competition, alerts or a booking service. Note: No adult content or pornography is permitted. Please examine the Terms and Conditions carefully before submitting your form – certain countries have specific terms and conditions alongside Clickatell’s regular ones, which can be found at: http://www.clickatell.com/company/terms.php. Please ensure that you understand all the terms and conditions before accepting. 1.3 Filling in the application form After you have selected your API, please select the country in which your two-way number will be hosted. If your service requires more than one number or different country codes (e.g. +44, +46 and +27 numbers), you will need to complete a new application form for each one. Please note: though that you can send and receive messages from different countries simultaneously by using one of our long numbers, many of which have coverage throughout several countries. To find out more about number coverage, please visit: http://www.clickatell.com/pricing/standard_mo_coverage.php Next select the type of two-way number you wish to use from the menu below the “Select Country for Number Use” drop down menu. Click “Next” after reading and accepting the Clickatell Terms and Conditions checkbox. On the next page, please provide information about your expected monthly volume, and the start and termination date of your two-way service. Please note: certain countries require more comprehensive short codes application forms than others – please ensure that you provide ALL the required information before submitting your online application.  1.4 Clickatell’s Interactive Campaign Manager (ICM) If you wish to use Clickatell’s Interactive Campaign Manager (ICM), a web-based application for the management of two-way standard & premium rate SMS campaigns, then please check the box highlighted above. The process of acquiring an Interactive Campaign Manager is simple: Step 1: Complete your number application form Step 2: Complete the payment process (below). Note: you will not be billed for ICM immediately. Step 3: Once your number has been allocated to you, our Connectivity team will contact you personally with information about ICM costs and additional set-up documentation required. Lastly, click “Complete Application”. 2. Manage My Products 2.1 Payment The short code or long number you applied for will only be available to you after your payment transaction has been successfully completed. The status of your two-way application will be displayed on the main Central > Manage My Products page. Depending on your service, the fee charged will include a set-up fee and three month’s rental. For more information about coverage and charges, please visit: http://www.clickatell.com/pricing/shortcodes.php Click “Pay” to complete your application. Please note: Only credit card payments are permitted for online applications. Please fill in your relevant details, then click “Continue”. An Order Summary can be found on the right-hand side. Once you have successfully completed the payment process, you will be allocated a two-way number for use in your campaigns. You are then required to complete one final set up, that will enable you to use your two-way number. 2.2 Setting up your two-way number The final step before you can use your new two-way number is to set up your call-back and auto-reply configurations. Go to Central > Manage my Products, and then select the two-way number under “Type”. In the screen (below), please fill in your: Product: The API that is linked to the MO Number. Primary Callback: Reply Path: This is the way we send you the details of the MO messages: If you select SMPP then this needs to be blank. If you select HTTP then you need to enter a http callback here If you select FTP then you need to enter your ftp_id here If you select "Online Reports Only" then this needs to be blank Target Address: This is dependent on the Reply Path chosen. Target Username & Password: This username and password will be used to call your callback URL with basic HTTP authentication. Secondary Callback: This is a back up callback system in case our attempts to reach your primary callback fail. We will try your secondary callback on the 3rd and 5th attempts. Advanced features: Auto reply text: Whatever text is in this box will be sent back to the handset on each incoming message on your two-way number. Please note that this is sent via the normal router and is not sent with the mo=1 flag turned on. Note: if you are using ICM or any other campaign management application to manage your two-way campaign and have set an automated reply there, please do not type text here unless you wish to send two replies to your customers.  NOTE: Every time an auto reply is sent, you credit balance will be debited accordingly Auto Reply Sender ID: This is the sender ID that will be used when sending the auto reply message. Please note that a standard Clickatell number may be used as the Sender ID if this feature is unavailable through specific route. When you have completed your set-up, please click Commit. 3. Payment – rental fees Renewing and/or paying your rental fee can be done on the “Billing” page, where numbers due for payment will be listed. First, check the “Pay for MO (Two Way) numbers” checkbox. This will show you your list of numbers and their rental payment dates. You can then view and select from payment blocks of three, six, nine or twelve months, by ticking each two-way number’s checkbox. Once you have selected your ideal payment period, the rental fee price (excluding VAT) will appear in the box to the right. You can select and pay for as many items as you wish, by ticking the relevant checkboxes. A summary of your expenses will then appear on the right-hand side of the Billing page. The option circled in yellow indicates the message credit prices, the items in the blue circle display the MO number rental prices, and the values circled in red represent the total amount. Please note: because TAX/VAT rules change from country to country, the VAT amount provided in the Total section is based on the billing country you selected (circled in green), and will only be added after the sub-total has been calculated. Finally, click Continue to be taken to the payment details page. 4. Two-way Reports Two key reports for two-way messaging are the Two-Way SMS Report and the Stop-List Report. Two-Way SMS Report: This report gives detail (all fields) related to SMS messages sent from a mobile phone to the clients MO number/s rented from Clickatell. The report is able to filter on based on specific criteria, and some of the more important fields it displays are: Message time Message text/data moMsgID  - Clickatell identifier for the specific msg. Handset number that sent the SMS in. The MO number it was received on. Whether or not the client notification was completed and how many attempts. Time of the last client notification Product (api_id) the message was linked to. Stop-List Report: provides a list of former-customers, who have opted out of your bulk messaging campaign / subscription service / competition. This report displays the opt-out date, the mobile number of the customer/s, the product that they had opted out of, and the mobile message ID associated with that product. Each report can be viewed online, exported as an Excel spreadsheet or exported as a CSV (comma-separated-value) file.