Msg91.php

<?php

namespace Utopia\Messaging\Adapters\SMS;

use Utopia\Messaging\Adapters\SMS as SMSAdapter;
use Utopia\Messaging\Messages\SMS;

// Reference Material
// https://docs.msg91.com/p/tf9GTextN/e/7WESqQ4RLu/MSG91

class Msg91 extends SMSAdapter
{
    /**
     * @param  string  $senderId Msg91 Sender ID
     * @param  string  $authKey Msg91 Auth Key
     */
    public function __construct(
        private string $senderId,
        private string $authKey
    ) {
    }

    public function getName(): string
    {
        return 'Msg91';
    }

    public function getMaxMessagesPerRequest(): int
    {
        // TODO: Find real limit
        return 1000;
    }

    /**
     * {@inheritdoc}
     *
     * @throws \Exception
     */
    protected function process(SMS $message): string
    {
        $to = \array_map(
            fn ($to) => ['mobiles' => \ltrim($to, '+')],
            $message->getTo()
        );

        return $this->request(
            method: 'POST',
            url: 'https://api.msg91.com/api/v5/flow/',
            headers: [
                'content-type: application/json',
                "authkey: {$this->authKey}",
            ],
            body: \json_encode([
                'sender' => $this->senderId,
                'otp' => $message->getContent(),
                'flow_id' => $message->getFrom(),
                'recipients' => [$to],
            ]),
        );
    }

    private function addTemplate(string $content, string $senderId, string $templateName, string $smsType = 'NORMAL')
    {
        return $this->request(
            method: 'POST',
            url: 'https://control.msg91.com/api/v5/sms/addTemplate',
            headers: [
                'content-type: application/json',
                "authkey: {$this->authKey}",
            ],
            body: \json_encode([
                'template' => $content,
                'sender_id' => $senderId,
                'template_name' => $templateName,
                'smsType' => 'NORMAL',
            ])
        );
    }
}