[Librarian] Regenerated @ 38fb28edc02f73b8635b45a5612c5ae33eab39fe

Author: twilio-dx

CHANGES.md

@@ -1,6 +1,23 @@
 twilio-php Changelog
 ====================
 
+[2023-08-24] Version 7.9.0
+--------------------------
+**Api**
+- Add new property `RiskCheck` for SMS pumping protection feature only (public beta to be available soon): Include this parameter with a value of `disable` to skip any kind of risk check on the respective message request
+
+**Flex**
+- Changing `sid<UO>` path param to `sid<UT>` in interaction channel participant update endpoint **(breaking change)**
+
+**Messaging**
+- Add Channel Sender api
+- Fixing country code docs and removing Zipwhip references
+
+**Numbers**
+- Request status changed in numbers/v2/BulkHostedNumberOrders **(breaking change)**
+- Add bulk hosting orders API under version `/v2
+
+
 [2023-08-10] Version 7.8.0
 --------------------------
 **Insights**

src/Twilio/Rest/Api/V2010/Account/MessageList.php

@@ -53,7 +53,7 @@ public function __construct(
     /**
      * Create the MessageInstance
      *
-     * @param string $to The recipient's phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format (for SMS/MMS) or [channel address](https://www.twilio.com/docs/sms/channels#channel-addresses), e.g. `whatsapp:+15552229999`.
+     * @param string $to The recipient's phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format (for SMS/MMS) or [channel address](https://www.twilio.com/docs/messaging/channels), e.g. `whatsapp:+15552229999`.
      * @param array|Options $options Optional Arguments
      * @return MessageInstance Created MessageInstance
      * @throws TwilioException When an HTTP error occurs.
@@ -98,6 +98,8 @@ public function create(string $to, array $options = []): MessageInstance
                 Serialize::booleanToString($options['sendAsMms']),
             'ContentVariables' =>
                 $options['contentVariables'],
+            'RiskCheck' =>
+                $options['riskCheck'],
             'From' =>
                 $options['from'],
             'MessagingServiceSid' =>

src/Twilio/Rest/Api/V2010/Account/MessageOptions.php

@@ -47,8 +47,8 @@ public function __construct(
     /**
      * Create the MediaProcessorInstance
      *
-     * @param string $extension The [Media Extension](/docs/live/api/media-extensions-overview) name or URL. Ex: `video-composer-v2`
-     * @param string $extensionContext The context of the Media Extension, represented as a JSON dictionary. See the documentation for the specific [Media Extension](/docs/live/api/media-extensions-overview) you are using for more information about the context to send.
+     * @param string $extension The [Media Extension](/docs/live/media-extensions-overview) name or URL. Ex: `video-composer-v2`
+     * @param string $extensionContext The context of the Media Extension, represented as a JSON dictionary. See the documentation for the specific [Media Extension](/docs/live/media-extensions-overview) you are using for more information about the context to send.
      * @param array|Options $options Optional Arguments
      * @return MediaProcessorInstance Created MediaProcessorInstance
      * @throws TwilioException When an HTTP error occurs.

src/Twilio/Rest/Conversations/V1/Service/Conversation/ParticipantOptions.php

@@ -21,8 +21,8 @@
 abstract class MediaProcessorOptions
 {
     /**
-     * @param array $extensionEnvironment User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/api/media-extensions-overview) you are using for more information about whether you need to provide this.
-     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/status-callbacks) for details.
+     * @param array $extensionEnvironment User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/media-extensions-overview) you are using for more information about whether you need to provide this.
+     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/api/status-callbacks) for details.
      * @param string $statusCallbackMethod The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`.
      * @param int $maxDuration The maximum time, in seconds, that the MediaProcessor can run before automatically ends. The default value is 300 seconds, and the maximum value is 90000 seconds. Once this maximum duration is reached, Twilio will end the MediaProcessor, regardless of whether media is still streaming.
      * @return CreateMediaProcessorOptions Options builder
