Merge pull request #152 from alexw23/twilio-content-templates

Added support for content templates (i.e. whatsapp)

Author: onlime

README.md

@@ -131,6 +131,34 @@ class AccountApproved extends Notification
 }
 ```
 
+You can also send using Content Templates:
+
+``` php
+use NotificationChannels\Twilio\TwilioChannel;
+use NotificationChannels\Twilio\TwilioContentTemplateMessage;
+use Illuminate\Notifications\Notification;
+
+class AccountApproved extends Notification
+{
+    public function via($notifiable)
+    {
+        return [TwilioChannel::class];
+    }
+
+    public function toTwilio($notifiable)
+    {
+        return (new TwilioContentTemplateMessage())
+            ->contentSid("HXXXXXXXXXXXXXXXXXXXXXXXX")
+            ->contentVariables([
+                '1' => 'John Doe',
+                '2' => 'ACME Inc.',
+            ]);
+    }
+}
+```
+
+*Note: if sending via WhatsApp, you must add `whatsapp:` to the beginning of the phone number (i.e. `->from('whatsapp:+61428000382')`). The number must also be approved as a [WhatsApp Sender](https://www.twilio.com/console/sms/whatsapp/senders).*
+
 Or create a Twilio call:
 
 ``` php

src/Twilio.php

@@ -89,6 +89,13 @@ protected function sendSmsMessage(TwilioSmsMessage $message, ?string $to): Messa
             ]);
         }
 
+        if ($message instanceof TwilioContentTemplateMessage) {
+            $this->fillOptionalParams($params, $message, [
+                'contentSid',
+                'contentVariables',
+            ]);
+        }
+
         return $this->twilioService->messages->create($to, $params);
     }
 

src/TwilioContentTemplateMessage.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace NotificationChannels\Twilio;
+
+class TwilioContentTemplateMessage extends TwilioSmsMessage
+{
+    /**
+     * The SID of the content template (starting with H)
+     * @var null|string
+     */
+    public $contentSid;
+
+    /**
+     * The variables to replace in the content template
+     * @var null|array|string
+     */
+    public $contentVariables;
+
+    /**
+     * Set the content sid (starting with H).
+     *
+     * @param  string $contentSid
+     * @return $this
+     */
+    public function contentSid(string $contentSid): self
+    {
+        $this->contentSid = $contentSid;
+
+        return $this;
+    }
+
+    /**
+     * Set the content variables.
+     *
+     * @param  array $contentVariables The variables to replace in the content template (i.e. ['1' => 'John Doe'])
+     * @return $this
+     */
+    public function contentVariables(array $contentVariables): self
+    {
+        $this->contentVariables = json_encode($contentVariables);
+
+        return $this;
+    }
+}