All new World-Text Website! Explore Now

User Guides

Guidance to help configure and setup World Text services.

Auto Responder Configuration

The Auto Responder can be found and configured in your account Auto Responder section.

The World Text Auto Responder is used to process inbound SMS and perform actions based on the rules you have specified. For dedicated inbound numbers in addition to the default of 'catch all', you may also use keywords with different actions performed for each.

Forwarding SMS

Forwarding uses your chosen method to pass inbound SMS to you immediately and automatically upon receipt by our platform from the originating network.

Email

Forwarding by email will send inbound SMS to your specified email address.

Configuration
  • Destination Email - Enter the email address for inbound SMS to be sent to.
  • Use Keyword / #Hashtags - (Dedicated numbers only) If your message starts with your chosen keyword, or contains anywhere in the message, any number of your specified #Hashtags, these will be used to apply your rules.

HTTP/S

For documentation regarding the HTTP call methods, formats, functionality and examples, please see the HTTP REST API documentation here.

Forwarding by HTTP/S will send inbound SMS to your URL. There is a built in automatic retry process, in the event that your URL does not respond three attempts will be made to pass the inbound SMS.

Configuration
  • Primary Destination URL - Enter the URL for inbound SMS to be sent to in either HTTP or HTTPS format.
  • Call Type: GET - The optional method for forwarding HTTP/S to your URL.
  • Call Type: POST - The default method for forwarding HTTP/S to your URL.
  • Failover - You may specify a failover URL that will be used in the event that your primary URL fails to respond to all three attempts. The failover URL cannot be the same as your primary URL AND the failover URL MUST be the same scheme (i.e. HTTP/HTTPS).
  • Send As Binary - Inbound SMS will be sent to your URL in binary format
  • Send Passcode - Inbound SMS will be sent to your URL including a passcode specified by you
  • SMS Reply - An SMS will be sent to the sender of the inbound SMS using text content displayed by your web page. No further HTTP call, encoding or parameters are required. Standard plain text ASCII content only, no special characters - please see here.
  • Use Keyword / #Hashtags - (Dedicated numbers only) If your message starts with your chosen keyword, or contains anywhere in the message, any number of your specified #Hashtags, these will be used to apply your rules.
  • Warning Email - Should your URL fail to respond we will send a warning to your primary email address, this is normally the same as was used to setup your account but can be changed by contacting us.

SMS

Forwarding by SMS will send inbound SMS to your specified mobile / cell numbers.

Please note, forwarding inbound SMS by this method is chargeable, if you do not have enough credit on your account forwarding will not be carried out.

