telerivet 1.8.2 → 1.9.6

data/lib/telerivet/project.rb

@@ -25,6 +25,7 @@ module Telerivet
 #   
 #   - url_slug
 #       * Unique string used as a component of the project's URL in the Telerivet web app
+#           (required length: 3-18 characters)
 #       * Updatable via API
 #   
 #   - default_route_id
@@ -41,6 +42,17 @@ module Telerivet
 #           contact.
 #       * Updatable via API
 #   
+#   - message_retention_days (int)
+#       * Number of days to retain messages in this project. Messages older than this will be
+#           automatically deleted. If null, messages will be retained forever.
+#       * Updatable via API
+#   
+#   - short_link_scheme (bool)
+#       * If true (the default), short links in messages will include the scheme (e.g.,
+#           'https://rvt.me/xxxxxxxxx'). If false, short links will not include the scheme (e.g.,
+#           'rvt.me/xxxxxxxxx').
+#       * Updatable via API
+#   
 #   - vars (Hash)
 #       * Custom variables stored for this project. Variable names may be up to 32 characters
 #           in length and can contain the characters a-z, A-Z, 0-9, and _.
@@ -53,6 +65,10 @@ module Telerivet
 #   - organization_id (string, max 34 characters)
 #       * ID of the organization this project belongs to
 #       * Read-only
+#   
+#   - url
+#       * URL to this project in the Telerivet web app
+#       * Read-only
 #
 class Project < Entity
     #
@@ -93,7 +109,7 @@ class Project < Entity
     #     
     #     - replace_variables (bool)
     #         * Set to true to evaluate variables like [[contact.name]] in message content. [(See
-    #             available variables)](#variables) (`is_template` parameter also accepted)
+    #             available variables)](#variables)
     #         * Default: false
     #     
     #     - track_clicks (boolean)
@@ -115,18 +131,15 @@ class Project < Entity
     #             destination URL.
     #             If null, the short links will not expire.
     #     
-    #     - media_urls (array)
-    #         * URLs of media files to attach to the text message. If `message_type` is `sms`,
-    #             short links to each URL will be appended to the end of the content (separated by a
-    #             new line).
+    #     - media (array)
+    #         * Array of media attachments for the text message.
     #             
+    #             If sending a type of message that doesn't support attachments (e.g. SMS),
+    #             short links to each media URL will be appended to the end of the content (separated
+    #             by a new line).
     #             
-    #             By default, each file must have a https:// or http:// URL, which requires the file
-    #             to be uploaded somewhere that is accessible via the internet. For media files that
-    #             are not already accessible via the internet, the media_urls parameter also supports
-    #             data URIs with the file data encoded via Base64 (e.g. "data:image/png;base64,..."),
-    #             with a maximum file size of 2 MB. To send media via data URIs, contact Telerivet to
-    #             request enabling the data URIs feature for your project.
+    #             Alternatively, you can use the `media_urls` parameter with an array of URL
+    #             strings.
     #     
     #     - route_params (Hash)
     #         * Route-specific parameters for the message.
@@ -243,8 +256,8 @@ class Project < Entity
     #             set)
     #     
     #     - replace_variables (bool)
-    #         * Set to true to evaluate variables like [[contact.name]] in message content [(See
-    #             available variables)](#variables) (`is_template` parameter also accepted)
+    #         * Set to true to evaluate variables like [[contact.name]] in message content. [(See
+    #             available variables)](#variables)
     #         * Default: false
     #     
     #     - track_clicks (boolean)
@@ -266,18 +279,15 @@ class Project < Entity
     #             destination URL.
     #             If null, the short links will not expire.
     #     
-    #     - media_urls (array)
-    #         * URLs of media files to attach to the text message. If `message_type` is `sms`,
-    #             short links to each URL will be appended to the end of the content (separated by a
-    #             new line).
+    #     - media (array)
+    #         * Array of media attachments for the text message.
     #             
+    #             If sending a type of message that doesn't support attachments (e.g. SMS),
+    #             short links to each media URL will be appended to the end of the content (separated
+    #             by a new line).
     #             
-    #             By default, each file must have a https:// or http:// URL, which requires the file
-    #             to be uploaded somewhere that is accessible via the internet. For media files that
-    #             are not already accessible via the internet, the media_urls parameter also supports
-    #             data URIs with the file data encoded via Base64 (e.g. "data:image/png;base64,..."),
-    #             with a maximum file size of 2 MB. To send media via data URIs, contact Telerivet to
-    #             request enabling the data URIs feature for your project.
+    #             Alternatively, you can use the `media_urls` parameter with an array of URL
+    #             strings.
     #     
     #     - vars (Hash)
     #         * Custom variables to set for each message
@@ -372,8 +382,8 @@ class Project < Entity
     #         * Array of IDs of labels to add to each message (maximum 5)
     #     
     #     - replace_variables (bool)
-    #         * Set to true to evaluate variables like [[contact.name]] in message content [(See
-    #             available variables)](#variables) (`is_template` parameter also accepted)
+    #         * Set to true to evaluate variables like [[contact.name]] in message content. [(See
+    #             available variables)](#variables)
     #         * Default: false
     #     
     #     - track_clicks (boolean)
@@ -395,18 +405,15 @@ class Project < Entity
     #             destination URL.
     #             If null, the short links will not expire.
     #     
-    #     - media_urls (array)
-    #         * URLs of media files to attach to the text message. If `message_type` is `sms`,
-    #             short links to each URL will be appended to the end of the content (separated by a
-    #             new line).
+    #     - media (array)
+    #         * Array of media attachments for the text message.
     #             
+    #             If sending a type of message that doesn't support attachments (e.g. SMS),
+    #             short links to each media URL will be appended to the end of the content (separated
+    #             by a new line).
     #             
-    #             By default, each file must have a https:// or http:// URL, which requires the file
-    #             to be uploaded somewhere that is accessible via the internet. For media files that
-    #             are not already accessible via the internet, the media_urls parameter also supports
-    #             data URIs with the file data encoded via Base64 (e.g. "data:image/png;base64,..."),
-    #             with a maximum file size of 2 MB. To send media via data URIs, contact Telerivet to
-    #             request enabling the data URIs feature for your project.
+    #             Alternatively, you can use the `media_urls` parameter with an array of URL
+    #             strings.
     #     
     #     - route_params (Hash)
     #         * Route-specific parameters to apply to all messages.
@@ -497,7 +504,7 @@ class Project < Entity
     # should be provided.
     # 
     # With `message_type`=`service`, schedules an automated service (such
-    # as a poll) to be invoked for a group or list of phone numbers. Any service that can be
+    # as a poll) to be invoked for a group or an individual contact. Any service that can be
     # triggered for a contact can be scheduled via this method, whether or not the service
     # actually sends a message.
     # 
@@ -587,22 +594,19 @@ class Project < Entity
     #             If null, the short links will not expire.
     #     
     #     - replace_variables (bool)
-    #         * Set to true to evaluate variables like [[contact.name]] in message content
-    #             (`is_template` parameter also accepted)
+    #         * Set to true to evaluate variables like [[contact.name]] in message content. [(See
+    #             available variables)](#variables)
     #         * Default: false
     #     
-    #     - media_urls (array)
-    #         * URLs of media files to attach to the text message. If `message_type` is `sms`,
-    #             short links to each URL will be appended to the end of the content (separated by a
-    #             new line).
+    #     - media (array)
+    #         * Array of media attachments for the text message.
     #             
+    #             If sending a type of message that doesn't support attachments (e.g. SMS),
+    #             short links to each media URL will be appended to the end of the content (separated
+    #             by a new line).
     #             
-    #             By default, each file must have a https:// or http:// URL, which requires the file
-    #             to be uploaded somewhere that is accessible via the internet. For media files that
-    #             are not already accessible via the internet, the media_urls parameter also supports
-    #             data URIs with the file data encoded via Base64 (e.g. "data:image/png;base64,..."),
-    #             with a maximum file size of 2 MB. To send media via data URIs, contact Telerivet to
-    #             request enabling the data URIs feature for your project.
+    #             Alternatively, you can use the `media_urls` parameter with an array of URL
+    #             strings.
     #     
     #     - route_params (Hash)
     #         * Route-specific parameters to use when sending the message.
@@ -696,10 +700,10 @@ class Project < Entity
     #         * Required
     #     
     #     - offset_scale
