Support URL or TWIML for CallMessage requests

Author: TechWilk

src/Exceptions/InvalidConfigException.php

@@ -10,4 +10,9 @@ public static function missingConfig(): self
     {
         return new self('Missing config. You must set either the username & password or SID and auth token');
     }
+
+    public static function multipleContentTypes(): self
+    {
+        return new self('Unable to use URL and TWIML call types simultaneously. You can use only one type');
+    }
 }

src/Twilio.php

@@ -116,7 +116,7 @@ protected function sendSmsMessage(TwilioSmsMessage $message, ?string $to): Messa
     protected function makeCall(TwilioCallMessage $message, ?string $to): CallInstance
     {
         $params = [
-            'url' => trim($message->content),
+            $message->contentType => trim($message->content),
         ];
 
         $this->fillOptionalParams($params, $message, [

src/TwilioCallMessage.php

@@ -2,11 +2,22 @@
 
 namespace NotificationChannels\Twilio;
 
+use NotificationChannels\Twilio\Exceptions\InvalidConfigException;
+use Twilio\TwiML\VoiceResponse;
+
 class TwilioCallMessage extends TwilioMessage
 {
     public const STATUS_CANCELED = 'canceled';
     public const STATUS_COMPLETED = 'completed';
 
+    public const TYPE_URL = 'url';
+    public const TYPE_TWIML = 'twiml';
+
+    /**
+     * @var int
+     */
+    public $contentType = null;
+
     /**
      * @var null|string
      */
@@ -35,11 +46,38 @@ class TwilioCallMessage extends TwilioMessage
      */
     public function url(string $url): self
     {
+        $this->contentType(self::TYPE_URL);
         $this->content = $url;
 
         return $this;
     }
 
+    /**
+     * Set the message twiml.
+     *
+     * @param  string $twiml
+     * @return $this
+     */
+    public function twiml(VoiceResponse $response): self
+    {
+        $this->contentType(self::TYPE_TWIML);
+        $this->content = (string) $response;
+
+        return $this;
+    }
+
+    protected function contentType(string $contentType)
+    {
+        if (
+            !is_null($this->contentType)
+            && $contentType !== $this->contentType
+        ) {
+            InvalidConfigException::multipleContentTypes();
+        }
+
+        $this->contentType = $contentType;
+    }
+
     /**
      * Set the message url request method.
      *