Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Last Updated:

Lastupdatedate

Livesearch
placeholderSearch the Vibes Developer Wiki
typepage



Overview

A Broadcast entity is a message template that has been scheduled and/or delivered to Subscribers within the Mobile Database.

The following are the three main sections to a Broadcast:

  • The Metadata information, which includes the fields about the Broadcast, such as the ID, URL, created date, and so on.
  • The Targeting information, which includes the fields used to identify recipients and craft the message.
  • The Delivery information, which is the metadata about the actual message delivery.


Panel
borderColor#2B9CD7

Topics in this Section

Page Tree
root@self
startDepth2




Broadcast Entity

The following is the JSON representation of an SMS Broadcast entity within the APIs.

Code Block
{
    "broadcast_id": "1",
    "status": "sent",
    "name": "First alert message",
    "send_scheduled_date": "2017-04-04T16:05:00Z",
    "created_by":"user@company.com",
    "created_by_application": null,
    "targeting": {
      "message_template": "This is the 1st message sent to the {{ list_name }} list!",
      "short_url_base":"http://vbs.cm/",
      "shorten_urls": true,
      "channel": "sms",
      "source_short_code": null,
      "source_lists": [
        "

...

A34H2q"
      ],
      "filters": []
    },
    "delivery": {
      "send_start_date": "2017-04-04T16:06:16Z",
      "enqueue_completed_date": "2017-04-04T16:06:16Z",
      "recipient_count": 1
    },
    "url": "/companies/

...

:company_key/mobiledb/broadcasts/

...

:broadcast_id",
    "created_at": "2017-04-04T16:06:10Z",
    "updated_at": "2019-05-12T05:09:48Z"
  }

...

The following is the JSON representation of a Push Broadcast entity within the APIs.

Code Block
{
  

...

"id": "328AFX343",
  

...

"status": "scheduled",
  

...

"url": "/api/companies/1/broadcasts/328AFX343",
  

...

"name": "Test Broadcast SAT 2",
  

...

"created_by": "user@company.com",
  

...

"created_by_application": "api",

...

  "send_scheduled_date": "2017-02-16T17:30:00Z",
  

...

"send_schedule": {

...

    "method": "by_time_zone",

...

    "field_name": "vibes_timezone",
    

...

"send_date": "2017-02-16",
    

...

"send_time": "17:30",
    

...

"default_time_zone": "US/Central"
  

...

},

...

  "targeting": {
    

...

"message_template": "

...

Push 

...

message content",
    

...

"shorten_urls": true,

...

    

...

"short_url_base": "http://vbs.cm/",
    

...

"source_short_code": "54321",
    

...

"source_lists": [
      

...

"AB1234Z4",

...

      

...

"LIST12345"
    

...

],

...

    "channel": "push",
    

...

"push": {

...


...

      

...

"

...

subject": "

...

Push 

...

message 

...

title",
  

...

 

...

   

...

"

...

metadata":

...

 

...

"App deep link"
    },
    

...

"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": [
          

...

"2017"
        

...

]

...

      },
      

...

{
        

...

"name": "birthdate",
        

...

"transform": "year",
        

...

"selector": "before",

...

        

...

"value": [

...

          "2017"

...

        

...

]
      

...

}
    

...

]

...


  

...

}

...


}

Elements

Data Element

Type

Description

id

Integer

Vibes unique identifier for each Broadcast.

status

String

The status of the Broadcast. Examples (always lowercase):

  • scheduled: The Broadcast will be sent at a scheduled time.
  • in_progress: The Broadcast as begun sending.
  • sent: The Broadcast has finished sending.
  • canceled: The Broadcast has been canceled.
  • deleted: The Broadcast was canceled before sending.
  • paused: The Broadcast is waiting for an external action.
  • failed: The Broadcast has failed.
urlStringUnique resource URL for the Acquisition Campaign.
nameStringThe descriptive name of the Broadcast message. Example: "First alert message".
created_byStringThe email address of the person who created the Broadcast.
created_by_application

String

The application. Example: null, api.
send_scheduled_dateTimestampThe date and time the Broadcast is scheduled to be sent. It should be in the ISO 8601 format - for example: 2017-02-16T17:30:00Z.

targeting

Object

The targeting information for the Broadcast. The message_template is the text for the SMS or push message (with optional custom field or incentive tags).

Examples: message_template, channel, short_url_base, source_short_code, source_lists, shorten_urls.

deliveryTimestamp, StringThe information about the Broadcast delivery, including recipient_count, send_start_date, and enqueue_completed_date.
created_atTimestampThe date this Broadcast was created. It should be in the ISO 8601 format - for example: 2017-04-04T16:06:10Z.
updated_atTimestampThe date this Broadcast was last updated.

...

 

 

 

 

 

 

...

 It should be in the ISO 8601 format - for example: 2019-05-12T05:09:48Z.