Send SMS using JSON address book

Learn how to send an SMS to multiple contacts using a JSON address book in Ozeki SMS Gateway. This guide shows you how to prepare and import a JSON contact list, select the address book in SMS Messenger, compose your message, and check the sending results.

Template JSON file: json_template.json

File content example: 

{
  "Contacts": [
    {
      "Name": "George Washington",
      "Phone": "17890430",
      "Email": "george@washington.com"
    },
    {
      "Name": "John Adams",
      "Phone": "17970304",
      "Email": "john@adams.com"
    },
    {
      "Name": "Thomas Jefferson",
      "Phone": "18010304",
      "Email": "thomas@jefferson.com"
    },
    {
      "Name": "James Madison",
      "Phone": "18090304",
      "Email": "james@madison.com"
    },
    {
      "Name": "James Monroe",
      "Phone": "18170304",
      "Email": "james@monroe.com"
    }
  ]
}

JSON address book example
JSON address book example

Log in to Ozeki SMS Gateway and open SMS Messenger. This is where you will import the JSON address book and compose the SMS.

Open SMS Messenger
Figure 1 - Open SMS Messenger

In SMS Messenger, open the Contacts menu to manage address books. Before importing, prepare a JSON file with a Contacts array containing each recipient’s Name, Phone, and Email.

Open Contacts menu
Figure 2 - Open Contacts menu

Choose the JSON address book option in Contacts. This tells SMS Messenger to create an address book from a JSON file rather than adding contacts individually.

Select JSON address book
Figure 3 - Select JSON address book

Select and upload your prepared JSON file. Check that each entry has the intended phone number in its Phone field, since those numbers will be used as SMS recipients.

Upload JSON file
Figure 4 - Upload JSON file

Confirm that the new address book appears in Contacts after the upload. It is now ready to use as the recipient list for a group message.

JSON address book created
Figure 5 - JSON address book created

Return to the message composer and choose the imported JSON address book as the recipient. SMS Messenger will use its contacts instead of a single manually entered number.

Select address book for recipient
Figure 6 - Select address book for recipient

Write the SMS, review the selected address book and message text, then click Send. This submits the message for the contacts in the JSON address book.

Send message
Figure 7 - Send message

Check the sent messages to verify that SMS Messenger created messages for the address book’s recipients. Review their send status rather than assuming every handset received the SMS.

Message sent to all recipient
Figure 8 - Message sent to all recipient

More information