- Quick Start Guide
- System requirements
- Installation guide
- Mobile networks
- User guide
- Standard user
- Autoreply SMS
- SMS from Excel
- SMS from Txt
- CSV file format
- SMS from FTP
- Application starter
- SMS to E-mail
- Message manipulation
- Developers guide
- Service providers
How to send SMS from TXT files
The following guide is about to show how you can send message from the file or collecting the received messages in a file as well. This guide will show you how to install and configure a TXT File connection in SMS Gateway. This connection is capable of handling multiple file formats and you can also select the location of the following message boxes: Inbox, Outbox, Sent, Failed, Delivered.
Step 1 - Create a TXT File connection
The first step of the guide is to create the TXT File connection in SMS Gateway. First of all, you need to open the SMS Gateway application, and here, select the Apps menu from the toolbar. In this menu, go to the 'Application interfaces' section, and like in Figure 1, click on the Install button of the TXT File connection.
Figure 1 - Create a TXT File connection
Step 2 - Configure the TXT File connection
After you selected the TXT File connection, you are going to be navigated to the configuration menu of the connection. In that menu, first, you need to define a name for that connection (Figure 2). Then, you have to select a file format for the SMS messages. These file formats will be discussed in the next step. Lastly, you can select folders for the messages.
Figure 2 - Configuration menu of TXT File connection
Step 3 - Select a file format
For that connection, you can select from multiple file formats. These formats handle the messages differently. The first format is the 'Simple'. The format can handle one message per file. The name of the file needs to be the recipient's phone number and the message contains the SMS message itself.
The next file format is the 'Verbose' format. This format also handles one message per file but you can specify the phone number of the sender in the file. The file extension of the Verbose format needs to be .sms.
The 'List' file format is capable of handle multiple messages and multiple recipients in the same file. Each row of the file contains the phone number of the recipient and the message. The file extension of the List format is .sml.
The 'Text' file format handles the messages the same way as the List format. The only difference between these two formats is the file extension. The List uses .sml format to manage the messages, the Text format uses the simple .txt format, so it is a little bit easier to create and manage.
The 'XML' format is a great way to clearly organize your message in the dedicated XML file. This format uses tags to define the parts of a message. The 'originator' stores the phone number of the sender and the 'recipient' stores the recipient's phone number. The 'text' tag contains the message, the 'time' tag shows the time when the message should be sent. Lastly, the 'messagetype' is for defining the type of the message. This format is also capable of handling many messages in one file.
Figure 3 below shows all the file formats, that are available in SMS Gateway.
Figure 3 - File formats for TXT File connection
Step 4 - Select folders for the messages
In the next step, you need to set the location for the different types of messages regarding to they are about to be sent or received. The messages stored into five folders as you can see it in Figure 4: Inbox, Outbox, Sent, Not Sent and Delivered.
Figure 4 - Configure the location for SMS files
Step 5 - Advanced configuration of the TXT File connection
The TXT File connection can be further configured by clicking on the Advanced tab as Figure 5 shows that. Here, the main setting is the Polling. This option defines the time interval when the outbox folder will be checked, and the connection tries to deliver the messages from all files that are in that folder at that point. If you finished with the configuration, just click on OK.
Figure 5 - Advanced configuration of TXT File connection
Step 6 - Create an SMPP service provider connection
To be able to communicate with the members of the mobile network, you need a connection that creates that link. This connection will be the SMPP client connection. To create this connection, just select the Connect menu from the toolbar, and here as you can see it in Figure 6, click on the Install button of the SMPP client connection.
Figure 6 - Install the SMPP client connection
In the configuration menu of the connection, first, you need to type a name for the connection. Next, you have to provide the details of the SMPP server where you want that connection to connect to (Figure 7). Lastly, just type the phone number with that the connection is going to communicate with the mobile network. If you finished with everything, you can just click on OK.
Figure 7 - Configure the SMPP client connection
Step 7 - Send a message from file
After you created the TXT file connection, now you will be able to send SMS messages using this connection. To do that, open the outbox folder in the File Explorer. Here, you can create a new text file, and as the format shows above, you can write multiple messages to multiple recipients in that file (Figure 8). When you finished, just save the file.
Figure 8 - Outbox folder with the message file
As soon as the TXT File connection polls the folders for files, the file from the outbox folder will disappear. This means the connection now processing the message file. As soon as it delivers the message, the message file will appear in the Sent folder as you can see it in Figure 9.
Figure 9 - Message file moved to the Sent folder
Step 8 - Receive message with the TXT File connection
The creation of the TXT File connection also created a routing rule. This routing rule ensures that all the messages that SMS Gateway receives will be routed to that TXT File connection. The connection in case of an incoming message will create a file in the Inbox folder as you can see it in Figure 10. The format of this file is the same that you defined in the settings of the connection.
Figure 10 - Message file in the Inbox folder