Class: Twilio::REST::Conversations::V1::ConversationContext::WebhookInstance

Inherits:
InstanceResource
  • Object
show all
Defined in:
lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb

Instance Method Summary collapse

Constructor Details

#initialize(version, payload, conversation_sid: nil, sid: nil) ⇒ WebhookInstance

Initialize the WebhookInstance

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 Webhook resource.

  • sid (String) (defaults to: nil)

    The SID of the Call resource to fetch.



317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 317

def initialize(version, payload , conversation_sid: nil, sid: nil)
    super(version)
    
    # Marshaled Properties
    @properties = { 
        'sid' => payload['sid'],
        'account_sid' => payload['account_sid'],
        'conversation_sid' => payload['conversation_sid'],
        'target' => payload['target'],
        'url' => payload['url'],
        'configuration' => payload['configuration'],
        'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
        'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
    }

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

Instance Method Details

#account_sidString

Returns The unique ID of the [Account](www.twilio.com/docs/iam/api/account) responsible for this conversation.

Returns:



356
357
358
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 356

def 
    @properties['account_sid']
end

#configurationHash

Returns The configuration of this webhook. Is defined based on target.

Returns:

  • (Hash)

    The configuration of this webhook. Is defined based on target.



380
381
382
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 380

def configuration
    @properties['configuration']
end

#contextWebhookContext

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

Returns:



341
342
343
344
345
346
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 341

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

#conversation_sidString

Returns The unique ID of the [Conversation](www.twilio.com/docs/conversations/api/conversation-resource) for this webhook.

Returns:



362
363
364
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 362

def conversation_sid
    @properties['conversation_sid']
end

#date_createdTime

Returns The date that this resource was created.

Returns:

  • (Time)

    The date that this resource was created.



386
387
388
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 386

def date_created
    @properties['date_created']
end

#date_updatedTime

Returns The date that this resource was last updated.

Returns:

  • (Time)

    The date that this resource was last updated.



392
393
394
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 392

def date_updated
    @properties['date_updated']
end

#deleteBoolean

Delete the WebhookInstance

Returns:

  • (Boolean)

    True if delete succeeds, false otherwise



399
400
401
402
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 399

def delete

    context.delete
end

#fetchWebhookInstance

Fetch the WebhookInstance

Returns:



407
408
409
410
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 407

def fetch

    context.fetch
end

#inspectObject

Provide a detailed, user friendly representation



446
447
448
449
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 446

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

#sidString

Returns A 34 character string that uniquely identifies this resource.

Returns:

  • (String)

    A 34 character string that uniquely identifies this resource.



350
351
352
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 350

def sid
    @properties['sid']
end

#targetString

Returns The target of this webhook: ‘webhook`, `studio`, `trigger`.

Returns:

  • (String)

    The target of this webhook: ‘webhook`, `studio`, `trigger`



368
369
370
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 368

def target
    @properties['target']
end

#to_sObject

Provide a user friendly representation



439
440
441
442
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 439

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

#update(configuration_url: :unset, configuration_method: :unset, configuration_filters: :unset, configuration_triggers: :unset, configuration_flow_sid: :unset) ⇒ WebhookInstance

Update the WebhookInstance

Parameters:

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

    The absolute url the webhook request should be sent to.

  • configuration_method (Method) (defaults to: :unset)
  • configuration_filters (Array[String]) (defaults to: :unset)

    The list of events, firing webhook event for this Conversation.

  • configuration_triggers (Array[String]) (defaults to: :unset)

    The list of keywords, firing webhook event for this Conversation.

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

    The studio flow SID, where the webhook should be sent to.

Returns:



420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 420

def update(
    configuration_url: :unset, 
    configuration_method: :unset, 
    configuration_filters: :unset, 
    configuration_triggers: :unset, 
    configuration_flow_sid: :unset
)

    context.update(
        configuration_url: configuration_url, 
        configuration_method: configuration_method, 
        configuration_filters: configuration_filters, 
        configuration_triggers: configuration_triggers, 
        configuration_flow_sid: configuration_flow_sid, 
    )
end

#urlString

Returns An absolute API resource URL for this webhook.

Returns:

  • (String)

    An absolute API resource URL for this webhook.



374
375
376
# File 'lib/twilio-ruby/rest/conversations/v1/conversation/webhook.rb', line 374

def url
    @properties['url']
end