Telecom eTXT - User Guide
  Dashboard > Telecom New Zealand > ... > Telecom Customer > Telecom eTXT - User Guide
View a printable version of the current page.  
Labels: 
(None)

Telecom eTXT

The Ultimate Messaging Tool
This document provides information on the Telecom NZ eTXT service.

User Guide Content

top

Introduction to eTXT

eTXT provides you with an immediate, cost effective and simple way to communicate to your staff, suppliers and customers directly to their text capable mobile devices.

The service offers a couple of simple ways to send SMS messages. In addition, it is easly integrated with your existing systems that use email to update or alert people with the added benefit that the message is received wherever the recipient may be.

eTXT offers various interfaces to meet the needs of users

From an easy to use web site
From their everyday email client such as Outlook or Eudora (or from existing email enabled automated servers and processes)
For example simply add @eTXT.co.nz to the mobile number you want to send to, and use this as their eTXT email address to send a short message. For example

  • contact@eTXT.co.nz or
  • 64275123456@eTXT.co.nz

Mobile recipients can then reply from their phone straight back to the Email inbox of the original sender using patented mTagTM technology from Bulletin Wireless.

Advanced features are available using the power of the eTXT address book and customised security settings*.

* Available for company administrator accounts only.

top

User Types

This service has different user types.

  1. Company User
  2. Company Administrator

While messaging functionality is basically the same, each has different options available for account administration and security.

The most common type of user is the Company User. This user will have a unique login and possibly a separate billing account and may share address books or other information but all administration is done by the Company Administrator. The Company Administrator should be contacted with any queries a Company User may have.


Each Company Account has a Company Administrator user. In addition to the messaging features this user has additional options for administering their company user accounts. Security, user maintenance and reporting options are the main features and are detailed in the Company Administration section.

top

eTXT on the Web

The eTXT Web site is a messaging service that provides SMS messaging from a web browser to supported mobiles.
All your messaging and configuration options are available at http://eTXT.co.nz using the login details provided by your Company Administrator (CA) or by Telecom NZ.

top

Web Browser Requirements

To access and use the website you need a browser that

  • supports cookies
  • has JavaScript enabled

top

Sending Messages

For quick messaging enter a recipient mobile number in the 'recipients' field and the message in the 'message' field before pressing the 'send' button.

The recipient list (Recipients) allows a comma separated list of numbers or contact names from your address books.

The address list (Addresses) lets you to select contacts (individuals or groups) from any of your address books and to add them to the recipient list by using the 'add to recipients' button.

You can also view the members of a group and also select a subset of the group members by selecting it in the list and pressing the 'show group' button to display a new window.

Although the service supports sending 'email' to phone numbers, your administrator* may have configured the system to only allow messages to be sent to people in your address book using existing names or aliases.
An additional administrator setting is to lock address books so only the administrator can add contacts to the company address book. This setting will apply to both the Web site and SMS messages via email.*
These added levels of security aim to prevent system abuse. Contact your Company Administrator for more information if you are unable to access your address book.

* Available for company administrator accounts only.

top

Canned Messages

These default message templates may be inserted into the text by simply selecting the message you want from the new window that is displayed after you activate the 'canned message' link. These messages are setup under your account options.

top

Signature

If you have a signature configured for your account, you may insert it into the message by activating the 'signature' link. You can configure your signature and set it to automatically append to every web message under your account options.

top

Send Later

If you would like to schedule a message to be sent at a specific time in the future, fill in the recipient and message fields as normal and press the send later button. You will be asked to select the date and time you would like the message delivered and then to confirm the delivery time. Once you have confirmed the scheduled message you can delete it from the scheduled message list under Messages | Scheduled.
Messages times are based on your configured time zone. You can change this setting at any time in your Options.

top

Count Recipients

Before sending your message, you may like to know how many people it could be sent to. The count recipient option processes the recipient list and counts unique recipients (each mobile number will only get your message once). For large groups or recipient lists this may take a moment or two.

top

Show Groups

Use the Show Group option to see the members of the Contact group (those in UPPERCASE) selected from the address list. This screen shows the members of the group and their details.
Use the option in the Show Group screen to select a subset of the members and add them to the recipient list of a message.

top

View All Contacts

