A Broadcast entity is a message template that has been scheduled and/or delivered to subscribers within the Mobile Database. There are three main sections to a Broadcast: the Meta data information, the Targeting information, and the Delivery information. The Metadata information is all the fields about the broadcast: the ID, URL, created date, etc. The targeting information are the fields used to identify recipients and craft the message and the Delivery information is the metadata about the actual message delivery.

Contents

Broadcast Entity

This is the JSON representation of a Broadcast entity within the APIs.

{
   "id":"328AFX343",
   "status":"scheduled",
   "url":"/api/companies/1/broadcasts/328AFX343",
   "name":"Test Broadcast SAT 2",
   "created_by":"user@company.com",
   "send_scheduled_date":"2013-11-06T17:30:00Z",
   "send_schedule":{
      "method":"by_time_zone",
      "field_name":"vibes_timezone",
      "send_date":"2013-11-06",
      "send_time":"17:30",
      "default_time_zone":"US/Central"
   },
   "targeting":{
      "message_template":"Test Broadcast SAT 2 {{ list_name }} Reply HELP for help, STOP to cancel-Msg&data rates may apply",
      "shorten_urls":true,
      "short_url_base":"http://vbs.cm/",
      "source_short_code":"54321",
      "source_lists":[
         "AB1234Z4",
         "LIST12345"
      ],
      "filters":[
         {
            "name":"favorite_sport",
            "selector":"any",
            "value":[
               "football",
               "baseball"
            ]
         },
         {
            "name":"first_name",
            "selector":"starts_with",
            "value":"Steve"
         },
         {
            "name":"recipient_list",
            "selector":"any",
            "value":["1"]
         },
		 {
            "name":"participant_list",
            "selector":"any",
            "value":["1"]
         },
         {
            "name":"country",
            "selector":"equals",
            "value":"US"
         },
         {
            "name":"subscription_date",
            "transform":"year",
            "selector":"before",
            "value":[
               "2013"
            ]
         },
         {
            "name":"birthdate",
            "transform":"year",
            "selector":"before",
            "value":[
               "2013"
            ]
         }
      ]
   }
}

"delivery" : {
  "send_start_date": "2013-11-02T18:54:43Z",
  "enqueue_completed_date": "2013-11-02T18:54:43Z",
  "recipient_count": 50,
},

"created_at": "2013-11-02T18:58:53Z",
"updated_at": "2013-11-02T18:58:53Z"
}