Configuration
  • Destination Mobile - Enter the mobile / cell numbers inbound SMS to be forwarded to, this must be in international format (ex. a UK number of 07590 123456 should be entered as 447590123456, where 44 is the country code for the UK. Multiple numbers should be separated using a comma.
  • Fixed Source - Use this option to specify a fixed source address which is used for all forwarded SMS. Otherwise the source address will by dynamically set to that of the inbound SMS sender. Both these options are subject to local restrictions in place and source address overwriting be effected to ensure delivery.
  • Use Keyword / #Hashtags - (Dedicated numbers only) If your message starts with your chosen keyword, or contains anywhere in the message, any number of your specified #Hashtags, these will be used to apply your rules.
  • Warning Email - Should your account be unable to forward by SMS we will send a warning to your primary email address, this is normally the same as was used to setup your account but can be changed by contacting us.

Ignore

Ignore will use source addresses specified to filter (ignore) inbound SMS and not pass through using your chosen method.

Configuration
  • Source Address - Enter the source addresses you want to filter (ignore), you may enter numeric and alphanumeric source addresses (ex. 447590123456,ACompany,62404 etc.). Multiple entries should be separated by a comma.

Opt-in / Opt-out of Groups

Automatically add users to your groups by.

Please note, replying with an SMS is chargeable, if you do not have enough credit on your account replies will not be sent.

Configuration - Opt-In To Group
  • Keyword - This is required and is the trigger keyword used by subscribers to opt-in to a group.
  • Select Group - Choose the group that the subscriber will be opted-in to.
  • Auto Reply - The message specified here is that which will be sent as an SMS reply to the user subscribing. This is an important part of best practice and remaining compliant with legislation. We recommend that you include what they have subscribed to and how frequently they will be contacted.
  • Source Address - Choose the source address that the SMS replies will use. If one is not selected your account's default source address will be used.
Configuration - Opt-Out Of Group
  • Use Keyword / #Hashtags - (Dedicated numbers only) Your message must start with your chosen keyword, or contains anywhere in the message, any number of your specified #Hashtags, these will be used to apply your rules.
  • Select Group - Choose the group that the subscriber will be opted-out of.
  • Auto Reply - The message specified here is that which will be sent as an SMS reply to the user un-subscribing. This is an important part of best practice and remaining compliant with legislation. We recommend that you include what they have un-subscribed from and that they will no longer be contacted.
  • Source Address - Choose the source address that the SMS replies will use. If one is not selected your account's default source address will be used.

Reply

Respond automatically with an SMS to the sender of inbound SMS using static pre-defined text.

Please note, replying with an SMS is chargeable, if you do not have enough credit on your account replies will not be sent.

Configuration
  • Auto Reply Text - The message specified here is that which will be sent in the SMS reply. A single part SMS is 160 characters, messages beyond this length will incur additional SMS costs.
  • Format - The reply text 'printed to the screen' for your reply should be plain text, not HTML.
  • Use Keyword / #Hashtags - (Dedicated numbers only) If your message starts with your chosen keyword, or contains anywhere in the message, any number of your specified #Hashtags, these will be used to apply your rules.
  • Source Address - Choose the source address that SMS replies will be sent using. If one is not selected your account's default source address will be used.

SMS to Email Gateway Configuration

The World Text Email to SMS Gateway is a powerful, but easy to use method for sending SMS via your existing email service. The following guide will help you to configure all settings and functions of the gateway for your account.

For advanced use of the SMTP / SMTP Bulk API functions please consult the developers SMTP API documentation page here.

To a Single Number

mobilenumber@sms.world-text.com

Let's send an 'Email to SMS' to the UK mobile number 07590 123456

To:

44 is the country code for the UK - for other country codes please see here.

To a Group List

grp_GROUPID_GROUPPIN@sms.world-text.com

Let's send an 'Email to SMS' to the group 1234 which has the PIN 4321

To:

Authentication

Methods for authentication of your Email to SMS submissions, enabling them to be attributed to your account (and be sent). You may configure multiple options, your Email to SMS submissions will be authenticated against any one of those methods (not the combination of them).

Configuration
  • Domain Name - For example if your company email address was ‘youremail@acompany.com’, you would enter ‘company.com’ in the ‘New Domain’ box and click ‘+ Add’. This would then allow all users which have an ‘@acompany.com’ email address to send Email to SMS.
  • Email Address - Add all email addresses you wish to be able to use the Email to SMS gateway if you wish to restrict to specific users rather than opening to an entire domain. Please note when sending from web email services such as Gmail™, Hotmail™, Yahoo™ etc., you will need to enable 'Trust Headers' in the 'Special' tab.
  • IP Address - By entering the static IP address of your dedicated email server this is used to authenticate Emails to SMS. Ideal for organisations that run their own mail servers.
  • Password - This gives you the ability to send an Email to SMS using a Secure ID Password in the subject line of the email. This removes the need to specify email addresses or domains that are able to send email to SMS or alternatively by configuring multiple accounts / sub-accounts the ability to send over these and thus adhering to the rules associated with that account.

Blackout

Add black-out periods, during this time any Email to SMS submitted will be silently ignored.

Configuration
  • Info - Coming soon.

Format

Detailed explanation of format options for the Email to SMS Gateway text messages.

Configuration
  • Source Address - This is the default source address that Email to SMS (aka sender / sender ID) will show on the recipients handset as being sent from (where possible).
  • Long SMS - As a default the maximum message length is set as 1 (i.e. 160 characters long for GSM encoded SMS), however if you wish for it to be possible for longer ‘multi-part’ message to be sent to mobile phones please choose a maximum message length of up to 9 parts.
  • Include Sender (start) - Include the email address from which the Email to SMS has be sent, prefixed to the start of the SMS.
  • Include Sender (end) - Include the email address from which the Email to SMS has be sent, suffixed to the end of the SMS.
  • Include Subject - Enable the ‘Subject’ of the Email to SMS to be prefixed to the start of the SMS, after the 'Sender (start)' if that option is enabled.
  • Exclude Body - Ignores any message body of the Email to SMS. With this set, only the email subject line and/or sender will be included if these options are enabled.
  • Raw Format - Control the formatting of the message, normally all ‘new lines’ and extra empty ‘blank spaces’ are removed from the message to make the text message as short as possible, saving you money. However, by enabling this option all ‘new lines’ and ‘blank spaces’ are used, which my be useful if you require special formatting of the text message.
  • Overrides - Allows for special overrides to be activated by including these at the start of the message body. Currently there is only one available for use. Including the special brackets indicated, this is: [[SRCADDR:XXX]] where ‘XXX’ is a different source address other than is specified as your default source address. The source address must of course have already be requested and allocated to your account.
  • Substitutions - There are four commands you may include in your Email to SMS allowing for special features to be activated. Including the special brackets indicated, these are: {{START}} Specifies the start of the message body. {{STOP}} Specifies the end of the message body. {{TIME}} Inserts the current time in to the message (GMT). {{DATE}} Inserts the current date in to the message body (GMT).

Forwarder

This allows you to have all emails that are forwarded to the Email to SMS Gateway to be sent to a specific mobile. The use of the daily quota feature is recommended. This option is ideal for emails being forwarded from the likes of Gmail which cannot adhere to such authentication methods as described above.

Configuration
  • New Mobile / Cell Number - Enter the number you wish to be able to receive the forwarded Email to SMS in international format (ex. the UK mobile number of 07590 123456 would be entered as 447590123456, '44' is the country code for the UK.
  • Alias - Enter a name for the authorised mobile / cell number for your own identification purposes.
  • Quota - It is suggested to use a daily quota, so should you receive a large volume of emails you do not in-turn receive a large number of SMS. You must ensure that the SMS cannot be authenticated through any other method (domain, email address, IP address or password), if they can be then the quotas will be ignored.

Receipts

Receipts are optionally emailed every time a text message is dispatched and delivered.

If the Email field is left blank, then the receipt is dispatched to the user who sent the original message.

Configuration
  • Email Address - If setup, this is the email address any dispatch or delivery receipts will be emailed to. Click on the '+ Update' button to add or update the email address. Dynamic receipt routing - If receipts are turned on, but you leave the email address field blank, this will dynamically return receipts back to the orginal email address that any Email to SMS was sent from.
  • Dispatch Receipts - Receive an email to the specified email address (or the email sender if not specified) upon your message being successfully sent for delivery.
  • Delivery Receipts - Receive an email to the specified email address (or the email sender if not specified) if we receive an delivery receipt. Please note that not all networks support these, such as USA and Canada.

Special

Allow you to control if you allow delivery to any number, or just those in your address book and if you allow your account to trust the sender in the email header.

Configuration
  • Restrict Recipients - The following setting allow you to restrict Email to SMS messages to only numbers that are in your address book. If enabled messages will silently be dropped if the destination number is not registered. As a default, you may send to any number.
  • Trust From Header - This lets your account trust the content of the FROM header in an email, this is an easily forged field but may be required in some special instances where the SMTP envelope sender cannot be controlled, such as when sending from web email services such as Gmail™, Hotmail™, Yahoo™ etc.

Transform Messaging with World-Text

Elevate your communication strategy with World-Text. Seamlessly integrate SMS, RCS, and WhatsApp messaging into your business to enable reliable one-way alerts and dynamic two-way conversations. Engage your customers on their preferred platforms with ease, scalability, and the power of cutting-edge messaging solutions.