The View All Contacts option is similar to the Show Groups screen except that it displays the details of all the members of the current Address Book. For large address books this could take a few moments to display.
Use the option in the Show Group screen to select a subset of the members and add them to the recipient list of your message.

top

Recent Messages

A list of recently sent and received messages is displayed and refreshes regularly, giving you the option of clicking through to the message detail or sending another message to the sender/recipient ('R') or forwarding ('F') the message content on.
Messages you have received are displayed with an icon and emailed messages (in and out) are indicated with "E".

top

Bulk Sender

If you have a list of recipients that you would like to SMS one time only then the Bulk Sender option may suit your needs. This option is available from the Manage Address Books page as an alternative to importing the list of numbers.
When using the Bulk Sender the recipient file should contain one recipient number per line in the file.
For example

64271234567
64211236985
64294212124

The application will prompt you for a file location and message content then it will validate the file before asking for confirmation.

Warning

The service must not be used for unsolicited SPAM or marketing messages. Users that do so may have the service restricted or cut off.

top

Address Book

The address books allow you to add contacts you send messages to on a regular basis. Company address books may be created and managed by a CA and they may choose to share them throughout your organisation*.
An alias may be assigned to a group or a contact as a short cut that is useful when sending SMS messages from your phone using the group messaging feature.
Because address book entries can be used as part of an email address, they must conform to those standards and restrictions. Basically they must not include any spaces or various special characters such as brackets. Therefore when adding entries to your address books replace any spaces with dots "." or underscores "_" for example 'corporate.sales' or 'product_support'.

It is essential that all address book entries are unique. This means that you can not have more than one 'john' in any address book either as a group name or alias or as a contact name or alias. This helps avoid confusion when sending to 'john' or using email to send to john@eTXT.co.nz.
* Available for company administrator accounts only.

top

Contacts

Groups and Contacts are listed for each address book the user can use. Groups do not have mobile phone numbers associated with them and are displayed in CAPITALS. Contacts do have a phone number attached to them and are displayed in lowercase for quick recognition. Click through to the details of the contacts/groups as needed.
To view another address book or filter the selected address book change the options in the drop down lists.

top

Create Individual

Choose which address book you want to create the new contact in, enter the name (remember spaces are not allowed), mobile number and, if necessary, the alias.
You also have the option of adding some tags or properties to the Contact such as position, location department or organisation. These tags are displayed in your contact lists such as the Show Groups page.
The new user may be assigned to any existing groups in the address book.


If you cannot add to your address book contacts or groups, contact your Administrator as they may have set higher security settings.

top

Create Group

Choose which address book you want to create the group in, enter the name (remember spaces are not allowed) and, if necessary, the alias. Any existing users in the address book may be assigned to the new group.

top

Manage Address Books

This page allows you to import and export address lists and set which address book is accessed by default (Eg. on the send message, create contacts and create groups pages).
New address books may also be created. Company address books can only be created by the company administrator*.

top

Exporting Address Books

Choose the address book you want to export and follow the instructions. To export the entire address book simply press the 'save' button and choose the location for the file to be saved.

top

Importing Address Lists

There are two methods of importing address books. The first is a manual process done via the website. The second can be automated to upload and refresh (deleting existing contacts and adding new ones from a file) an address book.
Each process takes a slightly different file format as detailed in the following sections.
If you are wanting to send to a list of recipients one time only (or the list changes regularly) then use the Bulk Sender option on this page.

top

Manually Importing Address Lists

When importing an address list it is important that the file meets the following criteria.

  1. Comma delimited format (CSV)
  2. Header row with the applicable values of "number", "name", "alias", "group", and "group alias"
  3. Each row must have the same number of fields
  4. Each name and alias (contact and group) must be unique
  5. Phone numbers must be valid numbers that the system can send to
  6. Names and alias values must meet validation requirements
    • must not contain any spaces
    • must be less than 30 characters for contact and group names and 4 characters for aliases
    • must start with a letter
  7. To import a file, browse to the location where you have your prepared list of contacts or numbers and then press the 'import' button.

Confirm that the file looks correct and either choose to import the list into a new address book or choose one of the existing ones before pressing 'save'.
If there are any errors the system will notify after the import.
If there are any duplicate names then the system will update the existing name with the new phone number and will not notify of an error.

top

Alternative Import Method
Important

This process will delete all contacts and groups from the selected address book prior to the import and can not be regenerated in the case of an error.


