Class: Twilio::REST::Messaging::V1::ServiceInstance
- Inherits:
-
InstanceResource
- Object
- InstanceResource
- Twilio::REST::Messaging::V1::ServiceInstance
- Defined in:
- lib/twilio-ruby/rest/messaging/v1/service.rb
Instance Method Summary collapse
-
#account_sid ⇒ String
The SID of the [Account](www.twilio.com/docs/iam/api/account) that created the Service resource.
-
#alpha_senders ⇒ alpha_senders
Access the alpha_senders.
-
#area_code_geomatch ⇒ Boolean
Whether to enable [Area Code Geomatch](www.twilio.com/docs/messaging/services#area-code-geomatch) on the Service Instance.
-
#channel_senders ⇒ channel_senders
Access the channel_senders.
-
#context ⇒ ServiceContext
Generate an instance context for the instance, the context is capable of performing various actions.
-
#date_created ⇒ Time
The date and time in GMT when the resource was created specified in [ISO 8601](en.wikipedia.org/wiki/ISO_8601) format.
-
#date_updated ⇒ Time
The date and time in GMT when the resource was last updated specified in [ISO 8601](en.wikipedia.org/wiki/ISO_8601) format.
-
#delete ⇒ Boolean
Delete the ServiceInstance.
-
#fallback_method ⇒ String
The HTTP method we use to call ‘fallback_url`.
-
#fallback_to_long_code ⇒ Boolean
- OBSOLETE
-
Former feature used to fallback to long code sender after certain short code message failures.
-
#fallback_url ⇒ String
The URL that we call using ‘fallback_method` if an error occurs while retrieving or executing the TwiML from the Inbound Request URL.
-
#fetch ⇒ ServiceInstance
Fetch the ServiceInstance.
-
#friendly_name ⇒ String
The string that you assigned to describe the resource.
-
#inbound_method ⇒ String
The HTTP method we use to call ‘inbound_request_url`.
-
#inbound_request_url ⇒ String
The URL we call using ‘inbound_method` when a message is received by any phone number or short code in the Service.
-
#initialize(version, payload, sid: nil) ⇒ ServiceInstance
constructor
Initialize the ServiceInstance.
-
#inspect ⇒ Object
Provide a detailed, user friendly representation.
-
#links ⇒ Hash
The absolute URLs of related resources.
-
#mms_converter ⇒ Boolean
Whether to enable the [MMS Converter](www.twilio.com/docs/messaging/services#mms-converter) for messages sent through the Service instance.
-
#phone_numbers ⇒ phone_numbers
Access the phone_numbers.
- #scan_message_content ⇒ ScanMessageContent
-
#short_codes ⇒ short_codes
Access the short_codes.
-
#sid ⇒ String
The unique string that we created to identify the Service resource.
-
#smart_encoding ⇒ Boolean
Whether to enable [Smart Encoding](www.twilio.com/docs/messaging/services#smart-encoding) for messages sent through the Service instance.
-
#status_callback ⇒ String
The URL we call to [pass status updates](www.twilio.com/docs/sms/api/message-resource#message-status-values) about message delivery.
-
#sticky_sender ⇒ Boolean
Whether to enable [Sticky Sender](www.twilio.com/docs/messaging/services#sticky-sender) on the Service instance.
-
#synchronous_validation ⇒ Boolean
Reserved.
-
#to_s ⇒ Object
Provide a user friendly representation.
-
#update(friendly_name: :unset, inbound_request_url: :unset, inbound_method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, sticky_sender: :unset, mms_converter: :unset, smart_encoding: :unset, scan_message_content: :unset, fallback_to_long_code: :unset, area_code_geomatch: :unset, validity_period: :unset, synchronous_validation: :unset, usecase: :unset, use_inbound_webhook_on_number: :unset) ⇒ ServiceInstance
Update the ServiceInstance.
-
#url ⇒ String
The absolute URL of the Service resource.
-
#us_app_to_person ⇒ us_app_to_person
Access the us_app_to_person.
-
#us_app_to_person_registered ⇒ Boolean
Whether US A2P campaign is registered for this Service.
-
#us_app_to_person_usecases ⇒ us_app_to_person_usecases
Access the us_app_to_person_usecases.
-
#use_inbound_webhook_on_number ⇒ Boolean
A boolean value that indicates either the webhook url configured on the phone number will be used or ‘inbound_request_url`/`fallback_url` url will be called when a message is received from the phone number.
-
#usecase ⇒ String
A string that describes the scenario in which the Messaging Service will be used.
-
#validity_period ⇒ String
How long, in seconds, messages sent from the Service are valid.
Constructor Details
#initialize(version, payload, sid: nil) ⇒ ServiceInstance
Initialize the ServiceInstance
459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 459 def initialize(version, payload , sid: nil) super(version) # Marshaled Properties @properties = { 'sid' => payload['sid'], 'account_sid' => payload['account_sid'], 'friendly_name' => payload['friendly_name'], 'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']), 'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']), 'inbound_request_url' => payload['inbound_request_url'], 'inbound_method' => payload['inbound_method'], 'fallback_url' => payload['fallback_url'], 'fallback_method' => payload['fallback_method'], 'status_callback' => payload['status_callback'], 'sticky_sender' => payload['sticky_sender'], 'mms_converter' => payload['mms_converter'], 'smart_encoding' => payload['smart_encoding'], 'scan_message_content' => payload['scan_message_content'], 'fallback_to_long_code' => payload['fallback_to_long_code'], 'area_code_geomatch' => payload['area_code_geomatch'], 'synchronous_validation' => payload['synchronous_validation'], 'validity_period' => payload['validity_period'] == nil ? payload['validity_period'] : payload['validity_period'].to_i, 'url' => payload['url'], 'links' => payload['links'], 'usecase' => payload['usecase'], 'us_app_to_person_registered' => payload['us_app_to_person_registered'], 'use_inbound_webhook_on_number' => payload['use_inbound_webhook_on_number'], } # Context @instance_context = nil @params = { 'sid' => sid || @properties['sid'] , } end |
Instance Method Details
#account_sid ⇒ String
Returns The SID of the [Account](www.twilio.com/docs/iam/api/account) that created the Service resource.
513 514 515 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 513 def account_sid @properties['account_sid'] end |
#alpha_senders ⇒ alpha_senders
Access the alpha_senders
748 749 750 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 748 def alpha_senders context.alpha_senders end |
#area_code_geomatch ⇒ Boolean
Returns Whether to enable [Area Code Geomatch](www.twilio.com/docs/messaging/services#area-code-geomatch) on the Service Instance.
597 598 599 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 597 def area_code_geomatch @properties['area_code_geomatch'] end |
#channel_senders ⇒ channel_senders
Access the channel_senders
755 756 757 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 755 def channel_senders context.channel_senders end |
#context ⇒ ServiceContext
Generate an instance context for the instance, the context is capable of performing various actions. All instance actions are proxied to the context
498 499 500 501 502 503 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 498 def context unless @instance_context @instance_context = ServiceContext.new(@version , @params['sid']) end @instance_context end |
#date_created ⇒ Time
Returns The date and time in GMT when the resource was created specified in [ISO 8601](en.wikipedia.org/wiki/ISO_8601) format.
525 526 527 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 525 def date_created @properties['date_created'] end |
#date_updated ⇒ Time
Returns The date and time in GMT when the resource was last updated specified in [ISO 8601](en.wikipedia.org/wiki/ISO_8601) format.
531 532 533 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 531 def date_updated @properties['date_updated'] end |
#delete ⇒ Boolean
Delete the ServiceInstance
646 647 648 649 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 646 def delete context.delete end |
#fallback_method ⇒ String
Returns The HTTP method we use to call ‘fallback_url`. Can be: `GET` or `POST`.
555 556 557 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 555 def fallback_method @properties['fallback_method'] end |
#fallback_to_long_code ⇒ Boolean
Returns [OBSOLETE] Former feature used to fallback to long code sender after certain short code message failures.
591 592 593 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 591 def fallback_to_long_code @properties['fallback_to_long_code'] end |
#fallback_url ⇒ String
Returns The URL that we call using ‘fallback_method` if an error occurs while retrieving or executing the TwiML from the Inbound Request URL. If the `use_inbound_webhook_on_number` field is enabled then the webhook url defined on the phone number will override the `fallback_url` defined for the Messaging Service.
549 550 551 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 549 def fallback_url @properties['fallback_url'] end |
#fetch ⇒ ServiceInstance
Fetch the ServiceInstance
654 655 656 657 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 654 def fetch context.fetch end |
#friendly_name ⇒ String
Returns The string that you assigned to describe the resource.
519 520 521 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 519 def friendly_name @properties['friendly_name'] end |
#inbound_method ⇒ String
Returns The HTTP method we use to call ‘inbound_request_url`. Can be `GET` or `POST`.
543 544 545 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 543 def inbound_method @properties['inbound_method'] end |
#inbound_request_url ⇒ String
Returns The URL we call using ‘inbound_method` when a message is received by any phone number or short code in the Service. When this property is `null`, receiving inbound messages is disabled. All messages sent to the Twilio phone number or short code will not be logged and received on the Account. If the `use_inbound_webhook_on_number` field is enabled then the webhook url defined on the phone number will override the `inbound_request_url` defined for the Messaging Service.
537 538 539 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 537 def inbound_request_url @properties['inbound_request_url'] end |
#inspect ⇒ Object
Provide a detailed, user friendly representation
768 769 770 771 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 768 def inspect values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ") "<Twilio.Messaging.V1.ServiceInstance #{values}>" end |
#links ⇒ Hash
Returns The absolute URLs of related resources.
621 622 623 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 621 def links @properties['links'] end |
#mms_converter ⇒ Boolean
Returns Whether to enable the [MMS Converter](www.twilio.com/docs/messaging/services#mms-converter) for messages sent through the Service instance.
573 574 575 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 573 def mms_converter @properties['mms_converter'] end |
#phone_numbers ⇒ phone_numbers
Access the phone_numbers
741 742 743 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 741 def phone_numbers context.phone_numbers end |
#scan_message_content ⇒ ScanMessageContent
585 586 587 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 585 def @properties['scan_message_content'] end |
#short_codes ⇒ short_codes
Access the short_codes
727 728 729 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 727 def short_codes context.short_codes end |
#sid ⇒ String
Returns The unique string that we created to identify the Service resource.
507 508 509 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 507 def sid @properties['sid'] end |
#smart_encoding ⇒ Boolean
Returns Whether to enable [Smart Encoding](www.twilio.com/docs/messaging/services#smart-encoding) for messages sent through the Service instance.
579 580 581 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 579 def smart_encoding @properties['smart_encoding'] end |
#status_callback ⇒ String
Returns The URL we call to [pass status updates](www.twilio.com/docs/sms/api/message-resource#message-status-values) about message delivery.
561 562 563 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 561 def status_callback @properties['status_callback'] end |
#sticky_sender ⇒ Boolean
Returns Whether to enable [Sticky Sender](www.twilio.com/docs/messaging/services#sticky-sender) on the Service instance.
567 568 569 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 567 def sticky_sender @properties['sticky_sender'] end |
#synchronous_validation ⇒ Boolean
Returns Reserved.
603 604 605 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 603 def synchronous_validation @properties['synchronous_validation'] end |
#to_s ⇒ Object
Provide a user friendly representation
761 762 763 764 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 761 def to_s values = @params.map{|k, v| "#{k}: #{v}"}.join(" ") "<Twilio.Messaging.V1.ServiceInstance #{values}>" end |
#update(friendly_name: :unset, inbound_request_url: :unset, inbound_method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, sticky_sender: :unset, mms_converter: :unset, smart_encoding: :unset, scan_message_content: :unset, fallback_to_long_code: :unset, area_code_geomatch: :unset, validity_period: :unset, synchronous_validation: :unset, usecase: :unset, use_inbound_webhook_on_number: :unset) ⇒ ServiceInstance
Update the ServiceInstance
678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 678 def update( friendly_name: :unset, inbound_request_url: :unset, inbound_method: :unset, fallback_url: :unset, fallback_method: :unset, status_callback: :unset, sticky_sender: :unset, mms_converter: :unset, smart_encoding: :unset, scan_message_content: :unset, fallback_to_long_code: :unset, area_code_geomatch: :unset, validity_period: :unset, synchronous_validation: :unset, usecase: :unset, use_inbound_webhook_on_number: :unset ) context.update( friendly_name: friendly_name, inbound_request_url: inbound_request_url, inbound_method: inbound_method, fallback_url: fallback_url, fallback_method: fallback_method, status_callback: status_callback, sticky_sender: sticky_sender, mms_converter: mms_converter, smart_encoding: smart_encoding, scan_message_content: , fallback_to_long_code: fallback_to_long_code, area_code_geomatch: area_code_geomatch, validity_period: validity_period, synchronous_validation: synchronous_validation, usecase: usecase, use_inbound_webhook_on_number: use_inbound_webhook_on_number, ) end |
#url ⇒ String
Returns The absolute URL of the Service resource.
615 616 617 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 615 def url @properties['url'] end |
#us_app_to_person ⇒ us_app_to_person
Access the us_app_to_person
734 735 736 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 734 def us_app_to_person context.us_app_to_person end |
#us_app_to_person_registered ⇒ Boolean
Returns Whether US A2P campaign is registered for this Service.
633 634 635 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 633 def us_app_to_person_registered @properties['us_app_to_person_registered'] end |
#us_app_to_person_usecases ⇒ us_app_to_person_usecases
Access the us_app_to_person_usecases
720 721 722 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 720 def us_app_to_person_usecases context.us_app_to_person_usecases end |
#use_inbound_webhook_on_number ⇒ Boolean
Returns A boolean value that indicates either the webhook url configured on the phone number will be used or ‘inbound_request_url`/`fallback_url` url will be called when a message is received from the phone number. If this field is enabled then the webhook url defined on the phone number will override the `inbound_request_url`/`fallback_url` defined for the Messaging Service.
639 640 641 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 639 def use_inbound_webhook_on_number @properties['use_inbound_webhook_on_number'] end |
#usecase ⇒ String
Returns A string that describes the scenario in which the Messaging Service will be used. Possible values are ‘notifications`, `marketing`, `verification`, `discussion`, `poll`, `undeclared`.
627 628 629 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 627 def usecase @properties['usecase'] end |
#validity_period ⇒ String
Returns How long, in seconds, messages sent from the Service are valid. Can be an integer from ‘1` to `14,400`.
609 610 611 |
# File 'lib/twilio-ruby/rest/messaging/v1/service.rb', line 609 def validity_period @properties['validity_period'] end |