-    #         * The type of interval (day/week/month/year) that will be used to adjust the
-    #             scheduled date relative to the date stored in the contact's date_variable, when
-    #             offset_count is non-zero (D=day, W=week, M=month, Y=year)
-    #         * Allowed values: D, W, M, Y
+    #         * The type of interval that will be used to adjust the scheduled date relative to
+    #             the date stored in the contact's date_variable, when offset_count is non-zero
+    #             (I=minutes, D=day, W=week, M=month, Y=year)
+    #         * Allowed values: I, D, W, M, Y
     #         * Default: D
     #     
     #     - offset_count (int)
@@ -764,21 +768,19 @@ class Project < Entity
     #             If null, the short links will not expire.
     #     
     #     - replace_variables (bool)
-    #         * Set to true to evaluate variables like [[contact.name]] in message content
+    #         * Set to true to evaluate variables like [[contact.name]] in message content. [(See
+    #             available variables)](#variables)
     #         * Default: false
     #     
-    #     - media_urls (array)
-    #         * URLs of media files to attach to the text message. If `message_type` is `sms`,
-    #             short links to each URL will be appended to the end of the content (separated by a
-    #             new line).
+    #     - media (array)
+    #         * Array of media attachments for the text message.
     #             
+    #             If sending a type of message that doesn't support attachments (e.g. SMS),
+    #             short links to each media URL will be appended to the end of the content (separated
+    #             by a new line).
     #             
-    #             By default, each file must have a https:// or http:// URL, which requires the file
-    #             to be uploaded somewhere that is accessible via the internet. For media files that
-    #             are not already accessible via the internet, the media_urls parameter also supports
-    #             data URIs with the file data encoded via Base64 (e.g. "data:image/png;base64,..."),
-    #             with a maximum file size of 2 MB. To send media via data URIs, contact Telerivet to
-    #             request enabling the data URIs feature for your project.
+    #             Alternatively, you can use the `media_urls` parameter with an array of URL
+    #             strings.
     #     
     #     - route_params (Hash)
     #         * Route-specific parameters to use when sending the message.
@@ -1171,6 +1173,209 @@ class Project < Entity
         return Phone.new(@api, {'project_id' => self.id, 'id' => id}, false)
     end
 
+    #
+    # Creates a new basic route (phone) with external API credentials.
+    # 
+    # For some external API providers, this method automatically updates webhook URLs configured
+    # with the external provider so that incoming messages/calls and call status events are routed
+    # to Telerivet. In this case, if you have already configured a webhook URL with the external
+    # provider, it will be overwritten. For other external API providers, webhook URLs may require
+    # manual configuration in order for the route to be fully functional.
+    # 
+    # Note: This API can only create routes that connect to external gateway APIs using your own
+    # account credentials. To add Android phones, WhatsApp routes, or routes with
+    # Telerivet-managed billing, use the web app instead.
+    # 
+    # Credentials are passed via the `external_account_id`, `external_id`, `external_secret`, and
+    # `external_config` parameters. The meaning of these parameters for each phone type is as
+    # follows:
+    # 
+    # **Twilio Virtual Number** (`phone_type`: twilio):
+    # 
+    # - external_id (optional): Twilio phone number SID (starts with 'PN'); looked up by
+    # phone_number if not provided
+    # - external_account_id (required): Twilio Account SID (starts with 'AC')
+    # - external_secret (required): Twilio Auth Token
+    # 
+    # **Twilio Messaging Service** (`phone_type`: twilio_messaging_service):
+    # 
+    # - external_id (required): Twilio messaging service SID (starts with 'MG')
+    # - external_account_id (required): Twilio Account SID (starts with 'AC')
+    # - external_secret (required): Twilio Auth Token
+    # 
+    # **Twilio Shortcode** (`phone_type`: twilio_shortcode):
+    # 
+    # - external_id (optional): Twilio shortcode SID (starts with 'SC'); looked up by phone_number
+    # if not provided
+    # - external_account_id (required): Twilio Account SID (starts with 'AC')
+    # - external_secret (required): Twilio Auth Token
+    # 
+    # **Twilio Caller ID** (`phone_type`: twilio_caller_id):
+    # 
+    # - external_account_id (required): Twilio Account SID (starts with 'AC')
+    # - external_secret (required): Twilio Auth Token
+    # 
+    # **Vonage Virtual Number** (`phone_type`: nexmo):
+    # 
+    # - external_account_id (required): Vonage API Key
+    # - external_secret (required): Vonage API Secret
+    # 
+    # **Vonage Sender ID** (`phone_type`: nexmo_sender_id):
+    # 
+    # - external_account_id (required): Vonage API Key
+    # - external_secret (required): Vonage API Secret
+    # 
+    # **Telesign SMS** (`phone_type`: telesign):
+    # 
+    # - external_account_id (required): Telesign Customer ID
+    # - external_secret (required): Telesign API Key
+    # - external_config.message_type: ARN, MKT, or OTP
+    # - external_config.sender_type: one_way (default) or two_way
+    # 
+    # **Infobip SMS** (`phone_type`: infobip):
+    # 
+    # - external_account_id (required): Infobip username
+    # - external_secret (required): Infobip API key
+    # - external_config.sender_type: one_way (default) or two_way
+    # - external_config.india_dlt_principal_entity_id: India DLT Principal Entity ID (only for
+    # India)
+    # 
+    # **Infobip USSD** (`phone_type`: infobip_ussd):
+    # 
+    # - No external credentials required
+    # 
+    # **Africa's Talking SMS** (`phone_type`: africas_talking):
+    # 
+    # - external_account_id (required): Africa's Talking username
+    # - external_secret (required): Africa's Talking API key
+    # - external_config.sender_type: one_way (default) or two_way
+    # 
+    # **Africa's Talking USSD** (`phone_type`: africas_talking_ussd):
+    # 
+    # - No external credentials required
+    # 
+    # **Simulated Phone** (`phone_type`: simulated):
+    # 
+    # - No external credentials required
+    # - Messages are simulated locally and not sent to any external provider
+    # - Useful for testing
+    # 
+    # #### Webhook URL Setup
+    # 
+    # Some route types require manual configuration of callback URLs in the external provider's
+    # dashboard. When the Phone response includes an `external_setup` object, you will need to
+    # configure the webhook URLs in your provider's account settings.
+    # 
+    # The following phone types require manual webhook setup:
+    # 
+    # - `africas_talking`: `message_status_url` (always), `incoming_message_url` (if two_way)
+    # - `africas_talking_ussd`: `incoming_call_url`
+    # - `infobip_ussd`: `incoming_call_url`
+    # - `twilio_messaging_service`: `incoming_message_url`
+    # - `telesign` (two_way only): `incoming_message_url`
+    # 
+    # Telerivet automatically configures webhooks for the following phone types as follows:
+    # 
+    # - `twilio` - automatically updates incoming SMS and voice configuration for the Twilio
+    # virtual number associated with the phone_number or external_id parameter
+    # - `twilio_shortcode` - automatically updates incoming SMS configuration for the Twilio short
+    # code associated with the phone_number or external_id parameter
+    # - `nexmo` - automatically updates incoming SMS and voice configuration for the Vonage
+    # virtual number matching the phone_number parameter
+    # - `infobip` - automatically updates incoming SMS configuration for the Infobip virtual
+    # number matching the phone_number parameter or external_id parameter
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - name (string)
+    #         * Name of the basic route to create
+    #     
+    #     - phone_number (string)
+    #         * Phone number or sender ID
+    #         * Required
+    #     
+    #     - phone_type (string)
+    #         * Type of basic route to create. Supported values: twilio, twilio_messaging_service,
+    #             twilio_shortcode, twilio_caller_id, nexmo, infobip, africas_talking,
+    #             africas_talking_ussd, infobip_ussd, telesign, simulated. Other types of basic routes
+    #             can only be created via the web app.
+    #         * Required
+    #     
+    #     - external_account_id (string)
+    #         * Account ID for the external API (e.g. Twilio Account SID, Vonage API Key). See the
+    #             description above for the meaning of this parameter for each phone type.
+    #     
+    #     - external_id (string)
+    #         * External phone/resource ID within the external API account (if applicable). For
+    #             `twilio` and `twilio_shortcode` routes, this is optional and will be looked up
+    #             automatically from the phone_number if not provided.
+    #     
+    #     - external_secret (string)
+    #         * Secret/API key for the external API (e.g. Twilio Auth Token, Vonage API Secret).
+    #             This value is required when creating a new route but is never returned in API
+    #             responses. See the description above for the meaning of this parameter for each
+    #             phone type.
+    #     
+    #     - external_config (Hash)
+    #         * Additional configuration settings specific to the phone_type. See the description
+    #             above for available settings for each phone type.
+    #     
+    #     - country
+    #         * 2-letter country code (ISO 3166-1 alpha-2) where phone is from. This country code
+    #             is used to automatically convert phone numbers in local format to international
+    #             format. If not provided, will be set to the organization's country by default.
+    #     
+    #     - send_paused (bool)
+    #         * True if sending messages should initially be paused, false otherwise
+    #         * Default:
+    #     
+    #     - timezone_id (string)
+    #         * A string specifying the time zone used when sending messages; see [List of tz
+    #             database time zones Wikipedia
+    #             article](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones). When not
+    #             provided, the project's default time zone is used.
+    #     
+    #     - validate_recipient_numbers (bool)
+    #         * Set to true to validate recipient phone numbers before sending. Messages to
+    #             invalid numbers will fail without being sent.
+    #         * Default:
+    #     
+    #     - allowed_recipient_countries (array of strings)
+    #         * Array of 2-letter country codes (ISO 3166-1 alpha-2) to which this phone is
+    #             allowed to send messages. If not provided, there is no restriction.
+    #     
+    #     - send_delay (number)
+    #         * Number of seconds to wait after sending each message, to avoid exceeding carrier
+    #             rate limits.
+    #     
+    #     - quiet_mode (string)
+    #         * Controls behavior during quiet hours. Possible values: 'off' (disabled), 'delay'
+    #             (messages delayed until quiet hours end), 'confirm' (requires manual confirmation;
+    #             worker-based routes only).
+    #         * Allowed values: off, delay, confirm
+    #         * Default: off
+    #     
+    #     - quiet_start (string)
+    #         * Time when quiet hours begin, in HH:MM format (24-hour time). Only applicable when
+    #             quiet_mode is not 'off'.
+    #     
+    #     - quiet_end (string)
+    #         * Time when quiet hours end, in HH:MM format (24-hour time). Only applicable when
+    #             quiet_mode is not 'off'.
+    #     
+    #     - vars
+    #         * Custom variables and values to set for this basic route
+    #   
+    # Returns:
+    #     Telerivet::Phone
+    #
+    def create_phone(options)
+        require_relative 'phone'
+        Phone.new(@api, @api.do_request("POST", get_base_api_path() + "/phones", options))
+    end
+
     #
     # Queries messages within the given project.
     # 