@@ -69,8 +69,8 @@ public static function read(
 class CreateMediaProcessorOptions extends Options
     {
     /**
-     * @param array $extensionEnvironment User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/api/media-extensions-overview) you are using for more information about whether you need to provide this.
-     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/status-callbacks) for details.
+     * @param array $extensionEnvironment User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/media-extensions-overview) you are using for more information about whether you need to provide this.
+     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/api/status-callbacks) for details.
      * @param string $statusCallbackMethod The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`.
      * @param int $maxDuration The maximum time, in seconds, that the MediaProcessor can run before automatically ends. The default value is 300 seconds, and the maximum value is 90000 seconds. Once this maximum duration is reached, Twilio will end the MediaProcessor, regardless of whether media is still streaming.
      */
@@ -89,9 +89,9 @@ public function __construct(
     }
 
     /**
-     * User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/api/media-extensions-overview) you are using for more information about whether you need to provide this.
+     * User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/media-extensions-overview) you are using for more information about whether you need to provide this.
      *
-     * @param array $extensionEnvironment User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/api/media-extensions-overview) you are using for more information about whether you need to provide this.
+     * @param array $extensionEnvironment User-defined environment variables for the Media Extension, represented as a JSON dictionary of key/value strings. See the documentation for the specific [Media Extension](/docs/live/media-extensions-overview) you are using for more information about whether you need to provide this.
      * @return $this Fluent Builder
      */
     public function setExtensionEnvironment(array $extensionEnvironment): self
@@ -101,9 +101,9 @@ public function setExtensionEnvironment(array $extensionEnvironment): self
     }
 
     /**
-     * The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/status-callbacks) for details.
+     * The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/api/status-callbacks) for details.
      *
-     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/status-callbacks) for details.
+     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/api/status-callbacks) for details.
      * @return $this Fluent Builder
      */
     public function setStatusCallback(string $statusCallback): self

src/Twilio/Rest/Media/V1/MediaProcessorList.php

@@ -22,7 +22,7 @@ abstract class PlayerStreamerOptions
 {
     /**
      * @param bool $video Specifies whether the PlayerStreamer is configured to stream video. Defaults to `true`.
-     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/status-callbacks) for more details.
+     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/api/status-callbacks) for more details.
      * @param string $statusCallbackMethod The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`.
      * @param int $maxDuration The maximum time, in seconds, that the PlayerStreamer is active (`created` or `started`) before automatically ends. The default value is 300 seconds, and the maximum value is 90000 seconds. Once this maximum duration is reached, Twilio will end the PlayerStreamer, regardless of whether media is still streaming.
      * @return CreatePlayerStreamerOptions Options builder
@@ -70,7 +70,7 @@ class CreatePlayerStreamerOptions extends Options
     {
     /**
      * @param bool $video Specifies whether the PlayerStreamer is configured to stream video. Defaults to `true`.
-     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/status-callbacks) for more details.
+     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/api/status-callbacks) for more details.
      * @param string $statusCallbackMethod The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`.
      * @param int $maxDuration The maximum time, in seconds, that the PlayerStreamer is active (`created` or `started`) before automatically ends. The default value is 300 seconds, and the maximum value is 90000 seconds. Once this maximum duration is reached, Twilio will end the PlayerStreamer, regardless of whether media is still streaming.
      */
@@ -101,9 +101,9 @@ public function setVideo(bool $video): self
     }
 
     /**
-     * The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/status-callbacks) for more details.
+     * The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/api/status-callbacks) for more details.
      *
-     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/status-callbacks) for more details.
+     * @param string $statusCallback The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/api/status-callbacks) for more details.
      * @return $this Fluent Builder
      */
     public function setStatusCallback(string $statusCallback): self

src/Twilio/Rest/Media/V1/MediaProcessorOptions.php

@@ -0,0 +1,87 @@
+<?php
+
+/**
+ * This code was generated by
+ * ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+ *  |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+ *  |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+ *
+ * Twilio - Messaging
+ * This is the public Twilio REST API.
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator.
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+namespace Twilio\Rest\Messaging\V1\Service;
+
+use Twilio\Exceptions\TwilioException;
+use Twilio\Version;
+use Twilio\InstanceContext;
+
+
+class ChannelSenderContext extends InstanceContext
+    {
+    /**
+     * Initialize the ChannelSenderContext
+     *
+     * @param Version $version Version that contains the resource
+     * @param string $messagingServiceSid The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the resource from.
+     * @param string $sid The SID of the ChannelSender resource to fetch.
+     */
+    public function __construct(
+        Version $version,
+        $messagingServiceSid,
+        $sid
+    ) {
+        parent::__construct($version);
+
+        // Path Solution
+        $this->solution = [
+        'messagingServiceSid' =>
+            $messagingServiceSid,
+        'sid' =>
+            $sid,
+        ];
+
+        $this->uri = '/Services/' . \rawurlencode($messagingServiceSid)
+        .'/ChannelSenders/' . \rawurlencode($sid)
+        .'';
+    }
+
+    /**
+     * Fetch the ChannelSenderInstance
+     *
+     * @return ChannelSenderInstance Fetched ChannelSenderInstance
+     * @throws TwilioException When an HTTP error occurs.
+     */
+    public function fetch(): ChannelSenderInstance
+    {
+
+        $payload = $this->version->fetch('GET', $this->uri);
+
+        return new ChannelSenderInstance(
+            $this->version,
+            $payload,
+            $this->solution['messagingServiceSid'],
+            $this->solution['sid']
+        );
+    }
+
+
+    /**
+     * Provide a friendly representation
+     *
+     * @return string Machine friendly representation
+     */
+    public function __toString(): string
+    {
+        $context = [];
+        foreach ($this->solution as $key => $value) {
+            $context[] = "$key=$value";
+        }
+        return '[Twilio.Messaging.V1.ChannelSenderContext ' . \implode(' ', $context) . ']';
+    }
+}