User Credentials - Use the same User ID and Password that you use to access eTXT.
* Address Book ID
The Address book ID is a unique number assigned to each address book and will remain the same even if the address book name changes. However, if you delete the address book then that ID will no longer be valid.
You can locate this address book ID in the web browser address bar if you choose to export the address book in the manage address books screen. If you need assistance contact Telecom Support with your account details (login ID and password).
If the User ID does not have write access to the selected address book then an error will occur.

File Structure
The file to import will look something like the following

Name,Number,Group
JohnStamos,0277565432
Nicky Tomb,0272776143
Thistoo,0272776242,home
Zeeble,027219878763,Work
Overseer,02721887863,Work|Play|home
Jenny,02721828763,Play
Christine in Accounting,02718828762,Work
Support_phone,0278828762,Work

Each line in the file should refer to ONE contact name. This contact can belong to multiple groups delimited by "|" (pipe). Names and Groups will be cleaned of characters that are not allowed in the fields such as spaces and various punctuation characters. Contact names and groups will also be truncated to 30 characters and adjusted as necessary to meet the database requirements, so it is important that the address book contacts in the website are checked before messaging.

Automation
This process can be automated on Linux using curl

curl -k -F 'username=foo' -F 'password=bar' -F 'abid=1234' -F 'file=@test.csv' http://eTXT.co.nz/abimport.jsp

top

What is an Alias?

It is important to note that an address book alias is used as the email address. An Alias is a short code for a CONTACT or GROUP.

  1. An Alias must be unique in to the Account. Eg. a contact cannot share the same alias as another contact OR with a Group for the same account. This also includes Company Address Books.
  2. An Alias must not be longer than four characters
  3. An Alias may contain any number or letter. Spaces or special characters such as ':', '@', '#' etc are not allowed
  4. An alias is not case sensitive (Eg 'eric' is the same as 'Eric', 'ERIC' and 'eriC')
IMPORTANT

It is possible that two accounts use the same alias for different people. This means that these email addresses, unlike other email addresses, may not be unique. The message sender determines the correct recipient.

Valid Aliases Invalid Aliases
Matt sv c (contains a space)
Jon1 Team Jacob (too long)
svsc a.t (contains a period/dot)

top

Messages

The service keeps a log of all the messages sent and received along with recipient details. It also shows these messages together in the context of replies that have been sent your messages.
For replies, the original message and other details are also displayed to provide context, if necessary.

top

Sent/Received

Email originated messages are marked with an 'E' in the message lists against the To/From details.
You can also view the status of any message and click the icons to Reply or Forward messages.
Clicking on the message body takes you to a MESSAGE DETAIL page for that message where you can also reply, forward or delete the message. This screen also gives you a breakdown of the delivery status of messages sent to multiple recipients (eg. groups).

top

Sent

This screen filters the message log of any replies you may have received. Clicking the message content takes you to a detail page where you can see various details for that message.

top

Status Codes

Depending on the Network the messages are sent to, some of the following Status messages may or may not appear.

RECEIVED The message has been received by the mobile
SCHEDULED The message is scheduled as per calendar
SENT The message has been sent to the network for delivery
NOT RECEIVED The message could not be delivered to the mobile at this time. Check the number and resend your message
EXPIRED The message could not be delivered within five days, and has been expired
REJECTED The message has not been sent as the number is invalid. Change the number and resend your message
ERROR An internal error occurred and the message has not been sent. Please resend your message and contact Telecom if the error occurs again

NOTE: Telecom NZ reserves the right to charge for all messages sent via the system regardless of the delivery status.

top

Received

This screen filters the message log to show only the replies you have received.
For details of replies click the message to see the original message and other details to provide context if necessary.


Select View Other Replies to see a list of other replies to the same message.

top

Replies to Messages via email

If an SMS recipient replies to an email message with an SMS from their phone, the reply will be sent back to the originating email address. In addition to this email, the reply will also be logged in the web message log.

top

Scheduled

Any scheduled messages you have configured are displayed here and can be deleted as necessary. Once the message has been sent and is pending delivery or has been delivered it is removed from this screen and logged as a Sent message.

top

Message Details

