[Librarian] Regenerated @ 45fa5159053e1c1f62f6d613f3b67a9239b43a5f 2551818144b7f525e66740ded45831b930db82b8

Author: twilio-dx

CHANGES.md

@@ -1,6 +1,22 @@
 twilio-php Changelog
 ====================
 
+[2024-12-05] Version 8.3.9
+--------------------------
+**Api**
+- Add optional parameter `intelligence_service` to `transcription`
+- Updated `phone_number_sid` to be populated for sip trunking terminating calls.
+
+**Numbers**
+- Add Update Hosted Number Order V2 API endpoint
+- Update Port in docs
+
+**Twiml**
+- Add optional parameter `intelligence_service` to `<Transcription>`
+- Add support for new `<ConversationRelay>` and `<Assistant>` noun
+- Add `events` attribute to `<Dial>` verb
+
+
 [2024-11-15] Version 8.3.8
 --------------------------
 **Library - Chore**

src/Twilio/Rest/Api/V2010/Account/Call/TranscriptionList.php

@@ -94,6 +94,8 @@ public function create(array $options = []): TranscriptionInstance
                 $options['hints'],
             'EnableAutomaticPunctuation' =>
                 Serialize::booleanToString($options['enableAutomaticPunctuation']),
+            'IntelligenceService' =>
+                $options['intelligenceService'],
         ]);
 
         $headers = Values::of(['Content-Type' => 'application/x-www-form-urlencoded' ]);

src/Twilio/Rest/Api/V2010/Account/Call/TranscriptionOptions.php

@@ -34,6 +34,7 @@ abstract class TranscriptionOptions
      * @param string $speechModel Recognition model used by the transcription engine, among those supported by the provider
      * @param string $hints A Phrase contains words and phrase \\\"hints\\\" so that the speech recognition engine is more likely to recognize them.
      * @param bool $enableAutomaticPunctuation The provider will add punctuation to recognition result