src/Twilio/Rest/Media/V1/PlayerStreamerOptions.php

@@ -0,0 +1,134 @@
+<?php
+
+/**
+ * This code was generated by
+ * ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+ *  |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+ *  |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+ *
+ * Twilio - Messaging
+ * This is the public Twilio REST API.
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator.
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+namespace Twilio\Rest\Messaging\V1\Service;
+
+use Twilio\Exceptions\TwilioException;
+use Twilio\InstanceResource;
+use Twilio\Values;
+use Twilio\Version;
+use Twilio\Deserialize;
+
+
+/**
+ * @property string|null $accountSid
+ * @property string|null $messagingServiceSid
+ * @property string|null $sid
+ * @property string|null $sender
+ * @property string|null $senderType
+ * @property string|null $countryCode
+ * @property \DateTime|null $dateCreated
+ * @property \DateTime|null $dateUpdated
+ * @property string|null $url
+ */
+class ChannelSenderInstance extends InstanceResource
+{
+    /**
+     * Initialize the ChannelSenderInstance
+     *
+     * @param Version $version Version that contains the resource
+     * @param mixed[] $payload The response payload
+     * @param string $messagingServiceSid The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) to fetch the resource from.
+     * @param string $sid The SID of the ChannelSender resource to fetch.
+     */
+    public function __construct(Version $version, array $payload, string $messagingServiceSid, string $sid = null)
+    {
+        parent::__construct($version);
+
+        // Marshaled Properties
+        $this->properties = [
+            'accountSid' => Values::array_get($payload, 'account_sid'),
+            'messagingServiceSid' => Values::array_get($payload, 'messaging_service_sid'),
+            'sid' => Values::array_get($payload, 'sid'),
+            'sender' => Values::array_get($payload, 'sender'),
+            'senderType' => Values::array_get($payload, 'sender_type'),
+            'countryCode' => Values::array_get($payload, 'country_code'),
+            'dateCreated' => Deserialize::dateTime(Values::array_get($payload, 'date_created')),
+            'dateUpdated' => Deserialize::dateTime(Values::array_get($payload, 'date_updated')),
+            'url' => Values::array_get($payload, 'url'),
+        ];
+
+        $this->solution = ['messagingServiceSid' => $messagingServiceSid, 'sid' => $sid ?: $this->properties['sid'], ];
+    }
+
+    /**
+     * Generate an instance context for the instance, the context is capable of
+     * performing various actions.  All instance actions are proxied to the context
+     *
+     * @return ChannelSenderContext Context for this ChannelSenderInstance
+     */
+    protected function proxy(): ChannelSenderContext
+    {
+        if (!$this->context) {
+            $this->context = new ChannelSenderContext(
+                $this->version,
+                $this->solution['messagingServiceSid'],
+                $this->solution['sid']
+            );
+        }
+
+        return $this->context;
+    }
+
+    /**
+     * Fetch the ChannelSenderInstance
+     *
+     * @return ChannelSenderInstance Fetched ChannelSenderInstance
+     * @throws TwilioException When an HTTP error occurs.
+     */
+    public function fetch(): ChannelSenderInstance
+    {
+
+        return $this->proxy()->fetch();
+    }
+
+    /**
+     * Magic getter to access properties
+     *
+     * @param string $name Property to access
+     * @return mixed The requested property
+     * @throws TwilioException For unknown properties
+     */
+    public function __get(string $name)
+    {
+        if (\array_key_exists($name, $this->properties)) {
+            return $this->properties[$name];
+        }
+
+        if (\property_exists($this, '_' . $name)) {
+            $method = 'get' . \ucfirst($name);
+            return $this->$method();
+        }
+
+        throw new TwilioException('Unknown property: ' . $name);
+    }
+
+    /**
+     * Provide a friendly representation
+     *
+     * @return string Machine friendly representation
+     */
+    public function __toString(): string
+    {
+        $context = [];
+        foreach ($this->solution as $key => $value) {
+            $context[] = "$key=$value";
+        }
+        return '[Twilio.Messaging.V1.ChannelSenderInstance ' . \implode(' ', $context) . ']';
+    }
+}
+