Depending on whether you are viewing an outgoing message or a received one, the message detail page will give you slightly different options.
Sent Messages show the recipients grouped by their status. This means you can quickly see those recipients that have not had confirmed receipt of the message and even send a message to all those that have received it. You can also click through to see all the replies to an outgoing message.
Incoming messages, such as replies, show the details of the original message so you have it in context and also allows you to click through to see other replies to the same original message.

top

Options

top

Settings

As well as providing the facility to change a password and time zone, this screen shows various details applicable to the account such as the personal detail stored for the user and the addresses allowed to SMS by email for this account.

Change the time zone to alter the way times and dates are displayed in the web site. This does not alter the time displayed on SMS messages but will give you freedom to be able to view the website in a local timezone.
If the account is allowed to send SMS via email then any addresses verified and assigned to this account are also listed on this page.

top

Canned Messages

Canned messages are a feature that allow you to use personal, company* or system 'templates' for sending messages from the website (select them on the create message page).

Each account may configure 10 of their own canned messages and the CA may also configure another 10 company messages for use by all the accounts within the company.*

* Available for editing by company administrator accounts only.

top

Signature

You can create a custom signature for your account that is used when the message is sent via the web site.

This signature may be inserted into outgoing messages when created via the website or they may be appended automatically to every message.
Messages sent via email ignore this setting and your signature will NOT be appended to the SMS message.
The service may also strip your standard email signature from the contents of the email. This means that the recipient may not know who sends a message to their phone, although they can contact Telecom NZ to find this information. The service uses accepted Internet standards to determine where an email signature is included, looking for '-- ' (dash dash space).
It is recommended that SMS messages sent via email include your name and contact number in the subject line or at the top of the message.

top

Display

This page allows you to choose how many messages to display on your 'send message' page and the message log (sent/received) pages. The screen refresh rate option affects the send message page. The service will check for updates to messages and message status changes at the selected interval in seconds. Use 0 (zero) to disable.
Ensure you press the 'save' button after any changes.

top

Sending SMS messages via email

Before using email to send SMS messages, ensure your address is enabled in the system. Valid addresses are listed on the Website on the options page. If you can not access this page contact your administrator and ask them to check if you are configured.
Administrators should contact Telecom with details of the email addresses or domains that they want registered for SMS via email.

This email will be sent, as an SMS message, to the New Zealand Mobile number 02715414141 and the number matching the 'supp' alias in this users address book.

If your email address is enabled or if it is covered by a licence for your entire domain, then messages can be sent from any RFC compliant email client depending on the license and settings such as

  1. IP Authentication (Company)
  2. Close Address Books (Company or Account)
  3. Email to contacts only (Company or Account)

One benefit of this service is that it uses software you are familiar with to send SMS messages. Simply compose your email as you normally would and send to your contacts and their replies will come back to your email.
The main limitation is that each message is limited to 160 characters, including the subject line.

The steps to send SMS via email are the same as sending a normal email

  1. Open your Email Client (Outlook, Hotmail, Netscape etc)
  2. Enter the Recipient Addresses in the space provided
  3. Enter the Subject of the Email (or leave blank)
  4. Write your Message
  5. Send the Email
Warning

Only the first 160 characters of the subject plus the message will be sent to the mobile device so get to the point quickly.

With this system, the SMS recipient may not know who sent the message so it is suggested that you add your name and a contact number so you can be contacted if required (replies by SMS will go back to your email address but the person will not be able to call the number that the SMS appears to come from).

With group emails, it is suggested that addresses be entered in the BCC field. This will stop other recipients from attempting to send email messages to addresses they may not have access to. See the trouble shooting section for more information.

top

Sending Messages using your Phone

Group messages can be sent from your registered handset using address book aliases. This feature gives you the power to send messages from your handset to hundreds of recipients with one simple SMS message

All Mobile Originated (MO) messages need to be sent to 222 (only available from phones registered against an active account).

To send a MO message, compose an SMS on your phone in the following format

  • GM [space] Alias [space] Message

For example

GM team Weekly meeting delayed, see noticeboard

In the above example GM indicates to the service that you are sending a G roup M essage. Team is the alias for a Group in the online addressbook and the message to be sent to all the members of this group is Weekly meeting delayed, see noticeboard

top

Company Administration

Administration

The admin options are only available to company administrator (CA) users. It provides access to options for such things as reports, limits and email address configuration.

top

Accounts