@@ -1191,7 +1396,7 @@ class Project < Entity
     #     - source
     #         * Filter messages by source
     #         * Allowed values: phone, provider, web, api, service, webhook, scheduled,
-    #             integration
+    #             integration, mcp
     #     
     #     - starred (bool)
     #         * Filter messages by starred/unstarred
@@ -1364,6 +1569,213 @@ class Project < Entity
         return Broadcast.new(@api, {'project_id' => self.id, 'id' => id}, false)
     end
 
+    #
+    # Queries campaigns within the given project.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #     
+    #     - name
+    #         * Filter campaigns by name
+    #         * Allowed modifiers: name[ne], name[prefix], name[not_prefix], name[gte], name[gt],
+    #             name[lt], name[lte]
+    #     
+    #     - status
+    #         * Filter campaigns by status
+    #         * Allowed values: draft, scheduled, sent, pending_review
+    #     
+    #     - campaign_type
+    #         * Filter campaigns by type
+    #         * Allowed values: broadcast_text, broadcast_call, broadcast_svc, relative,
+    #             anniversary
+    #     
+    #     - group_id
+    #         * Filter campaigns by the recipient group
+    #     
+    #     - label_id
+    #         * Filter campaigns by an associated label
+    #     
+    #     - time_created[min] (UNIX timestamp)
+    #         * Filter campaigns created on or after a particular time
+    #     
+    #     - time_created[max] (UNIX timestamp)
+    #         * Filter campaigns created before a particular time
+    #     
+    #     - schedule_time[min] (UNIX timestamp)
+    #         * Filter broadcast campaigns scheduled on or after a particular time
+    #     
+    #     - schedule_time[max] (UNIX timestamp)
+    #         * Filter broadcast campaigns scheduled before a particular time
+    #     
+    #     - sort
+    #         * Sort the results based on a field
+    #         * Allowed values: default, name, schedule_time
+    #         * Default: default
+    #     
+    #     - sort_dir
+    #         * Sort the results in ascending or descending order
+    #         * Allowed values: asc, desc
+    #         * Default: asc
+    #     
+    #     - page_size (int)
+    #         * Number of results returned per page (max 500)
+    #         * Default: 50
+    #     
+    #     - offset (int)
+    #         * Number of items to skip from beginning of result set
+    #         * Default: 0
+    #   
+    # Returns:
+    #     Telerivet::APICursor (of Telerivet::Campaign)
+    #
+    def query_campaigns(options = nil)
+        require_relative 'campaign'
+        @api.cursor(Campaign, get_base_api_path() + "/campaigns", options)
+    end
+
+    #
+    # Retrieves the campaign with the given ID.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the campaign
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::Campaign
+    #
+    def get_campaign_by_id(id)
+        require_relative 'campaign'
+        Campaign.new(@api, @api.do_request("GET", get_base_api_path() + "/campaigns/#{id}"))
+    end
+
+    #
+    # Initializes the Telerivet campaign with the given ID without making an API request.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the campaign
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::Campaign
+    #
+    def init_campaign_by_id(id)
+        require_relative 'campaign'
+        return Campaign.new(@api, {'project_id' => self.id, 'id' => id}, false)
+    end
+
+    #
+    # Creates a new draft campaign, without sending it.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - campaign_type
+    #         * Type of campaign to create
+    #         * Allowed values: broadcast_text, broadcast_call, broadcast_svc, relative,
+    #             anniversary
+    #         * Required
+    #     
+    #     - name
+    #         * Name of the campaign
+    #     
+    #     - group_id
+    #         * ID of the group of contacts to send the campaign to
+    #     
+    #     - exclude_group_id
+    #         * ID of a group of contacts to exclude from this campaign
+    #     
+    #     - route_id
+    #         * ID of the phone or route to send the campaign from
+    #     
+    #     - timezone_id
+    #         * ID of the timezone to use for scheduling
+    #     
+    #     - label_ids (array)
+    #         * IDs of labels to apply to messages sent by this campaign
+    #     
+    #     - respondent_group_id
+    #         * ID of the group to add contacts to after they respond
+    #     
+    #     - clicked_group_id
+    #         * ID of the group to add contacts to after they click a link
+    #     
+    #     - schedule_mode
+    #         * Indicates whether the campaign should be sent immediately or at a future time
+    #             (broadcast campaigns only). If `schedule_time` is set, `schedule_mode` is
+    #             automatically set to `at_time`. If `schedule_mode` is set to `immediate` or `null`,
+    #             `schedule_time` is automatically cleared.
+    #             
+    #             Note that the campaign will not actually be sent or
+    #             scheduled until the API method is called to [send the campaign](#Campaign.send).
+    #         * Allowed values: immediate, at_time
+    #     
+    #     - schedule_time (UNIX timestamp)
+    #         * When the campaign is scheduled to be sent, as a UNIX timestamp (broadcast
+    #             campaigns only). Setting this to a non-null value automatically sets `schedule_mode`
+    #             to `at_time`.
+    #             
+    #             Note that the campaign will not actually be scheduled
+    #             until the API method is called to [schedule the campaign](#Campaign.send).
+    #     
+    #     - content
+    #         * Text content of the message (`broadcast_text` campaigns), or the text-to-speech
+    #             text for voice calls (`broadcast_call` campaigns). May contain variables like
+    #             `[[contact.name]]`.
+    #             
+    #             [(See available variables)](#variables)
+    #     
+    #     - media (array)
+    #         * Array of media attachments (`broadcast_text` campaigns only).
+    #     
+    #     - route_params (Hash)
+    #         * Route-specific parameters for the message (`broadcast_text` campaigns only). See
+    #             [Route-Specific Parameters](#route_params).
+    #     
+    #     - track_clicks (boolean)
+    #         * Whether to shorten links and track link clicks (`broadcast_text` campaigns only).
+    #     
+    #     - short_link_params (Hash)
+    #         * Parameters for short links when `track_clicks` is enabled (`broadcast_text`
+    #             campaigns only).
+    #     
+    #     - audio_url
+    #         * URL of an MP3 file to play for voice calls (`broadcast_call` campaigns only).
+    #     
+    #     - tts_lang
+    #         * Language for text-to-speech voice calls (`broadcast_call` campaigns only).
+    #         * 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
+    #     
+    #     - tts_voice
+    #         * Voice for text-to-speech voice calls (`broadcast_call` campaigns only).
+    #         * Allowed values: female, male
+    #     
+    #     - date_variable
+    #         * Custom contact variable storing date or date/time values relative to which
+    #             messages will be scheduled (`relative` and `anniversary` campaigns only)
+    #     
+    #     - items (array)
+    #         * Array of campaign items (`relative` and `anniversary` campaigns only).
+    #     
+    #     - vars (Hash)
+    #         * Custom variables and values to set for this campaign. Variable names may be up to
+    #             32 characters in length and can contain the characters a-z, A-Z, 0-9, and _.
+    #             Values may be strings, numbers, or boolean (true/false).
+    #             String values may be up to 4096 bytes in length when encoded as UTF-8.
+    #             Up to 100 variables are supported per object.
+    #             Setting a variable to null will delete the variable.
+    #   
+    # Returns:
+    #     Telerivet::Campaign
+    #
+    def create_campaign(options)
+        require_relative 'campaign'
+        Campaign.new(@api, @api.do_request("POST", get_base_api_path() + "/campaigns", options))
+    end
+
     #
     # Creates and starts an asynchronous task that is applied to all entities matching a filter
     # (e.g. contacts, messages, or data rows).
