Sending an SMS to someone can be done in a few ways.

Notifier mapped recipient objects

The recommended method is via Notifier by sending a notification to a mapped object.

use Symfony\Component\Notifier\Notification\Notification;

$user = User::load(1);
$notification = (new Notification())->subject('Contents of SMS message!');
$this->notifier->send(for: $user, notification: $notification);

Sending by Verification Status

By default, SMS Framework will remove unverified recipients as determined by the verification system. To allow sending messages to a recipient with a specific state, or any state, pass along query options:

use Drupal\notifier\Recipients\RecipientQuery; 
use Drupal\notifier\Sender\QueryOptions as NotifierQueryOptions;
use Drupal\sms\PhoneNumberVerification\Enum\VerificationRequirement;
use Drupal\sms\PhoneNumber\QueryOptions as SmsQueryOptions;
use Symfony\Component\Notifier\Notification\Notification;

$user = User::load(1);
$notification = (new Notification())->subject('Contents of SMS message!');
$options = new NotifierQueryOptions( 
  recipientQuery: (new RecipientQuery())->setOptions(
    new SmsQueryOptions(verified: VerificationRequirement::Any),
  ),
);
$this->notifier->send(for: $user, notification: $notification, options: $options);

The verified argument of Drupal\sms\PhoneNumber\QueryOptions accepts:

• VerificationRequirement::Any — send to all phone numbers, ignoring verification.
• VerificationRequirement::Unverified — only send to unverified phone numbers.
• VerificationRequirement::Verified — only send to verified phone numbers.

SMS phone number service

Messages can also be sent via the SMS phone number service, however it does use parts of Notifier under the hood, particularly the recipients and sending services. Using this method is not recommended, as it is less flexible.

services:
  _defaults:
    autowire: true
    
  my_service:
    class: Drupal\my_module\MyService

namespace Drupal\my_module;

final class MyService {
  public function __construct(
    private readonly \Drupal\sms\PhoneNumber\SmsPhoneNumberInterface $smsPhoneNumber,
  ) {}

  public function myMethod(){
    $user = User::load(1);
    $notification = (new \Symfony\Component\Notifier\Notification\Notification())
      ->subject('Test subject!')
      ->content('Test message');
    $this->smsPhoneNumber->send(for: $user, notification: $notification);
  }
}

WARNING

By default notifications will only be sent to phone numbers which have been verified. See below to change this behavior.

An \Drupal\sms\PhoneNumber\Exception\NoPhoneNumberException exception is thrown if the for object does not have a phone number.

Send to any number, even if unverified

SMS Framework defaults to using the verification system by only sending messages if the recipient was verified previously. To change this behavior, provide a QueryOptions object to the send method.

namespace Drupal\my_module;

final class MyService {
  public function __construct(
    private readonly \Drupal\sms\PhoneNumber\SmsPhoneNumberInterface $smsPhoneNumber,
  ) {}

  public function myMethod(){
    $options = new \Drupal\sms\PhoneNumber\QueryOptions(
      verified: \Drupal\sms\PhoneNumberVerification\Enum\VerificationRequirement::Any, 
    );
    $this->smsPhoneNumber->send(
      for: $user, 
      notification: $notification, 
      options: $options, 
    );
  }
}

An \Drupal\sms\PhoneNumber\Exception\NoPhoneNumberException exception will be thrown if the user does not have phone numbers that match the criteria, regardless if there are numbers that do not match the criteria.