Added tests for TwilioContentTemplateMessage

Minor README tweaks
Updated CHANGELOG for v4.1.1

Author: onlime

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to `laravel-notification-channels/twilio` will be documented in this file.
 
+## [4.1.1](https://github.com/laravel-notification-channels/twilio/releases/tag/4.1.1) (2025-07-07)
+
+- Added support for content templates (i.e. whatsapp) #152 by @alexw23
+
 ## [4.1.0](https://github.com/laravel-notification-channels/twilio/releases/tag/4.1.0) (2025-03-03)
 
 - Added Laravel 12 support #155 #157

README.md

@@ -5,7 +5,7 @@
 [![Build Status](https://github.com/laravel-notification-channels/twilio/actions/workflows/ci.yml/badge.svg)](https://github.com/laravel-notification-channels/twilio/actions/workflows/ci.yml)
 [![Total Downloads](https://img.shields.io/packagist/dt/laravel-notification-channels/twilio.svg)](https://packagist.org/packages/laravel-notification-channels/twilio)
 
-This package makes it easy to send [Twilio notifications](https://documentation.twilio.com/docs) with Laravel 11.x
+This package makes it easy to send [Twilio notifications](https://documentation.twilio.com/docs) with Laravel 11.x / 12.x
 
 ## Contents
 
@@ -86,7 +86,7 @@ suppressed.
 
 ## Usage
 
-Now you can use the channel in your `via()` method inside the notification:
+Now you can use the channel in your `via()` method inside the notification to send an **SMS**:
 
 ``` php
 use NotificationChannels\Twilio\TwilioChannel;
@@ -108,7 +108,7 @@ class AccountApproved extends Notification
 }
 ```
 
-You can also send an MMS:
+You can also send an **MMS**:
 
 ``` php
 use NotificationChannels\Twilio\TwilioChannel;
@@ -131,7 +131,7 @@ class AccountApproved extends Notification
 }
 ```
 
-You can also send using Content Templates:
+You can also send using **Content Templates**:
 
 ``` php
 use NotificationChannels\Twilio\TwilioChannel;
@@ -157,9 +157,10 @@ class AccountApproved extends Notification
 }
 ```
 
-*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).*
+> [!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:
+Or create a **Twilio Call Message**:
 
 ``` php
 use NotificationChannels\Twilio\TwilioChannel;
@@ -198,6 +199,15 @@ public function routeNotificationForTwilio()
 - `content('')`: Accepts a string value for the notification body.
 - `messagingServiceSid('')`: Accepts a messaging service SID to handle configuration.
 
+#### TwilioMmsMessage
+
+- `mediaUrl('')`: Set the message media url.
+
+#### TwilioContentTemplateMessage
+
+- `contentSid('')`: Set the content sid (starting with H).
+- `contentVariables([...])`: Set the content variables.
+
 #### TwilioCallMessage
 
 - `from('')`: Accepts a phone to use as the notification sender.

src/TwilioContentTemplateMessage.php

@@ -6,21 +6,16 @@ class TwilioContentTemplateMessage extends TwilioSmsMessage
 {
     /**
      * The SID of the content template (starting with H)
-     * @var null|string
      */
-    public $contentSid;
+    public ?string $contentSid;
 
     /**
      * The variables to replace in the content template
-     * @var null|array|string
      */
-    public $contentVariables;
+    public string|array|null $contentVariables;
 
     /**
      * Set the content sid (starting with H).
-     *
-     * @param  string $contentSid
-     * @return $this
      */
     public function contentSid(string $contentSid): self
     {
@@ -33,7 +28,6 @@ public function contentSid(string $contentSid): self
      * 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
     {

tests/Unit/TwilioContentTemplateMessageTest.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace NotificationChannels\Twilio\Tests\Unit;
+
+use NotificationChannels\Twilio\TwilioContentTemplateMessage;
+use PHPUnit\Framework\Attributes\Test;
+
+class TwilioContentTemplateMessageTest extends TwilioMessageTestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->message = new TwilioContentTemplateMessage;
+    }
+
+    #[Test]
+    public function it_can_accept_a_message_when_constructing_a_message()
+    {
+        $message = new TwilioContentTemplateMessage('myMessage');
+
+        $this->assertEquals('myMessage', $message->content);
+    }
+
+    #[Test]
+    public function it_provides_a_create_method()
+    {
+        $message = TwilioContentTemplateMessage::create('myMessage');
+
+        $this->assertEquals('myMessage', $message->content);
+    }
+
+    #[Test]
+    public function it_sets_alphanumeric_sender()
+    {
+        $message = TwilioContentTemplateMessage::create('myMessage');
+        $message->sender('TestSender');
+
+        $this->assertEquals('TestSender', $message->alphaNumSender);
+    }
+
+    #[Test]
+    public function it_sets_content_sid()
+    {
+        $message = TwilioContentTemplateMessage::create('myMessage');
+        $message->contentSid('HXXXXXXXXXXXXXXXXXXXXXXXX');
+
+        $this->assertEquals('HXXXXXXXXXXXXXXXXXXXXXXXX', $message->contentSid);
+    }
+
+    #[Test]
+    public function it_sets_content_variables()
+    {
+        $message = TwilioContentTemplateMessage::create('myMessage');
+        $message->contentVariables([
+            '1' => 'John Doe',
+            '2' => 'ACME Inc.',
+        ]);
+
+        $this->assertEquals('{"1":"John Doe","2":"ACME Inc."}', $message->contentVariables);
+    }
+}