@@ -1691,7 +2103,9 @@ class Project < Entity
     end
 
     #
-    # Retrieves or creates a group by name.
+    # Retrieves or creates a group by name. If a group with that name does not exist, a new normal
+    # group will be created, initially empty. (To create a dynamic group, use
+    # [project.createGroup](#Project.createGroup).)
     # 
     # Arguments:
     #   - name
@@ -1706,6 +2120,66 @@ class Project < Entity
         Group.new(@api, @api.do_request("POST", get_base_api_path() + "/groups", {'name' => name}))
     end
 
+    #
+    # Creates a new group.
+    # 
+    # If the `filters` parameter is provided, the group will be a dynamic
+    # group whose members are determined by the filter conditions. Otherwise, it will be a normal
+    # group, initially empty, with the ability to manually add members via
+    # [contact.addToGroup](#Contact.addToGroup) and remove members via
+    # [contact.removeFromGroup](#Contact.removeFromGroup).
+    # 
+    # Dynamic group filter conditions can later be updated via the
+    # `filters` property of the Group object; a group cannot be converted between a normal group
+    # and a dynamic group after it is created.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - name (string)
+    #         * Name of the group (must be unique within the project)
+    #         * Required
+    #     
+    #     - filters (Hash)
+    #         * Key-value pairs of conditions that contacts must match to be members of a dynamic
+    #             group. To filter by a custom variable, precede the variable name with 'vars.'
+    #             (conditions on custom variables may also be provided as a nested object under a
+    #             `vars` key, e.g. `{"vars": {"city": "Manila"}}`); other supported keys are `id`,
+    #             `name`, `phone_number`, `time_created`, `time_updated`, `incoming_message_count`,
+    #             `outgoing_message_count`, `last_incoming_message_time`,
+    #             `last_outgoing_message_time`, `conversation_status`, `send_blocked`, `group` (ID of
+    #             a normal group whose members should be included), `not_group` (ID of a normal group
+    #             whose members should be excluded), and `q` (full-text search query matching contacts
+    #             like the search box in the web app). Each value is either a value to match exactly,
+    #             or an object with an operator such as `ne`, `prefix`, `gte`, `lt`, `exists`, or
+    #             `not_exists` as the key (e.g. `{"gte": 10}`).
+    #     
+    #     - allow_sending (bool)
+    #         * True if messages can be sent to this group, false otherwise.
+    #         * Default: 1
+    #     
+    #     - add_time_variable (string)
+    #         * Variable name of a custom contact field that will automatically be set to the
+    #             current date/time on any contact that is added to the group. This variable will only
+    #             be set if the contact does not already have a value for this variable.
+    #     
+    #     - vars (Hash)
+    #         * Custom variables and values to set for this group. Variable names may be up to 32
+    #             characters in length and can contain the characters a-z, A-Z, 0-9, and _.
+    #             Values may be strings, numbers, or boolean (true/false).
+    #             String values may be up to 4096 bytes in length when encoded as UTF-8.
+    #             Up to 100 variables are supported per object.
+    #             Setting a variable to null will delete the variable.
+    #   
+    # Returns:
+    #     Telerivet::Group
+    #
+    def create_group(options)
+        require_relative 'group'
+        Group.new(@api, @api.do_request("POST", get_base_api_path() + "/create_group", options))
+    end
+
     #
     # Retrieves the group with the given ID.
     # 
@@ -1824,16 +2298,19 @@ class Project < Entity
     end
 
     #
-    # Queries data tables within the given project.
+    # Queries message templates within the given project.
     # 
     # Arguments:
     #   - options (Hash)
     #     
     #     - name
-    #         * Filter data tables by name
+    #         * Filter templates by name
     #         * Allowed modifiers: name[ne], name[prefix], name[not_prefix], name[gte], name[gt],
     #             name[lt], name[lte]
     #     
+    #     - waba_id
+    #         * Filter templates by WhatsApp Business Account ID
+    #     
     #     - sort
     #         * Sort the results based on a field
     #         * Allowed values: default, name
@@ -1853,57 +2330,315 @@ class Project < Entity
     #         * Default: 0
     #   
     # Returns:
-    #     Telerivet::APICursor (of Telerivet::DataTable)
+    #     Telerivet::APICursor (of Telerivet::MessageTemplate)
     #
-    def query_data_tables(options = nil)
-        require_relative 'datatable'
-        @api.cursor(DataTable, get_base_api_path() + "/tables", options)
+    def query_message_templates(options = nil)
+        require_relative 'messagetemplate'
+        @api.cursor(MessageTemplate, get_base_api_path() + "/message_templates", options)
     end
 
     #
-    # Gets or creates a data table by name.
+    # Creates a new message template that can be used when composing or scheduling messages.
     # 
     # Arguments:
-    #   - name
-    #       * Name of the data table
+    #   - options (Hash)
     #       * Required
+    #     
+    #     - name (string)
+    #         * Name of the template (max 127 characters)
+    #         * Required
+    #     
+    #     - content (string)
+    #         * Content of the message template (max 2000 characters)
+    #         * Required
+    #     
+    #     - track_clicks (bool)
+    #         * If true, URLs in the content will be replaced with short links that track clicks.
+    #             Requires a plan with click tracking enabled.
+    #         * Default:
+    #     
+    #     - short_link_params (Hash)
+    #         * If `track_clicks` is true, `short_link_params` may be used to specify custom
+    #             parameters for each short link.
+    #     
+    #     - attachments (array)
+    #         * List of attachment objects with file URLs to include with the template
+    #     
+    #     - route_params (Hash)
+    #         * Route-specific parameters to use when sending messages with this template.
+    #             
+    #             When sending messages via chat apps such as WhatsApp, the route_params
+    #             parameter can be used to send messages with app-specific features such as quick
+    #             replies and link buttons.
+    #             
+    #             For more details, see [Route-Specific Parameters](#route_params).
     #   
     # Returns:
-    #     Telerivet::DataTable
+    #     Telerivet::MessageTemplate
     #
-    def get_or_create_data_table(name)
-        require_relative 'datatable'
-        DataTable.new(@api, @api.do_request("POST", get_base_api_path() + "/tables", {'name' => name}))
+    def create_message_template(options)
+        require_relative 'messagetemplate'
+        MessageTemplate.new(@api, @api.do_request("POST", get_base_api_path() + "/message_templates", options))
     end
 
     #
-    # Retrieves the data table with the given ID.
+    # Retrieves the message template with the given ID.
     # 
     # Arguments:
     #   - id
-    #       * ID of the data table
+    #       * ID of the message template
     #       * Required
     #   
     # Returns:
-    #     Telerivet::DataTable
+    #     Telerivet::MessageTemplate
     #
