Class: Twilio::REST::Proxy::V1::ServiceContext::SessionInstance

Inherits:
InstanceResource
  • Object
show all
Defined in:
lib/twilio-ruby/rest/proxy/v1/service/session.rb

Instance Method Summary collapse

Constructor Details

#initialize(version, payload, service_sid: nil, sid: nil) ⇒ SessionInstance

Initialize the SessionInstance

Parameters:

  • version (Version)

    Version that contains the resource

  • payload (Hash)

    payload that contains response from Twilio

  • account_sid (String)

    The SID of the Account that created this Session resource.

  • sid (String) (defaults to: nil)

    The SID of the Call resource to fetch.



348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 348

def initialize(version, payload , service_sid: nil, sid: nil)
    super(version)
    
    # Marshaled Properties
    @properties = { 
        'sid' => payload['sid'],
        'service_sid' => payload['service_sid'],
        'account_sid' => payload['account_sid'],
        'date_started' => Twilio.deserialize_iso8601_datetime(payload['date_started']),
        'date_ended' => Twilio.deserialize_iso8601_datetime(payload['date_ended']),
        'date_last_interaction' => Twilio.deserialize_iso8601_datetime(payload['date_last_interaction']),
        'date_expiry' => Twilio.deserialize_iso8601_datetime(payload['date_expiry']),
        'unique_name' => payload['unique_name'],
        'status' => payload['status'],
        'closed_reason' => payload['closed_reason'],
        'ttl' => payload['ttl'] == nil ? payload['ttl'] : payload['ttl'].to_i,
        'mode' => payload['mode'],
        'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
        'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
        'url' => payload['url'],
        'links' => payload['links'],
    }

    # Context
    @instance_context = nil
    @params = { 'service_sid' => service_sid  || @properties['service_sid']  ,'sid' => sid  || @properties['sid']  , }
end

Instance Method Details

#account_sidString

Returns The SID of the [Account](www.twilio.com/docs/iam/api/account) that created the Session resource.

Returns:



401
402
403
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 401

def 
    @properties['account_sid']
end

#closed_reasonString

Returns The reason the Session ended.

Returns:

  • (String)

    The reason the Session ended.



443
444
445
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 443

def closed_reason
    @properties['closed_reason']
end

#contextSessionContext

Generate an instance context for the instance, the context is capable of performing various actions. All instance actions are proxied to the context

Returns:



380
381
382
383
384
385
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 380

def context
    unless @instance_context
        @instance_context = SessionContext.new(@version , @params['service_sid'], @params['sid'])
    end
    @instance_context
end

#date_createdTime

Returns The [ISO 8601](en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created.

Returns:



461
462
463
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 461

def date_created
    @properties['date_created']
end

#date_endedTime

Returns The [ISO 8601](en.wikipedia.org/wiki/ISO_8601) date when the Session ended.

Returns:



413
414
415
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 413

def date_ended
    @properties['date_ended']
end

#date_expiryTime

Returns The [ISO 8601](en.wikipedia.org/wiki/ISO_8601) date when the Session should expire. If this is value is present, it overrides the ‘ttl` value.

Returns:

  • (Time)

    The [ISO 8601](en.wikipedia.org/wiki/ISO_8601) date when the Session should expire. If this is value is present, it overrides the ‘ttl` value.



425
426
427
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 425

def date_expiry
    @properties['date_expiry']
end

#date_last_interactionTime

Returns The [ISO 8601](en.wikipedia.org/wiki/ISO_8601) date when the Session last had an interaction.

Returns:



419
420
421
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 419

def date_last_interaction
    @properties['date_last_interaction']
end

#date_startedTime

Returns The [ISO 8601](en.wikipedia.org/wiki/ISO_8601) date when the Session started.

Returns:



407
408
409
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 407

def date_started
    @properties['date_started']
end

#date_updatedTime

Returns The [ISO 8601](en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated.

Returns:



467
468
469
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 467

def date_updated
    @properties['date_updated']
end

#deleteBoolean

Delete the SessionInstance

Returns:

  • (Boolean)

    True if delete succeeds, false otherwise



486
487
488
489
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 486

def delete

    context.delete
end

#fetchSessionInstance

Fetch the SessionInstance

Returns:



494
495
496
497
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 494

def fetch

    context.fetch
end

#inspectObject

Provide a detailed, user friendly representation



541
542
543
544
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 541

def inspect
    values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
    "<Twilio.Proxy.V1.SessionInstance #{values}>"
end

#interactionsinteractions

Access the interactions

Returns:



521
522
523
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 521

def interactions
    context.interactions
end

Returns The URLs of resources related to the Session.

Returns:

  • (Hash)

    The URLs of resources related to the Session.



479
480
481
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 479

def links
    @properties['links']
end

#modeMode

Returns:

  • (Mode)


455
456
457
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 455

def mode
    @properties['mode']
end

#participantsparticipants

Access the participants

Returns:



528
529
530
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 528

def participants
    context.participants
end

#service_sidString

Returns The SID of the [Service](www.twilio.com/docs/proxy/api/service) the session is associated with.

Returns:



395
396
397
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 395

def service_sid
    @properties['service_sid']
end

#sidString

Returns The unique string that we created to identify the Session resource.

Returns:

  • (String)

    The unique string that we created to identify the Session resource.



389
390
391
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 389

def sid
    @properties['sid']
end

#statusStatus

Returns:

  • (Status)


437
438
439
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 437

def status
    @properties['status']
end

#to_sObject

Provide a user friendly representation



534
535
536
537
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 534

def to_s
    values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
    "<Twilio.Proxy.V1.SessionInstance #{values}>"
end

#ttlString

Returns The time, in seconds, when the session will expire. The time is measured from the last Session create or the Session’s last Interaction.

Returns:

  • (String)

    The time, in seconds, when the session will expire. The time is measured from the last Session create or the Session’s last Interaction.



449
450
451
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 449

def ttl
    @properties['ttl']
end

#unique_nameString

Returns An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. Supports UTF-8 characters. **This value should not have PII.**.

Returns:

  • (String)

    An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. Supports UTF-8 characters. **This value should not have PII.**



431
432
433
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 431

def unique_name
    @properties['unique_name']
end

#update(date_expiry: :unset, ttl: :unset, status: :unset) ⇒ SessionInstance

Update the SessionInstance

Parameters:

  • date_expiry (Time) (defaults to: :unset)

    The [ISO 8601](en.wikipedia.org/wiki/ISO_8601) date when the Session should expire. If this is value is present, it overrides the ‘ttl` value.

  • ttl (String) (defaults to: :unset)

    The time, in seconds, when the session will expire. The time is measured from the last Session create or the Session’s last Interaction.

  • status (Status) (defaults to: :unset)

Returns:



505
506
507
508
509
510
511
512
513
514
515
516
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 505

def update(
    date_expiry: :unset, 
    ttl: :unset, 
    status: :unset
)

    context.update(
        date_expiry: date_expiry, 
        ttl: ttl, 
        status: status, 
    )
end

#urlString

Returns The absolute URL of the Session resource.

Returns:

  • (String)

    The absolute URL of the Session resource.



473
474
475
# File 'lib/twilio-ruby/rest/proxy/v1/service/session.rb', line 473

def url
    @properties['url']
end