Class: Telerivet::ScheduledMessage

Inherits:
Entity
  • Object
show all
Defined in:
lib/telerivet/scheduledmessage.rb

Overview

Represents a scheduled message within Telerivet.

Fields:

- id (string, max 34 characters)
    * ID of the scheduled message
    * Read-only

- content
    * Text content of the scheduled message
    * Updatable via API

- rrule
    * Recurrence rule for recurring scheduled messages, e.g. 'FREQ=MONTHLY' or
        'FREQ=WEEKLY;INTERVAL=2'; see
        [RFC2445](https://tools.ietf.org/html/rfc2445#section-4.3.10).
    * Updatable via API

- timezone_id
    * Timezone ID used to compute times for recurring messages; see [List of tz database
        time zones Wikipedia
        article](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
    * Updatable via API

- recipients (array of objects)
    * List of recipients. Each recipient is an object with a string `type` property, which
        may be `"phone_number"`, `"group"`, or `"filter"`.

        If the type is `"phone_number"`, the `phone_number` property will
        be set to the recipient's phone number.

        If the type is `"group"`, the `group_id` property will be set to
        the ID of the group, and the `group_name` property will be set to the name of the
        group.

        If the type is `"filter"`, the `filter_type` property (string) and
        `filter_params` property (object) describe the filter used to send the broadcast. (API
        clients should not rely on a particular value or format of the `filter_type` or
        `filter_params` properties, as they may change without notice.)
    * Read-only

- recipients_str
    * A string with a human readable description of the first few recipients (possibly
        truncated)
    * Read-only

- group_id
    * ID of the group to send the message to (null if the recipient is an individual
        contact, or if there are multiple recipients)
    * Updatable via API

- contact_id
    * ID of the contact to send the message to (null if the recipient is a group, or if
        there are multiple recipients)
    * Updatable via API

- to_number
    * Phone number to send the message to (null if the recipient is a group, or if there
        are multiple recipients)
    * Updatable via API

- route_id
    * ID of the phone or route the message will be sent from
    * Updatable via API

- service_id (string, max 34 characters)
    * The service associated with this message (for voice calls, the service defines the
        call flow)
    * Updatable via API

- audio_url
    * For voice calls, the URL of an MP3 file to play when the contact answers the call
    * Updatable via API

- tts_lang
    * For voice calls, the language of the text-to-speech voice
    * Allowed values: en-US, en-GB, en-GB-WLS, en-AU, en-IN, da-DK, nl-NL, fr-FR, fr-CA,
        de-DE, is-IS, it-IT, pl-PL, pt-BR, pt-PT, ru-RU, es-ES, es-US, sv-SE
    * Updatable via API

- tts_voice
    * For voice calls, the text-to-speech voice
    * Allowed values: female, male
    * Updatable via API

- message_type
    * Type of scheduled message
    * Allowed values: sms, mms, ussd, ussd_session, call, chat, service
    * Read-only

- time_created (UNIX timestamp)
    * Time the scheduled message was created in Telerivet
    * Read-only

- start_time (UNIX timestamp)
    * The time that the message will be sent (or first sent for recurring messages)
    * Updatable via API

- end_time (UNIX timestamp)
    * Time after which a recurring message will stop (not applicable to non-recurring
        scheduled messages)
    * Updatable via API

- prev_time (UNIX timestamp)
    * The most recent time that Telerivet has sent this scheduled message (null if it has
        never been sent)
    * Read-only

- next_time (UNIX timestamp)
    * The next upcoming time that Telerivet will sent this scheduled message (null if it
        will not be sent again)
    * Read-only

- occurrences (int)
    * Number of times this scheduled message has already been sent
    * Read-only

- replace_variables (bool)
    * Set to true if Telerivet will render variables like [[contact.name]] in the message
        content, false otherwise
    * Updatable via API

- track_clicks (boolean)
    * If true, URLs in the message content will automatically be replaced with unique
        short URLs
    * Updatable via API

- media (array)
    * For text messages containing media files, this is an array of objects with the
        properties `url`, `type` (MIME type), `filename`, and `size` (file size in bytes).
        Unknown properties are null. This property is undefined for messages that do not
        contain media files. Note: For files uploaded via the Telerivet web app, the URL is
        temporary and may not be valid for more than 1 day.
    * Read-only

- route_params (Hash)
    * Route-specific parameters to use when sending the message. The parameters object may
        have keys matching the `phone_type` field of a phone (basic route) that may be used to
        send the message. The corresponding value is an object with route-specific parameters
        to use when sending a message with that type of route.
    * Updatable via API

- vars (Hash)
    * Custom variables stored for this scheduled message (copied to Message when sent)
    * Updatable via API

- label_ids (array)
    * IDs of labels to add to the Message
    * Updatable via API

- relative_scheduled_id
    * ID of the relative scheduled message this scheduled message was created from, if
        applicable
    * Read-only

- project_id
    * ID of the project this scheduled message belongs to
    * Read-only

Instance Method Summary collapse

Methods inherited from Entity

#get, #initialize, #load, #set, #set_data, #to_s, #vars

Constructor Details

This class inherits a constructor from Telerivet::Entity

Instance Method Details

#audio_url ⇒ Object 



255
256
257
 
# File 'lib/telerivet/scheduledmessage.rb', line 255

def audio_url
    get('audio_url')
end

#audio_url=(value) ⇒ Object 



259
260
261
 
# File 'lib/telerivet/scheduledmessage.rb', line 259

def audio_url=(value)
    set('audio_url', value)
end

#contact_id ⇒ Object 



223
224
225
 
# File 'lib/telerivet/scheduledmessage.rb', line 223

def contact_id
    get('contact_id')
end

#contact_id=(value) ⇒ Object 



227
228
229
 
# File 'lib/telerivet/scheduledmessage.rb', line 227

def contact_id=(value)
    set('contact_id', value)
end

#content ⇒ Object 



183
184
185
 
# File 'lib/telerivet/scheduledmessage.rb', line 183

def content
    get('content')
end

#content=(value) ⇒ Object 



187
188
189
 
# File 'lib/telerivet/scheduledmessage.rb', line 187

def content=(value)
    set('content', value)
end

#delete ⇒ Object

Cancels this scheduled message.



175
176
177
 
# File 'lib/telerivet/scheduledmessage.rb', line 175

def delete()
    @api.do_request("DELETE", get_base_api_path())
end

#end_time ⇒ Object 



295
296
297
 
# File 'lib/telerivet/scheduledmessage.rb', line 295

def end_time
    get('end_time')
end

#end_time=(value) ⇒ Object 



299
300
301
 
# File 'lib/telerivet/scheduledmessage.rb', line 299

def end_time=(value)
    set('end_time', value)
end

#get_base_api_path ⇒ Object 



359
360
361
 
# File 'lib/telerivet/scheduledmessage.rb', line 359

def get_base_api_path()
    "/projects/#{get('project_id')}/scheduled/#{get('id')}"
end

#group_id ⇒ Object 



215
216
217
 
# File 'lib/telerivet/scheduledmessage.rb', line 215

def group_id
    get('group_id')
end

#group_id=(value) ⇒ Object 



219
220
221
 
# File 'lib/telerivet/scheduledmessage.rb', line 219

def group_id=(value)
    set('group_id', value)
end

#id ⇒ Object 



179
180
181
 
# File 'lib/telerivet/scheduledmessage.rb', line 179

def id
    get('id')
end

#label_ids ⇒ Object 



343
344
345
 
# File 'lib/telerivet/scheduledmessage.rb', line 343

def label_ids
    get('label_ids')
end

#label_ids=(value) ⇒ Object 



347
348
349
 
# File 'lib/telerivet/scheduledmessage.rb', line 347

def label_ids=(value)
    set('label_ids', value)
end

#media ⇒ Object 



331
332
333
 
# File 'lib/telerivet/scheduledmessage.rb', line 331

def media
    get('media')
end

#message_type ⇒ Object 



279
280
281
 
# File 'lib/telerivet/scheduledmessage.rb', line 279

def message_type
    get('message_type')
end

#next_time ⇒ Object 



307
308
309
 
# File 'lib/telerivet/scheduledmessage.rb', line 307

def next_time
    get('next_time')
end

#occurrences ⇒ Object 



311
312
313
 
# File 'lib/telerivet/scheduledmessage.rb', line 311

def occurrences
    get('occurrences')
end

#prev_time ⇒ Object 



303
304
305
 
# File 'lib/telerivet/scheduledmessage.rb', line 303

def prev_time
    get('prev_time')
end

#project_id ⇒ Object 



355
356
357
 
# File 'lib/telerivet/scheduledmessage.rb', line 355

def project_id
    get('project_id')
end

#recipients ⇒ Object 



207
208
209
 
# File 'lib/telerivet/scheduledmessage.rb', line 207

def recipients
    get('recipients')
end

#recipients_str ⇒ Object 



211
212
213
 
# File 'lib/telerivet/scheduledmessage.rb', line 211

def recipients_str
    get('recipients_str')
end

#relative_scheduled_id ⇒ Object 



351
352
353
 
# File 'lib/telerivet/scheduledmessage.rb', line 351

def relative_scheduled_id
    get('relative_scheduled_id')
end

#replace_variables ⇒ Object 



315
316
317
 
# File 'lib/telerivet/scheduledmessage.rb', line 315

def replace_variables
    get('replace_variables')
end

#replace_variables=(value) ⇒ Object 



319
320
321
 
# File 'lib/telerivet/scheduledmessage.rb', line 319

def replace_variables=(value)
    set('replace_variables', value)
end

#route_id ⇒ Object 



239
240
241
 
# File 'lib/telerivet/scheduledmessage.rb', line 239

def route_id
    get('route_id')
end

#route_id=(value) ⇒ Object 



243
244
245
 
# File 'lib/telerivet/scheduledmessage.rb', line 243

def route_id=(value)
    set('route_id', value)
end

#route_params ⇒ Object 



335
336
337
 
# File 'lib/telerivet/scheduledmessage.rb', line 335

def route_params
    get('route_params')
end

#route_params=(value) ⇒ Object 



339
340
341
 
# File 'lib/telerivet/scheduledmessage.rb', line 339

def route_params=(value)
    set('route_params', value)
end

#rrule ⇒ Object 



191
192
193
 
# File 'lib/telerivet/scheduledmessage.rb', line 191

def rrule
    get('rrule')
end

#rrule=(value) ⇒ Object 



195
196
197
 
# File 'lib/telerivet/scheduledmessage.rb', line 195

def rrule=(value)
    set('rrule', value)
end

#save ⇒ Object

Saves any fields or custom variables that have changed for this scheduled message.



168
169
170
 
# File 'lib/telerivet/scheduledmessage.rb', line 168

def save()
    super
end

#service_id ⇒ Object 



247
248
249
 
# File 'lib/telerivet/scheduledmessage.rb', line 247

def service_id
    get('service_id')
end

#service_id=(value) ⇒ Object 



251
252
253
 
# File 'lib/telerivet/scheduledmessage.rb', line 251

def service_id=(value)
    set('service_id', value)
end

#start_time ⇒ Object 



287
288
289
 
# File 'lib/telerivet/scheduledmessage.rb', line 287

def start_time
    get('start_time')
end

#start_time=(value) ⇒ Object 



291
292
293
 
# File 'lib/telerivet/scheduledmessage.rb', line 291

def start_time=(value)
    set('start_time', value)
end

#time_created ⇒ Object 



283
284
285
 
# File 'lib/telerivet/scheduledmessage.rb', line 283

def time_created
    get('time_created')
end

#timezone_id ⇒ Object 



199
200
201
 
# File 'lib/telerivet/scheduledmessage.rb', line 199

def timezone_id
    get('timezone_id')
end

#timezone_id=(value) ⇒ Object 



203
204
205
 
# File 'lib/telerivet/scheduledmessage.rb', line 203

def timezone_id=(value)
    set('timezone_id', value)
end

#to_number ⇒ Object 



231
232
233
 
# File 'lib/telerivet/scheduledmessage.rb', line 231

def to_number
    get('to_number')
end

#to_number=(value) ⇒ Object 



235
236
237
 
# File 'lib/telerivet/scheduledmessage.rb', line 235

def to_number=(value)
    set('to_number', value)
end

#track_clicks ⇒ Object 



323
324
325
 
# File 'lib/telerivet/scheduledmessage.rb', line 323

def track_clicks
    get('track_clicks')
end

#track_clicks=(value) ⇒ Object 



327
328
329
 
# File 'lib/telerivet/scheduledmessage.rb', line 327

def track_clicks=(value)
    set('track_clicks', value)
end

#tts_lang ⇒ Object 



263
264
265
 
# File 'lib/telerivet/scheduledmessage.rb', line 263

def tts_lang
    get('tts_lang')
end

#tts_lang=(value) ⇒ Object 



267
268
269
 
# File 'lib/telerivet/scheduledmessage.rb', line 267

def tts_lang=(value)
    set('tts_lang', value)
end

#tts_voice ⇒ Object 



271
272
273
 
# File 'lib/telerivet/scheduledmessage.rb', line 271

def tts_voice
    get('tts_voice')
end

#tts_voice=(value) ⇒ Object 



275
276
277
 
# File 'lib/telerivet/scheduledmessage.rb', line 275

def tts_voice=(value)
    set('tts_voice', value)
end