-    def get_data_table_by_id(id)
-        require_relative 'datatable'
-        DataTable.new(@api, @api.do_request("GET", get_base_api_path() + "/tables/#{id}"))
+    def get_message_template_by_id(id)
+        require_relative 'messagetemplate'
+        MessageTemplate.new(@api, @api.do_request("GET", get_base_api_path() + "/message_templates/#{id}"))
     end
 
     #
-    # Initializes the data table with the given ID without making an API request.
+    # Initializes the message template with the given ID without making an API request.
     # 
     # Arguments:
     #   - id
-    #       * ID of the data table
+    #       * ID of the message template
     #       * Required
     #   
     # Returns:
-    #     Telerivet::DataTable
+    #     Telerivet::MessageTemplate
     #
-    def init_data_table_by_id(id)
+    def init_message_template_by_id(id)
+        require_relative 'messagetemplate'
+        return MessageTemplate.new(@api, {'project_id' => self.id, 'id' => id}, false)
+    end
+
+    #
+    # Queries files stored within the given project.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #     
+    #     - filename
+    #         * Filter files by filename
+    #         * Allowed modifiers: filename[ne], filename[prefix], filename[not_prefix],
+    #             filename[gte], filename[gt], filename[lt], filename[lte]
+    #     
+    #     - type
+    #         * Filter files by MIME type. A type ending in `/*` matches any subtype (e.g.
+    #             `image/*`).
+    #     
+    #     - category
+    #         * Filter files by category
+    #         * Allowed values: outgoing_media, incoming_media, call_audio, test_recording,
+    #             script_module, icon
+    #     
+    #     - source
+    #         * Filter files by how they were created
+    #         * Allowed values: upload, recording, message, api
+    #     
+    #     - size (int)
+    #         * Filter files by size in bytes
+    #         * Allowed modifiers: size[min], size[max]
+    #     
+    #     - time_created (UNIX timestamp)
+    #         * Filter files by time_created
+    #         * Allowed modifiers: time_created[min], time_created[max]
+    #     
+    #     - message_id
+    #         * Filter files associated with a particular message
+    #     
+    #     - sha256
+    #         * Filter files by the SHA-256 hash of the file content (lowercase hex), e.g. to
+    #             check whether a particular file has already been uploaded
+    #     
+    #     - sort
+    #         * Sort the results based on a field
+    #         * Allowed values: default, filename, size, time_created
+    #         * Default: default
+    #     
+    #     - sort_dir
+    #         * Sort the results in ascending or descending order
+    #         * Allowed values: asc, desc
+    #         * Default: asc
+    #     
+    #     - page_size (int)
+    #         * Number of results returned per page (max 500)
+    #         * Default: 50
+    #     
+    #     - offset (int)
+    #         * Number of items to skip from beginning of result set
+    #         * Default: 0
+    #   
+    # Returns:
+    #     Telerivet::APICursor (of Telerivet::StoredFile)
+    #
+    def query_files(options = nil)
+        require_relative 'storedfile'
+        @api.cursor(StoredFile, get_base_api_path() + "/files", options)
+    end
+
+    #
+    # Uploads a file to be stored by Telerivet.
+    # 
+    # After uploading a file, it can be attached to an outgoing message by
+    # passing its ID as a `file_id` item in the `media` parameter of
+    # [project.sendMessage](#Project.sendMessage),
+    # [project.sendBroadcast](#Project.sendBroadcast), or [project.sendMulti](#Project.sendMulti).
+    # This makes it possible to upload a media file once and attach it to many messages, instead
+    # of including the file content in every API request.
+    # 
+    # The file content is provided inline via the `data` parameter,
+    # encoded via Base64, with a maximum decoded file size of 5 MB. Image, video, audio, PDF, and
+    # vCard files are supported.
+    # 
+    # Files are deduplicated by content: if a file previously uploaded via
+    # the API in the same project has the same content and MIME type, the existing stored file is
+    # returned instead of creating a duplicate.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - data (string)
+    #         * Base64-encoded file content (max 5 MB decoded). Alternatively, a Base64 data URI
+    #             such as `data:image/jpeg;base64,...`, in which case the `type` parameter may be
+    #             omitted.
+    #         * Required
+    #     
+    #     - filename (string, max 127 characters)
+    #         * Filename of the stored file. If not provided, the filename is generated
+    #             automatically.
+    #     
+    #     - type (string)
+    #         * MIME type of the file, e.g. `image/jpeg`. If `data` is a data URI, the type may be
+    #             omitted, but must match the MIME type of the data URI if provided.
+    #         * Required unless `data` is a data URI
+    #     
+    #     - description (string, max 1000 characters)
+    #         * Description of the file
+    #   
+    # Returns:
+    #     Telerivet::StoredFile
+    #
+    def upload_file(options)
+        require_relative 'storedfile'
+        StoredFile.new(@api, @api.do_request("POST", get_base_api_path() + "/files", options))
+    end
+
+    #
+    # Retrieves the stored file with the given ID.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the stored file
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::StoredFile
+    #
+    def get_file_by_id(id)
+        require_relative 'storedfile'
+        StoredFile.new(@api, @api.do_request("GET", get_base_api_path() + "/files/#{id}"))
+    end
+
+    #
+    # Initializes the stored file with the given ID without making an API request.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the stored file
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::StoredFile
+    #
+    def init_file_by_id(id)
+        require_relative 'storedfile'
+        return StoredFile.new(@api, {'project_id' => self.id, 'id' => id}, false)
+    end
+
+    #
+    # Queries data tables within the given project.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #     
+    #     - name
+    #         * Filter data tables by name
+    #         * Allowed modifiers: name[ne], name[prefix], name[not_prefix], name[gte], name[gt],
+    #             name[lt], name[lte]
+    #     
+    #     - sort
+    #         * Sort the results based on a field
+    #         * Allowed values: default, name
+    #         * Default: default
+    #     
+    #     - sort_dir
+    #         * Sort the results in ascending or descending order
+    #         * Allowed values: asc, desc
+    #         * Default: asc
+    #     
+    #     - page_size (int)
+    #         * Number of results returned per page (max 500)
+    #         * Default: 50
+    #     
+    #     - offset (int)
+    #         * Number of items to skip from beginning of result set
+    #         * Default: 0
+    #   
+    # Returns:
+    #     Telerivet::APICursor (of Telerivet::DataTable)
+    #
+    def query_data_tables(options = nil)
+        require_relative 'datatable'
+        @api.cursor(DataTable, get_base_api_path() + "/tables", options)
+    end
+
+    #
+    # Gets or creates a data table by name.
+    # 
+    # Arguments:
+    #   - name
+    #       * Name of the data table
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::DataTable
+    #
+    def get_or_create_data_table(name)
+        require_relative 'datatable'
+        DataTable.new(@api, @api.do_request("POST", get_base_api_path() + "/tables", {'name' => name}))
+    end
+
+    #
+    # Retrieves the data table with the given ID.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the data table
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::DataTable
+    #
+    def get_data_table_by_id(id)
+        require_relative 'datatable'
+        DataTable.new(@api, @api.do_request("GET", get_base_api_path() + "/tables/#{id}"))
+    end
+
+    #
+    # Initializes the data table with the given ID without making an API request.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the data table
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::DataTable
+    #
+    def init_data_table_by_id(id)
         require_relative 'datatable'
         return DataTable.new(@api, {'project_id' => self.id, 'id' => id}, false)
     end
@@ -2065,19 +2800,144 @@ class Project < Entity
         return RelativeScheduledMessage.new(@api, {'project_id' => self.id, 'id' => id}, false)
     end
 
