Blast File Formats

There are two formats for submitting blast files to LogicSMS. The first provides for a single message that is to be sent to many destination numbers, and the second where a unique message is to be sent to each destination number.

These are as follows;
Single Message to Many Numbers

   1. Line 1 of the file;

      This should contain the following fields, separated by commas;
          * TON- The Type Of Number for the originating address. This should be 1 for numeric and 5 for alpha-numeric.
          * NPI- The Numbering Plan Indicator for the originating number. This should be 1.
          * Originating Address- The address that will be sent as the originating number.
          * DCS- The Data Coding Scheme of the short message. Use 0 GSM alphabet, 3 for ISO-8859-1 (Latin1), 8 for UCS2/Unicode, 245 for ringtones or logos. See the note below on encoding the message.
          * ESM- The ESM_CLASS field. For normal messages or Unicode/UCS2 this should be set to 0. Set to 64 for ringtones or logos.
          * Message- The Short Message to be sent to each number in the file.

            Note: If the short message contains any quotes (") or commas (,), the sort message itself should be enclosed in quotes and the quotes in the message should be 'doubled up' (see the example below).

            Note: If the dcs is not 0 or 3, (e.g. for unicode, etc), 
then the message text is expected to contain a string of hex digits containing the encoded msg, For example, 00480045004C004C004F 
(this string of hex digits is HELLO in unicode). 
Similarly to send ringtones or logos use DCS=245, ESM=64 and code the msg as a string of hex digits in a similar fashion..
   2. Subsequent lines of the file;

      Each subsequent line of the file should contain the target recipient full international number.
   3. Note that all lines in the file should be terminated with either carriage-return/line-feed (\r\n), or just line-feed (\n).

      The following is an example of this blast file format;

      5,1,Hi There!,0,0,Have you heard about our new product? Call 44XXXYYY for more information.
      4412341234
      4412341235
      4412341236
      49222111555
      49222111676

      Or with quotes and commas;

      5,1,Hi There!,0,0,"Have you heard about ""Our Product""? Call 44XXXYYY now, for more information".
      4412341234
      4412341235
      4412341236
      49222111555
      49222111676

      Please note, that files submitted of this type, should have a file-type of 'bl1'.

Unique Message to Each Number

   1. Each line of the file;

      Should contain the following fields, separated by commas;
          * TON- The Type Of Number for the originating address. This should be 1 for numeric and 5 for alpha-numeric.
          * NPI- The Numbering Plan Indicator for the originating number. This should be 1.
          * Originating Address- The address that will be sent as the originating number.
          * DCS- The Data Coding Scheme of the short message. Use 0 GSM alphabet, 3 for ISO-8859-1 (Latin1), 8 for UCS2/Unicode, 245 for ringtones or logos. See the note below on encoding the message.
          * ESM- The ESM_CLASS field. For normal messages or Unicode/UCS2 this should be set to 0. Set to 64 for ringtones or logos.
          * Destination Address- The target recipient full international number.
          * Message- The Short Message to be sent to each number in the file.

            Note: If the short message contains any quotes (") or commas (,), the sort message itself should be enclosed in quotes and the quotes in the message should be 'doubled up' (see the example below).

            Note: If the dcs is not 0 or 3, (e.g. for unicode, etc),
 then the message text is expected to contain a string of hex digits containing the encoded msg, 
For example, 00480045004C004C004F (this string of hex digits is HELLO in unicode). 
Similarly to send ringtones or logos use DCS=245, ESM=64 and code the msg as a string of hex digits in a similar fashion..
   2. Note that all lines in the file should be terminated with either carriage-return/line-feed (\r\n), or just line-feed (\n).

      The following is an example of this blast file format (note that the third msg is sent in Unicode);

      5,1,Hi There!,0,0,4412341234,"Jim, have you heard about ""Our Product""? Call 44XXXYYY now, for more information".
      5,1,Hi There!,0,0,4412341235,"Sue, have you heard about ""Our Product""? Call 44XXXYYY now, for more information".
      5,1,Hi There!,0,8,4412341235,00480045004C004C004F

      Please note, that files submitted of this type, should have a file-type of 'bl2'.