The Account Maintenance page shows a list of user logins configured company wide.

Useful Information

The first time the Company Administrator logs in, the only account showing will be the Company Administrator Account.

top

Limits

The CA may set some messaging limits for their company. This limits apply across all accounts within the company. For example, with three accounts and a message limit of 500 then when the combined total for all three accounts reaches 500 no further messages may be sent.

top

Reports

The reports allow reporting on all messages sent through your account

  1. Click on the REPORTS link at the top of the screen
  2. Select the period and starting date
  3. Select the Report Type
  4. Once the reports are run you have the option of exporting them as CSV files if you require.

top

Account Summary

The data shown on this page is for information only and cannot be edited.

Use this page to see which accounts addresses have been allocated to, and to browse to an account that you want to view in further detail or modify.

top

Security Options

IP Authentication

The company administrator is allowed to choose whether mail from certain mail servers can only be processed. This IP Authentication can be turned on at any time and when it is on, only mail from the listed IP addresses (mail servers) will be processed. All other email will be dropped without notification.
To assist you, each time a new server (IP address) is used an email is sent to the CA (only one email is sent per IP address). The address and the sender details are also logged ann displayed in the Message log section of the security page. To add an existing IP address to your Authenticated list simply click the IP in the message log and it will be added. To add a totally different IP to you list, enter it in the proper format and press the add IP button.
To delete an IP address from your Authenticated list, check the corresponding box or boxes and then press the delete button.
If you have any questions about IP addresses, mail servers or how to prevent email 'spoofing' and other fraudulent activities contact your IT helpdesk.

IP authentication will make more demands of the Company Administrator, so its activation is a question of weighing usability vs. security. Generally is it only recommended if message content is particularly confidential or in the case of concerns over abuse of an eTXT account.

Who is it suitable for?

IP Authentication is suitable for companies with their own mail server(s) with fixed IP addresses.
IP Authentication is not suitable when using an ISP to send email, as IP addresses are dynamic and may be one of any number of addresses from server farm.

Getting Started

By default IP authentication is not enabled on new accounts. However if it is desired, it is best to not enable IP authentication and then to use the initial messaging activity to capture the IP addresses prior to activation.

Each time a new mail server (IP address) is used an email is sent to the CA (only one email is sent per IP address). The address and the sender details are also logged and displayed in the Message log section of the security page.

To then add an existing IP address to your Authenticated list simply click the IP in the message log and it will be added. To add a totally different IP to you list, enter it in the proper format and press the add IP button.

To delete an IP address from your Authenticated list, check the corresponding box or boxes and then press the delete button.

Once IP authorisation is on and a new unrecognised IP is used that message will drop and the CA will be notified by email. No messages from that IP will be delivered until it is added by the CA. There is no holding pattern, once it fails it will not retry.

If you have any questions about IP addresses, mail servers or how to prevent email 'spoofing' and other fraudulent activities contact your IT helpdesk.

top

User Administration

Close Address Books

This setting applies to all messaging functionality. It stops users from adding to their personal address books or sending to recipients using a phone number rather than an address book contacts.
This option overrides other User security settings such as 'Email to contacts only'.
If the Company security settings impose a closed address book, then that will override any user account settings whether it is enabled or disabled.

top

Setup SMS via Email

This section allows you to configure access to the service via email.

top

Activate SMS via Email for this account

Although the service supports sending 'email' to phone numbers, your administrator may have configured the system to only allow messages to be sent to people in your address book using existing names or aliases.

top

Email to contacts only

To prevent users from sending to numbers that have NOT been configured in one of their available address books check this option. Users will then need to add the contacts to one of the address books and will not be able to send to a number eg 0270123456@eTXT.co.nz.

top

Addresses assigned to this account

The email addresses that will be billed to this account are listed here.
If you have a configured domain or IP address, you may import a list of email addresses to reduce data entry.
You also have the option of adding and deleting addresses from these lists as your needs change.
Only verified addresses may be assigned to an account. Check the 'Summary' screen to check the status of any addresses

Useful Information

This Company Admin Account is unique because the Default Billing/Reply number must be the Company Administrator's Billing Number.

top

Advanced Features