+    #
+    # Queries scheduled services within the given project.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #     
+    #     - service_id
+    #         * Filter scheduled services by the service ID
+    #     
+    #     - time_created (UNIX timestamp)
+    #         * Filter scheduled services by time_created
+    #         * Allowed modifiers: time_created[min], time_created[max]
+    #     
+    #     - next_time (UNIX timestamp)
+    #         * Filter scheduled services by next_time
+    #         * Allowed modifiers: next_time[min], next_time[max]
+    #     
+    #     - sort
+    #         * Sort the results based on a field
+    #         * Allowed values: default, next_time
+    #         * Default: default
+    #     
+    #     - sort_dir
+    #         * Sort the results in ascending or descending order
+    #         * Allowed values: asc, desc
+    #         * Default: asc
+    #     
+    #     - page_size (int)
+    #         * Number of results returned per page (max 500)
+    #         * Default: 50
+    #     
+    #     - offset (int)
+    #         * Number of items to skip from beginning of result set
+    #         * Default: 0
+    #   
+    # Returns:
+    #     Telerivet::APICursor (of Telerivet::ScheduledService)
+    #
+    def query_scheduled_services(options = nil)
+        require_relative 'scheduledservice'
+        @api.cursor(ScheduledService, get_base_api_path() + "/scheduled_services", options)
+    end
+
+    #
+    # Schedules a service to be triggered at a specified time.
+    # 
+    # Only services that can be triggered for the project context and
+    # handle the default event can be scheduled. This includes services with types
+    # `scheduled_actions`, `scheduled_script`, and other service types that support project-level
+    # triggering.
+    # 
+    # (Note: To schedule services that are triggered for a contact,
+    # [project.scheduleMessage](#Project.scheduleMessage) should be used instead with
+    # `message_type`=`service`.)
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - service_id
+    #         * ID of the service to schedule
+    #         * Required
+    #     
+    #     - start_time (UNIX timestamp)
+    #         * The time that the service will be triggered (or first triggered for recurring
+    #             scheduled services)
+    #         * Required if start_time_offset not set
+    #     
+    #     - start_time_offset (int)
+    #         * Number of seconds from now to trigger the service
+    #     
+    #     - rrule
+    #         * A recurrence rule describing how the schedule repeats, e.g. 'FREQ=MONTHLY' or
+    #             'FREQ=WEEKLY;INTERVAL=2'; see <https://tools.ietf.org/html/rfc2445#section-4.3.10>.
+    #             (UNTIL is ignored; use end_time parameter instead).
+    #         * Default: COUNT=1 (one-time scheduled service, does not repeat)
+    #     
+    #     - timezone_id
+    #         * TZ database timezone ID; see [List of tz database time zones Wikipedia
+    #             article](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
+    #         * Default: project default timezone
+    #     
+    #     - end_time (UNIX timestamp)
+    #         * Time after which a recurring scheduled service will stop (not applicable to
+    #             non-recurring scheduled services)
+    #     
+    #     - end_time_offset (int)
+    #         * Number of seconds from now until the recurring scheduled service will stop
+    #     
+    #     - vars (Hash)
+    #         * Custom variables to store for this scheduled service
+    #   
+    # Returns:
+    #     Telerivet::ScheduledService
+    #
+    def schedule_service(options)
+        require_relative 'scheduledservice'
+        ScheduledService.new(@api, @api.do_request("POST", get_base_api_path() + "/scheduled_services", options))
+    end
+
+    #
+    # Retrieves the scheduled service with the given ID.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the scheduled service
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::ScheduledService
+    #
+    def get_scheduled_service_by_id(id)
+        require_relative 'scheduledservice'
+        ScheduledService.new(@api, @api.do_request("GET", get_base_api_path() + "/scheduled_services/#{id}"))
+    end
+
+    #
+    # Initializes the scheduled service with the given ID without making an API request.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the scheduled service
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::ScheduledService
+    #
+    def init_scheduled_service_by_id(id)
+        require_relative 'scheduledservice'
+        return ScheduledService.new(@api, {'project_id' => self.id, 'id' => id}, false)
+    end
+
     #
     # Creates a new automated service.
     # 
     # Only certain types of automated services can be created via the API.
     # Other types of services can only be created via the web app.
     # 
-    # Although Custom Actions services cannot be created directly via the
-    # API, they may be converted to a template,
-    # and then instances of the template can be created via this method
-    # with `service_type`=`custom_template_instance`. Converting a service
-    # to a template requires the Service Templates feature to be enabled
-    # for the organization.
-    # 
     # Arguments:
     #   - options (Hash)
     #       * Required
@@ -2090,63 +2950,43 @@ class Project < Entity
     #         * Type of service to create.  The following service types can be created via the
     #             API:
     #             
+    #             - incoming_message_actions
+    #             - contact_actions
+    #             - message_actions
+    #             - project_actions
+    #             - message_status_actions
+    #             - voice_actions
+    #             - ussd_actions
+    #             - data_row_actions
     #             - incoming_message_webhook
+    #             - optin_optout
+    #             - keyword_auto_reply
     #             - messaging_poll
+    #             - voice_poll
+    #             - scheduled_actions
+    #             - auto_reply
+    #             - call_auto_reply
     #             - incoming_message_script
     #             - contact_script
     #             - message_script
     #             - data_row_script
+    #             - scheduled_script
     #             - webhook_script
     #             - voice_script
     #             - ussd_script
     #             - project_script
+    #             - opt_out_page
+    #             - button_page
     #             - custom_template_instance
     #             
     #             Other types of services can only be created via the web app.
     #         * Required
     #     
     #     - config (Hash)
-    #         * Configuration specific to the service `type`.
-    #             
-    #             **incoming_message_webhook**:
-    #             <table>
-    #             <tr><td> url </td> <td> The webhook URL that will be
-    #             triggered when an incoming message is received (string) </td></tr>
-    #             <tr><td> secret </td> <td> Optional string that will
-    #             be passed as the `secret` POST parameter to the webhook URL. (object) </td></tr>
-    #             </table>
-    #             <br />
-    #             
-    #             **incoming_message_script, contact_script,
-    #             message_script, data_row_script, webhook_script, voice_script, ussd_script,
-    #             project_script**:
-    #             <table>
-    #             <tr><td> code </td> <td> The JavaScript code to run
-    #             when the service is triggered (max 100 KB). To run code longer than 100 KB, use a
-    #             Cloud Script Module. (string) </td></tr>
-    #             </table>
-    #             <br />
-    #             
-    #             **custom_template_instance**:
-    #             <table>
-    #             <tr><td> template_service_id </td> <td> ID of the
-    #             service template (string). The service template must be available to the current
-    #             project or organization.</td></tr>
-    #             <tr><td> params </td> <td> Key/value pairs for all
-    #             service template parameters (object). If the values satisfy the validation rules
-    #             specified in the service template, they will also be copied to the `vars` property
-    #             of the service. Any values not associated with service template parameters will be
-    #             ignored.
-    #             </td></tr>
-    #             </table>
-    #             <br />
-    #             
-    #             **messaging_poll**:
-    #             <br />
-    #             The configuration parameters for poll services are
-    #             not yet documented, but can be determined by creating a poll via the web app and
-    #             then retrieving the configuration via [service.getConfig](#Service.getConfig).
-    #             <br />
+    #         * Configuration specific to the `service_type`. See [Service Configuration
+    #             Reference](#service_config) or the machine-readable [OpenAPI
+    #             specification](https://api.telerivet.com/openapi.json) for complete documentation of
+    #             configuration parameters for each service type.
     #         * Required
     #     
     #     - vars
@@ -2176,7 +3016,21 @@ class Project < Entity
     #     - message_types (array)
     #         * Types of messages that this service should handle. Only applies to services that
     #             handle incoming messages.
-    #         * Allowed values: text, call, sms, mms, ussd_session, chat
+    #         * Allowed values: text, call, ussd
+    #     
+    #     - table_ids (array)
+    #         * IDs of data tables that this service applies to, or null to apply to all data
+    #             tables. Only applies to data row services (`data_row_script` and
+    #             `data_row_actions`).
+    #     
+    #     - message_statuses (array of strings)
+    #         * Message statuses that this service should handle. Only applies to
+    #             `message_status_actions` services.
+    #         * Allowed values: sent, delivered, failed, failed_queued, not_delivered
+    #     
+    #     - tags (array of strings)
+    #         * Tags used to organize this service. Each tag can be up to 32 characters in length,
+    #             and up to 10 tags are allowed.
     #     
     #     - show_action (bool)
     #         * Whether to show this service in the Actions menu within the Telerivet web app when
@@ -2235,7 +3089,8 @@ class Project < Entity
     #     
     #     - context
     #         * Filter services that can be invoked in a particular context
-    #         * Allowed values: message, call, ussd_session, row, contact, project
+    #         * Allowed values: message, call, ussd_session, row, contact, project,
+    #             airtime_transaction
     #     
     #     - sort
     #         * Sort the results based on a field
@@ -2440,6 +3295,48 @@ class Project < Entity
         @api.cursor(Route, get_base_api_path() + "/routes", options)
     end
 