+     * @param string $intelligenceService The SID or the unique name of the [IntelligentService](https://www.twilio.com/docs/voice/intelligence/api/service-resource) to process the transcription.
      * @return CreateTranscriptionOptions Options builder
      */
     public static function create(
@@ -50,7 +51,8 @@ public static function create(
         bool $profanityFilter = Values::BOOL_NONE,
         string $speechModel = Values::NONE,
         string $hints = Values::NONE,
-        bool $enableAutomaticPunctuation = Values::BOOL_NONE
+        bool $enableAutomaticPunctuation = Values::BOOL_NONE,
+        string $intelligenceService = Values::NONE
 
     ): CreateTranscriptionOptions
     {
@@ -67,7 +69,8 @@ public static function create(
             $profanityFilter,
             $speechModel,
             $hints,
-            $enableAutomaticPunctuation
+            $enableAutomaticPunctuation,
+            $intelligenceService
         );
     }
 
@@ -90,6 +93,7 @@ class CreateTranscriptionOptions extends Options
      * @param string $speechModel Recognition model used by the transcription engine, among those supported by the provider
      * @param string $hints A Phrase contains words and phrase \\\"hints\\\" so that the speech recognition engine is more likely to recognize them.
      * @param bool $enableAutomaticPunctuation The provider will add punctuation to recognition result
+     * @param string $intelligenceService The SID or the unique name of the [IntelligentService](https://www.twilio.com/docs/voice/intelligence/api/service-resource) to process the transcription.
      */
     public function __construct(
 
@@ -105,7 +109,8 @@ public function __construct(
         bool $profanityFilter = Values::BOOL_NONE,
         string $speechModel = Values::NONE,
         string $hints = Values::NONE,
-        bool $enableAutomaticPunctuation = Values::BOOL_NONE
+        bool $enableAutomaticPunctuation = Values::BOOL_NONE,
+        string $intelligenceService = Values::NONE
 
     ) {
         $this->options['name'] = $name;
@@ -121,6 +126,7 @@ public function __construct(
         $this->options['speechModel'] = $speechModel;
         $this->options['hints'] = $hints;
         $this->options['enableAutomaticPunctuation'] = $enableAutomaticPunctuation;
+        $this->options['intelligenceService'] = $intelligenceService;
     }
 
     /**
@@ -277,6 +283,18 @@ public function setEnableAutomaticPunctuation(bool $enableAutomaticPunctuation):
         return $this;
     }
 
+    /**
+     * The SID or the unique name of the [IntelligentService](https://www.twilio.com/docs/voice/intelligence/api/service-resource) to process the transcription.
+     *
+     * @param string $intelligenceService The SID or the unique name of the [IntelligentService](https://www.twilio.com/docs/voice/intelligence/api/service-resource) to process the transcription.
+     * @return $this Fluent Builder
+     */
+    public function setIntelligenceService(string $intelligenceService): self
+    {
+        $this->options['intelligenceService'] = $intelligenceService;
+        return $this;
+    }
+
     /**
      * Provide a friendly representation
      *

src/Twilio/Rest/Numbers/V1.php

@@ -25,8 +25,8 @@
 use Twilio\Rest\Numbers\V1\PortingPortabilityList;
 use Twilio\Rest\Numbers\V1\PortingWebhookConfigurationList;
 use Twilio\Rest\Numbers\V1\PortingWebhookConfigurationDeleteList;
+use Twilio\Rest\Numbers\V1\PortingWebhookConfigurationFetchList;
 use Twilio\Rest\Numbers\V1\SigningRequestConfigurationList;
-use Twilio\Rest\Numbers\V1\WebhookList;
 use Twilio\Version;
 
 /**
@@ -37,8 +37,8 @@
  * @property PortingPortabilityList $portingPortabilities
  * @property PortingWebhookConfigurationList $portingWebhookConfigurations
  * @property PortingWebhookConfigurationDeleteList $portingWebhookConfigurationsDelete
+ * @property PortingWebhookConfigurationFetchList $portingWebhookConfigurationFetch
  * @property SigningRequestConfigurationList $signingRequestConfigurations
- * @property WebhookList $webhook
  * @method \Twilio\Rest\Numbers\V1\BulkEligibilityContext bulkEligibilities(string $requestId)
  * @method \Twilio\Rest\Numbers\V1\PortingPortInContext portingPortIns(string $portInRequestSid)
  * @method \Twilio\Rest\Numbers\V1\PortingPortInPhoneNumberContext portingPortInPhoneNumber(string $portInRequestSid, string $phoneNumberSid)
@@ -54,8 +54,8 @@ class V1 extends Version
     protected $_portingPortabilities;
     protected $_portingWebhookConfigurations;
     protected $_portingWebhookConfigurationsDelete;
+    protected $_portingWebhookConfigurationFetch;
     protected $_signingRequestConfigurations;
-    protected $_webhook;
 
     /**
      * Construct the V1 version of Numbers
@@ -124,20 +124,20 @@ protected function getPortingWebhookConfigurationsDelete(): PortingWebhookConfig
         return $this->_portingWebhookConfigurationsDelete;
     }
 
-    protected function getSigningRequestConfigurations(): SigningRequestConfigurationList
+    protected function getPortingWebhookConfigurationFetch(): PortingWebhookConfigurationFetchList
     {
-        if (!$this->_signingRequestConfigurations) {
-            $this->_signingRequestConfigurations = new SigningRequestConfigurationList($this);
+        if (!$this->_portingWebhookConfigurationFetch) {
+            $this->_portingWebhookConfigurationFetch = new PortingWebhookConfigurationFetchList($this);
         }
-        return $this->_signingRequestConfigurations;
+        return $this->_portingWebhookConfigurationFetch;
     }
 
-    protected function getWebhook(): WebhookList
+    protected function getSigningRequestConfigurations(): SigningRequestConfigurationList
     {
-        if (!$this->_webhook) {
-            $this->_webhook = new WebhookList($this);
+        if (!$this->_signingRequestConfigurations) {
+            $this->_signingRequestConfigurations = new SigningRequestConfigurationList($this);
         }
-        return $this->_webhook;
+        return $this->_signingRequestConfigurations;
     }
 
     /**

src/Twilio/Rest/Numbers/V1/WebhookInstance.php renamed to src/Twilio/Rest/Numbers/V1/PortingWebhookConfigurationFetchInstance.php

@@ -32,10 +32,10 @@
  * @property \DateTime|null $portInTargetDateCreated
  * @property \DateTime|null $portOutTargetDateCreated
  */
-class WebhookInstance extends InstanceResource
+class PortingWebhookConfigurationFetchInstance extends InstanceResource
 {
     /**
-     * Initialize the WebhookInstance
+     * Initialize the PortingWebhookConfigurationFetchInstance
      *
      * @param Version $version Version that contains the resource
      * @param mixed[] $payload The response payload
@@ -85,7 +85,7 @@ public function __get(string $name)
      */
     public function __toString(): string
     {
-        return '[Twilio.Numbers.V1.WebhookInstance]';
+        return '[Twilio.Numbers.V1.PortingWebhookConfigurationFetchInstance]';
     }
 }
 

src/Twilio/Rest/Numbers/V1/WebhookList.php renamed to src/Twilio/Rest/Numbers/V1/PortingWebhookConfigurationFetchList.php

@@ -22,10 +22,10 @@
 use Twilio\Version;
 
 
-class WebhookList extends ListResource
+class PortingWebhookConfigurationFetchList extends ListResource
     {
     /**
-     * Construct the WebhookList
+     * Construct the PortingWebhookConfigurationFetchList
      *
      * @param Version $version Version that contains the resource
      */
@@ -42,18 +42,18 @@ public function __construct(
     }
 
     /**
-     * Fetch the WebhookInstance
+     * Fetch the PortingWebhookConfigurationFetchInstance
      *
-     * @return WebhookInstance Fetched WebhookInstance
+     * @return PortingWebhookConfigurationFetchInstance Fetched PortingWebhookConfigurationFetchInstance
      * @throws TwilioException When an HTTP error occurs.
      */
-    public function fetch(): WebhookInstance
+    public function fetch(): PortingWebhookConfigurationFetchInstance
     {
 
         $headers = Values::of(['Content-Type' => 'application/x-www-form-urlencoded' ]);
         $payload = $this->version->fetch('GET', $this->uri, [], [], $headers);
 
-        return new WebhookInstance(
+        return new PortingWebhookConfigurationFetchInstance(
             $this->version,
             $payload
         );
@@ -67,6 +67,6 @@ public function fetch(): WebhookInstance
      */
     public function __toString(): string
     {
-        return '[Twilio.Numbers.V1.WebhookList]';
+        return '[Twilio.Numbers.V1.PortingWebhookConfigurationFetchList]';
     }
 }

src/Twilio/Rest/Numbers/V1/WebhookPage.php renamed to src/Twilio/Rest/Numbers/V1/PortingWebhookConfigurationFetchPage.php

@@ -19,7 +19,7 @@
 use Twilio\Page;
 use Twilio\Version;
 
-class WebhookPage extends Page
+class PortingWebhookConfigurationFetchPage extends Page
     {
     /**
      * @param Version $version Version that contains the resource
@@ -36,11 +36,11 @@ public function __construct(Version $version, Response $response, array $solutio
 
     /**
      * @param array $payload Payload response from the API
-     * @return WebhookInstance \Twilio\Rest\Numbers\V1\WebhookInstance
+     * @return PortingWebhookConfigurationFetchInstance \Twilio\Rest\Numbers\V1\PortingWebhookConfigurationFetchInstance
      */
-    public function buildInstance(array $payload): WebhookInstance
+    public function buildInstance(array $payload): PortingWebhookConfigurationFetchInstance
     {
-        return new WebhookInstance($this->version, $payload);
+        return new PortingWebhookConfigurationFetchInstance($this->version, $payload);
     }
 
     /**
@@ -50,6 +50,6 @@ public function buildInstance(array $payload): WebhookInstance
      */
     public function __toString(): string
     {
-        return '[Twilio.Numbers.V1.WebhookPage]';
+        return '[Twilio.Numbers.V1.PortingWebhookConfigurationFetchPage]';
     }
 }

src/Twilio/Rest/Numbers/V2/HostedNumberOrderContext.php

@@ -18,6 +18,7 @@
 namespace Twilio\Rest\Numbers\V2;
 
 use Twilio\Exceptions\TwilioException;
+use Twilio\Options;
 use Twilio\Values;
 use Twilio\Version;
 use Twilio\InstanceContext;
@@ -81,6 +82,39 @@ public function fetch(): HostedNumberOrderInstance
     }
 
 
+    /**
+     * Update the HostedNumberOrderInstance
+     *
+     * @param string $status
+     * @param array|Options $options Optional Arguments
+     * @return HostedNumberOrderInstance Updated HostedNumberOrderInstance
+     * @throws TwilioException When an HTTP error occurs.
+     */
+    public function update(string $status, array $options = []): HostedNumberOrderInstance
+    {
+
+        $options = new Values($options);
+
+        $data = Values::of([
+            'Status' =>
+                $status,
+            'VerificationCallDelay' =>
+                $options['verificationCallDelay'],
+            'VerificationCallExtension' =>
+                $options['verificationCallExtension'],
+        ]);
+
+        $headers = Values::of(['Content-Type' => 'application/x-www-form-urlencoded' ]);
+        $payload = $this->version->update('POST', $this->uri, [], $data, $headers);
+
+        return new HostedNumberOrderInstance(
+            $this->version,
+            $payload,
+            $this->solution['sid']
+        );
+    }
+
+
     /**
      * Provide a friendly representation
      *

src/Twilio/Rest/Numbers/V2/HostedNumberOrderInstance.php

@@ -19,6 +19,7 @@
 
 use Twilio\Exceptions\TwilioException;
 use Twilio\InstanceResource;
+use Twilio\Options;
 use Twilio\Values;
 use Twilio\Version;
 use Twilio\Deserialize;
@@ -45,6 +46,12 @@
  * @property string|null $contactPhoneNumber
  * @property string|null $bulkHostingRequestSid
  * @property string|null $nextStep
+ * @property int $verificationAttempts
+ * @property string[]|null $verificationCallSids
+ * @property int $verificationCallDelay
+ * @property string|null $verificationCallExtension
+ * @property string|null $verificationCode
+ * @property string $verificationType
  */
 class HostedNumberOrderInstance extends InstanceResource
 {
@@ -80,6 +87,12 @@ public function __construct(Version $version, array $payload, string $sid = null
             'contactPhoneNumber' => Values::array_get($payload, 'contact_phone_number'),
             'bulkHostingRequestSid' => Values::array_get($payload, 'bulk_hosting_request_sid'),
             'nextStep' => Values::array_get($payload, 'next_step'),
+            'verificationAttempts' => Values::array_get($payload, 'verification_attempts'),
+            'verificationCallSids' => Values::array_get($payload, 'verification_call_sids'),
+            'verificationCallDelay' => Values::array_get($payload, 'verification_call_delay'),
+            'verificationCallExtension' => Values::array_get($payload, 'verification_call_extension'),
+            'verificationCode' => Values::array_get($payload, 'verification_code'),
+            'verificationType' => Values::array_get($payload, 'verification_type'),
         ];
 
         $this->solution = ['sid' => $sid ?: $this->properties['sid'], ];
@@ -127,6 +140,20 @@ public function fetch(): HostedNumberOrderInstance
         return $this->proxy()->fetch();
     }
 
+    /**
+     * Update the HostedNumberOrderInstance
+     *
+     * @param string $status
+     * @param array|Options $options Optional Arguments
+     * @return HostedNumberOrderInstance Updated HostedNumberOrderInstance
+     * @throws TwilioException When an HTTP error occurs.
+     */
+    public function update(string $status, array $options = []): HostedNumberOrderInstance
+    {
+
+        return $this->proxy()->update($status, $options);
+    }
+
     /**
      * Magic getter to access properties
      *