The service offers additional Web and advanced security features. Your system administrator may configure the system to suit their requirements. Some of the features include

  • Locked address books
    SMS (web and email) to preconfigured recipients only
  • Email to contacts only
    requires recipients to be defined in your Online Address Book and sent to by name or alias
  • IP Authentication
    SMS via email is only available from certain locations

See the following sections for more information on the Advanced Features

top

Domain or Email Address Setup

Uou can configure email addresses to send messages to SMS capable mobile devices. To configure addresses (see following section for address types) follow these steps.

  1. Decide which addresses the organisation wants enabled. If the organisation is the sole user of a domain (eg, yourcompany.co.nz) then consider enabling this domain and then the CA is able to filter access as needs change. Alternatively configure those individual email addresses that are required Each subdomain (eg some servers send from @server.yourcompany.com.au) needs to be explicitly configured.
  2. contact Telecom with your account details (login ID and password) and the list of addresses you would like configured.
  3. The addresses will be entered in the system against the company and an automated email will be sent to each address notifying them that they are able to SMS by email.
  4. The address will be automatically assigned to the Administrator account (unless otherwise requested) so it can be used immediately.

top

Address Types for SMS by email

The email to SMS service is available for the following address types

  • Domain Name, or
  • Single Email Address, or
  • IP Address

A Domain Name allows SMS messages to be sent from email addresses within the registered Domain. This is the most commonly requested type of licence and allows the Company Administrators to easily manage their users' access without talking with Telecom NZ each time a change is required.
An Email Address allows SMS messages to be sent from a single registered email address.
Each lower level domain must be registered separately. E.g. nz.bulletinwireless.com is NOT covered if only the bulletinwireless.com domain is registered.
An IP Address allows SMS messages to be sent from any email address that uses the mail server specified at the registered IP address. This type of license is not used much and is not generally recommended. You should be fully aware of IP and network routing issues and discuss your requirements with Telecom if you have any doubts.
The addresses will be automatically assigned to the CA account so it will be able to be used immediately for SMS messaging. See the section on Trouble Shooting if SMS messaging is not available after an address has been verified.
By logging into the website, the administrator may distribute the addresses to their other accounts (if configured). For example a Domain or IP licence may be changed from a 'catch all' where all addresses are allowed (the default) to use a specified list of accounts within that domain. This is done by removing the domain from the CA account and either importing or manually adding the individual addresses to specific accounts as required.
If your company subscribes to the SMS email service you will be able to assign any of the verified licences to this account once it is first saved.

Select Email to contacts only, if user's may only send to address contact book. This limits the account to sending SMS messages to people that they have previously added to their online address book. If the user setting, Close Address Books, is selected, then that will override this option and automatically stop the user from sending to any phone numbers.
If the Company security settings impose an address book only restriction, then that will override any individual user account settings.
Add any available addresses that you want to assign to this particular account. If the address you want to assign is not shown in the list then it may already be assigned to another account in your company. Check the Summary page to view your current assignments.

top

Importing Email Addresses for a particular login/cost center

You may import a list of email addresses to assign to a particular account. The file that you import must only contain full email addresses that belong to the domain you are importing against. If you are importing against an IP address then any email address will be imported if it is not already in the system.
The system will not import addresses that already exist and may fail if the file is invalid.

top

Trouble Shooting

This section should be used to narrow down the reasons for any issues that may occur with the service. If these steps to not assist you in resolving your issue please see the 'Support' section of this document for information on who to contact.

top

Bounced Emails

Messages may be 'Bounced' back to the sender for a number of reasons. Contact Telecom if your messages start to be 'bounced'.

  • System Limits have been reached. This setting is for the entire (web and email) system for your Company. The limits may be for the number of messages per day or per hour.
  • The email to SMS feature has been disabled for the Company.
  • SMS via email functionality is not enabled for the specific login.
  • Incorrect details stored in the online Address Book. Login and confirm the phone number is correct for the Alias you are using.
  • Messages to phone numbers are bounced. Your Security settings may not allow you to send SMS to phone numbers, the recipient will need to be configured in your online Address Book.
  • Network Limitations. Some networks cannot receive SMS messages from the system. Changes to these Network limitations will occur over time.
  • Replying to a Group Email, from your email client, (Reply To All) that included some email to SMS recipients in the To or CC fields. This will send an Email to the system, which will try and assign it to your account so it can use the Alias or Phone number. If this Alias match fails the message will get bounced.