+    #
+    # Returns a list of all available routes for sending messages in a project, including both
+    # basic routes (phones) and custom routes.
+    # 
+    # Returns:
+    #     array
+    #
+    def get_route_list()
+        return @api.do_request("GET", get_base_api_path() + "/route_list")
+    end
+
+    #
+    # Creates a new custom route that can be used to send messages via one or more basic routes
+    # (phones).
+    # 
+    # The `actions` array defines the routing rules.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - name (string)
+    #         * Name of the custom route to create
+    #         * Required
+    #     
+    #     - actions (array of RoutingAction)
+    #         * Array of routing action objects. Allowed action types: `use_phone` (select basic
+    #             routes to send messages), `condition` (conditionally execute actions based on
+    #             criteria).
+    #         * Required
+    #     
+    #     - vars
+    #         * Custom variables and values to set for this route
+    #   
+    # Returns:
+    #     Telerivet::Route
+    #
+    def create_route(options)
+        require_relative 'route'
+        Route.new(@api, @api.do_request("POST", get_base_api_path() + "/routes", options))
+    end
+
     #
     # Gets a custom route by ID
     # 
@@ -2565,9 +3462,9 @@ class Project < Entity
 
     #
     # Gets a list of all custom fields defined for contacts in this project. The return value is
-    # an array of objects with the properties 'name', 'variable', 'type', 'order', 'readonly', and
-    # 'lookup_key'. (Fields are automatically created any time a Contact's 'vars' property is
-    # updated.)
+    # an array of objects with the properties 'name', 'variable', 'type', 'order', 'readonly',
+    # 'lookup_key', and 'show_on_conversation'. (Fields are automatically created any time a
+    # Contact's 'vars' property is updated.)
     # 
     # Returns:
     #     array
@@ -2603,9 +3500,9 @@ class Project < Entity
     #     
     #     - items (array)
     #         * Array of up to 100 objects containing `value` and `label` string properties to
-    #             show in the dropdown list when type is `select`. Each `value` and `label` must be
-    #             between 1 and 256 characters in length.
-    #         * Required if type is `select`
+    #             show when type is `select` or `radio`. Each `value` and `label` must be between 1
+    #             and 256 characters in length.
+    #         * Required if type is `select` or `radio`
     #     
     #     - readonly (bool)
     #         * Set to true to prevent editing the field in the Telerivet web app
@@ -2624,10 +3521,35 @@ class Project < Entity
         return @api.do_request("POST", get_base_api_path() + "/contact_fields/#{variable}", options)
     end
 
+    #
+    # Updates metadata for one or more custom contact fields. Only the specified fields are
+    # updated; other fields are not affected.
+    # 
+    # To delete a field, include an object with the `variable` and
+    # `delete` properties set (e.g. `{"variable": "my_field", "delete": true}`). Deleting a field
+    # will also clear the corresponding variable on all contacts in the project.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - metadata (array)
+    #         * Array of up to 100 objects describing the fields to create, update, or delete.
+    #             Each object must contain a `variable` property. Only the properties provided for
+    #             each field will be updated.
+    #         * Required
+    #   
+    # Returns:
+    #     array
+    #
+    def update_contact_fields(options)
+        return @api.do_request("POST", get_base_api_path() + "/contact_fields", options)
+    end
+
     #
     # Gets a list of all custom fields defined for messages in this project. The return value is
-    # an array of objects with the properties 'name', 'variable', 'type', 'order', 'readonly', and
-    # 'lookup_key'. (Fields are automatically created any time a Contact's 'vars' property is
+    # an array of objects with the properties 'name', 'variable', 'type', 'order', and
+    # 'hide_values'. (Fields are automatically created any time a Message's 'vars' property is
     # updated.)
     # 
     # Returns:
@@ -2664,9 +3586,9 @@ class Project < Entity
     #     
     #     - items (array)
     #         * Array of up to 100 objects containing `value` and `label` string properties to
-    #             show in the dropdown list when type is `select`. Each `value` and `label` must be
-    #             between 1 and 256 characters in length.
-    #         * Required if type is `select`
+    #             show when type is `select` or `radio`. Each `value` and `label` must be between 1
+    #             and 256 characters in length.
+    #         * Required if type is `select` or `radio`
     #     
     #     - hide_values (bool)
     #         * Set to true to avoid showing values of this field on the Messages page
@@ -2678,10 +3600,36 @@ class Project < Entity
         return @api.do_request("POST", get_base_api_path() + "/message_fields/#{variable}", options)
     end
 
+    #
+    # Updates metadata for one or more custom message fields. Only the specified fields are
+    # updated; other fields are not affected.
+    # 
+    # To delete a field, include an object with the `variable` and
+    # `delete` properties set (e.g. `{"variable": "my_field", "delete": true}`). Deleting a field
+    # removes the metadata only; values stored on individual messages are not affected.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - metadata (array)
+    #         * Array of up to 100 objects describing the fields to create, update, or delete.
+    #             Each object must contain a `variable` property. Only the properties provided for
+    #             each field will be updated.
+    #         * Required
+    #   
+    # Returns:
+    #     array
+    #
+    def update_message_fields(options)
+        return @api.do_request("POST", get_base_api_path() + "/message_fields", options)
+    end
+
     #
     # Retrieves statistics about messages sent or received via Telerivet. This endpoint returns
-    # historical data that is computed shortly after midnight each day in the project's time zone,
-    # and does not contain message statistics for the current day.
+    # historical data that is computed shortly after midnight each day in the project's time zone.
+    # If the date range includes the current day, it will include statistics for the current day
+    # so far.
     # 
     # Arguments:
     #   - options (Hash)
@@ -2708,16 +3656,14 @@ class Project < Entity
     #     
     #     - metrics (string)
     #         * Comma separated list of metrics to return (summed for each distinct value of the
-    #             requested properties)
-    #         * Allowed values: count, num_parts, duration, price
+    #             requested properties). Supported metrics are `count` (the number of messages),
+    #             `num_parts` (the number of SMS parts), `duration` (the total duration of calls, in
+    #             seconds), and `price.<currency>` (the total price of messages priced in the
+    #             specified ISO 4217 currency, e.g. `price.USD`). Amounts are not converted between
+    #             currencies: each `price.<currency>` metric only includes messages priced in the
+    #             specified currency.
     #         * Required
     #     
-    #     - currency (string)
-    #         * Three-letter ISO 4217 currency code used when returning the 'price' field. If the
-    #             original price was in a different currency, it will be converted to the requested
-    #             currency using the approximate current exchange rate.
-    #         * Default: USD
-    #     
     #     - filters (Hash)
     #         * Key-value pairs of properties and corresponding values; the returned statistics
     #             will only include messages where the property matches the provided value. Only the
@@ -2729,35 +3675,263 @@ class Project < Entity
     #       - intervals (array)
     #           * List of objects representing each date interval containing at least one message
     #               matching the filters.
-    #               Each object has the following properties:
-    #               
-    #               <table>
-    #               <tr><td> start_time </td> <td> The UNIX timestamp of the start
-    #               of the interval (int) </td></tr>
-    #               <tr><td> end_time </td> <td> The UNIX timestamp of the end of
-    #               the interval, exclusive (int) </td></tr>
-    #               <tr><td> start_date </td> <td> The date of the start of the
-    #               interval in YYYY-MM-DD format (string) </td></tr>
-    #               <tr><td> end_date </td> <td> The date of the end of the
-    #               interval in YYYY-MM-DD format, inclusive (string) </td></tr>
-    #               <tr><td> groups </td> <td> Array of groups for each
-    #               combination of requested property values matching the filters (array)
-    #               <br /><br />
-    #               Each object has the following properties:
-    #               <table>
-    #               <tr><td> properties </td> <td> An object of key/value
-    #               pairs for each distinct value of the requested properties (object) </td></tr>
-    #               <tr><td> metrics </td> <td> An object of key/value pairs
-    #               for each requested metric (object) </td></tr>
-    #               </table>
-    #               </td></tr>
-    #               </table>
     #
     def get_message_stats(options)
         data = @api.do_request("GET", get_base_api_path() + "/message_stats", options)
         return data
     end
 