Warning

It is possible that the same alias is used by two Accounts for different people. This could mean that the incorrect person receives the Reply To All email.

top

Messages not received

  1. The service follows RFC-2822 (http://rfc.net/rfc2822.html) guidelines for message format. Messages that do not conform to RFC-2822 may not be processed or may be processed incorrectly.
  2. If the message status in the web message log is RECEIVED, check that the correct phone number is stored in the online address book for the Alias that was used.
  3. IP Authentication failed. You may be sending your email from an IP address that has not been authenticated by your Administrator. For information on a specific IP visit http://centralops.net. This site will tell you detailed technical information on IP's, domains and email addresses.
  4. Sender Email Address is not configured to use the system. Check with your Administrator that your address is assigned to an account and that SMS by email is enabled for BOTH the Company and the Account.
  5. If a sender account is unable to send SMS via email, check that email they are sending has the correct 'return-path' in the internet headers. In MS Outlook the headers can be found by opening the email message, and selecting view, options from the menu bar. The return-path is shown in the first line of the internet headers section.
  6. Messages forwarded from email are not delivered to the phone. Most email systems do not alter the internet headers of an email; therefore the 'return-path' of a message is the original message sender. Unless the original sender is also configured, the message will not be delivered.
  7. Messages sent 'on behalf of' another user via MS Exchange or Lotus Notes do not get delivered. Even though the user being 'sent on behalf of' is configured, the return-path is going to be the actual senders address. It is important that the senders address is configured in the system.
  8. Server alerts are not being delivered. Generally a server will use a default address when sending email. This address is generally one of the following formats, each address is invalid (does not meet internet standards) and will need to be changed to an address that is configured in the system.
    • process@server.etxt.co.nz
    • user@localhost.localdomain
    • server@domain.local
  9. Server alerts from an internet standard address are not delivered. Some servers use the address format of 'process@server.yourDomain.co.nz'. Whilst this is valid, it will need to be setup in the system before messages can be delivered. Each sub domain (in this case 'server.yourDomain.com.au' needs to be configured separately. If it is not possible to reply to the required verification email from the server address, Level 1 System Administrators (CSR1) can set the address to verified. If you need this to be done please contact Telecom.
  10. Some message delays may be experienced due to Network loading.
  11. The original message may be delayed on an email server (ISP or corporate).
Warning

This service should not be relied on to deliver important or time sensitive information. This is due to the limitations of email routing and delivery systems as well as the architecture of SMS message delivery.

top

Replies to emailed SMS messages are not sent back to the correct Address

  1. Check your Email settings for the Sender Email address. Generally, it is this sender address that translates to the 'return-path' internet header that the system uses to sends replies to.
  2. Each Email System will have a different way of configuring the Sender address. If you need assistance, contact your I.T Manager.
  3. If the (mobile) user has stored the number of a message they received fromthe system on their handset, this my no longer be correctly routed. We use patented mTagTM technology that utilises temporary reply paths for sending messages and routing replies. They do expire and may route to different accounts at that time.

top

Incomplete Message sent to Recipients

  • SMS messages are limited to 160 characters. The system takes the Email Subject Line and appends as much of the Email Message as it can, up to 160 characters.
    160 characters is about the length of the following paragraph.
    It's important 2 note that the length of the subject line determines 
    the amount of message sent to the phone. Try 2 Limit spaces & abbreviate 
    or the message wi
    

    As you can see from the example, it is easy to start a SMS email and run out of space before the main point of the email is made.

  • Messages contain my subject line and "(email message unreadable - HTML)".
    The 'text-plain' section of your email is extract for processing. If your email does not include a 'text-plain' section (eg HTML only) then the service will send your subject line, if one is used, and the text "(email message unreadable - HTML)".

top

More Information

For more information try one of the following resources or email Telecom or call 0800 GET ETXT.

  1. eTXT Website
  2. eTXT Terms and Conditions
  3. eTXT FAQ

top

Copyright Bulletin Wireless All Rights Reserved

Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.5.2 Build:#807 May 20, 2007) - Bug/feature request - Contact Administrators
Copyright © Bulletin Wireless - New Zealand - Contact Us
Important Links: --- Bug / Task Tracker --- CRM System --- Bulletin Online --- SDK --- Glossary --- FlexTXT --- Ask the Oracle