+    #
+    # Retrieves statistics about the number of contacts in the project (total or in particular
+    # groups) over a date range. This endpoint returns historical data that is computed shortly
+    # after midnight each day in the project's time zone. If the date range includes the current
+    # day, it will include the current number of contacts.
+    # 
+    # To get historical statistics for the number of contacts matching a
+    # filter, use [project.createGroup](#Project.createGroup) to create a dynamic group for each
+    # filter you want to track. However, the statistics will only be available for dates after the
+    # dynamic group was created.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - start_date (string)
+    #         * Start date of contact statistics, in YYYY-MM-DD format
+    #         * Required
+    #     
+    #     - end_date (string)
+    #         * End date of contact statistics (inclusive), in YYYY-MM-DD format
+    #         * Required
+    #     
+    #     - rollup (string)
+    #         * Date interval to group by
+    #         * Allowed values: day, week, month, year
+    #         * Default: day
+    #     
+    #     - cumulative (bool)
+    #         * If true, each interval contains the total number of contacts at the end of the
+    #             interval; if false, each interval contains the change in the number of contacts
+    #             during the interval.
+    #         * Default: 1
+    #     
+    #     - series (string)
+    #         * Comma separated list of up to 10 data series to return, corresponding to the keys
+    #             of the `values` object in the response. Each item is either `total` (the total
+    #             number of contacts in the project) or a group ID (the number of contacts in that
+    #             group).
+    #         * Default: total
+    #   
+    # Returns:
+    #     (associative array)
+    #       - intervals (array)
+    #           * List of objects representing each date interval.
+    #
+    def get_contact_stats(options)
+        data = @api.do_request("GET", get_base_api_path() + "/contact_stats", options)
+        return data
+    end
+
+    #
+    # Retrieves statistics about the number of rows in particular data tables or data table views
+    # over a date range. This endpoint returns historical data that is computed shortly after
+    # midnight each day in the project's time zone. If the date range includes the current day, it
+    # will include the current number of rows.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - start_date (string)
+    #         * Start date of data table statistics, in YYYY-MM-DD format
+    #         * Required
+    #     
+    #     - end_date (string)
+    #         * End date of data table statistics (inclusive), in YYYY-MM-DD format
+    #         * Required
+    #     
+    #     - rollup (string)
+    #         * Date interval to group by
+    #         * Allowed values: day, week, month, year
+    #         * Default: day
+    #     
+    #     - cumulative (bool)
+    #         * If true, each interval contains the number of rows in each data table at the end
+    #             of the interval; if false, each interval contains the change in the number of rows
+    #             during the interval.
+    #         * Default: 1
+    #     
+    #     - series (string)
+    #         * Comma separated list of up to 10 data table IDs and/or data table view IDs,
+    #             corresponding to the keys of the `values` object in the response.
+    #         * Required
+    #   
+    # Returns:
+    #     (associative array)
+    #       - intervals (array)
+    #           * List of objects representing each date interval.
+    #
+    def get_data_table_stats(options)
+        data = @api.do_request("GET", get_base_api_path() + "/data_table_stats", options)
+        return data
+    end
+
+    #
+    # Retrieves statistics about airtime transactions sent via Telerivet. This endpoint returns
+    # historical data for successful transactions that is computed shortly after midnight each day
+    # in the project's time zone. If the date range includes the current day, it will include
+    # statistics for the current day so far.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - start_date (string)
+    #         * Start date of airtime statistics, in YYYY-MM-DD format
+    #         * Required
+    #     
+    #     - end_date (string)
+    #         * End date of airtime statistics (inclusive), in YYYY-MM-DD format
+    #         * Required
+    #     
+    #     - rollup (string)
+    #         * Date interval to group by
+    #         * Allowed values: day, week, month, year, all
+    #         * Default: day
+    #     
+    #     - properties (string)
+    #         * Comma separated list of properties to group by. The `provider_category` property
+    #             combines the provider type and category ID (e.g. `main.airtime.dtone/1`); also group
+    #             by `category_name` to return the category's display name.
+    #         * Allowed values: country, operator_name, product_id, provider_id,
+    #             provider_category, category_name
+    #     
+    #     - metrics (string)
+    #         * Comma separated list of metrics to return (summed for each distinct value of the
+    #             requested properties). Supported metrics are `count` (the number of successful
+    #             transactions), `value.<currency>` (the face value of the airtime received by the
+    #             recipients, e.g. `value.KES`), and `price.<currency>` (the amount charged for the
+    #             transactions, e.g. `price.USD`). Amounts are not converted between currencies: each
+    #             `value`/`price` metric only includes transactions denominated in the specified ISO
+    #             4217 currency, and transactions without a numeric currency value (such as bundles)
+    #             are not included in any `value` metric.
+    #         * Required
+    #     
+    #     - filters (Hash)
+    #         * Key-value pairs of properties and corresponding values; the returned statistics
+    #             will only include successful airtime transactions where the property matches the
+    #             provided value. Only the following properties are supported for filters: `country`,
+    #             `operator_name`, `product_id`, `provider_id`, `provider_category`
+    #   
+    # Returns:
+    #     (associative array)
+    #       - intervals (array)
+    #           * List of objects representing each date interval containing at least one
+    #               successful airtime transaction matching the filters.
+    #
+    def get_airtime_stats(options)
+        data = @api.do_request("GET", get_base_api_path() + "/airtime_stats", options)
+        return data
+    end
+
+    #
+    # Queries webhooks within the given project.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #     
+    #     - sort
+    #         * Sort the results based on a field
+    #         * Allowed values: default
+    #         * Default: default
+    #     
+    #     - sort_dir
+    #         * Sort the results in ascending or descending order
+    #         * Allowed values: asc, desc
+    #         * Default: asc
+    #     
+    #     - page_size (int)
+    #         * Number of results returned per page (max 500)
+    #         * Default: 50
+    #     
+    #     - offset (int)
+    #         * Number of items to skip from beginning of result set
+    #         * Default: 0
+    #   
+    # Returns:
+    #     Telerivet::APICursor (of Telerivet::Webhook)
+    #
+    def query_webhooks(options = nil)
+        require_relative 'webhook'
+        @api.cursor(Webhook, get_base_api_path() + "/webhooks", options)
+    end
+
+    #
+    # Creates a new webhook that will be triggered when specific events occur within the project.
+    # 
+    # Note: The Webhook object is not used for notifying your server when
+    # incoming messages are received. To notify a URL when incoming messages are received, you can
+    # configure a webhook by [creating a Service](#Project.createService) with type
+    # incoming_message_webhook.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - url
+    #         * URL to send webhook requests to. Must start with https:// or http://.
+    #         * Required
+    #     
+    #     - secret
+    #         * Secret to include when sending webhook requests (up to 200 characters). Telerivet
+    #             will send the secret in the password field of HTTP basic auth (with username
+    #             'telerivet').
+    #     
+    #     - events (array of strings)
+    #         * Array of event types to trigger this webhook. Valid event types are: `send_status`
+    #             (message status updates), `send_broadcast` (broadcast sent), `contact_update`
+    #             (contact added/updated/deleted), `message_metadata` (message metadata updated).
+    #   
+    # Returns:
+    #     Telerivet::Webhook
+    #
+    def create_webhook(options)
+        require_relative 'webhook'
+        Webhook.new(@api, @api.do_request("POST", get_base_api_path() + "/webhooks", options))
+    end
+
+    #
+    # Retrieves the webhook with the given ID.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the webhook
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::Webhook
+    #
+    def get_webhook_by_id(id)
+        require_relative 'webhook'
+        Webhook.new(@api, @api.do_request("GET", get_base_api_path() + "/webhooks/#{id}"))
+    end
+
+    #
+    # Initializes the webhook with the given ID without making an API request.
+    # 
+    # Arguments:
+    #   - id
+    #       * ID of the webhook
+    #       * Required
+    #   
+    # Returns:
+    #     Telerivet::Webhook
+    #
+    def init_webhook_by_id(id)
+        require_relative 'webhook'
+        return Webhook.new(@api, {'project_id' => self.id, 'id' => id}, false)
+    end
+
     #
     # Saves any fields or custom variables that have changed for the project.
     #
@@ -2809,10 +3983,30 @@ class Project < Entity
         set('auto_create_contacts', value)
     end
 
+    def message_retention_days
+        get('message_retention_days')
+    end
+
+    def message_retention_days=(value)
+        set('message_retention_days', value)
+    end
+
+    def short_link_scheme
+        get('short_link_scheme')
+    end
+
+    def short_link_scheme=(value)
+        set('short_link_scheme', value)
+    end
+
     def organization_id
         get('organization_id')
     end
 
+    def url
+        get('url')
+    end
+
     def get_base_api_path()
         "/projects/#{get('id')}"
     end