service.php

См. документацию.

<?php
 
namespace Bitrix\Sender\Integration\MessageService\Sms;
 
use Bitrix\Main\Loader;
use Bitrix\Main\Web\Uri;
use Bitrix\MessageService;

class Service
{
    public static function canUse()
    {
        return Loader::includeModule('messageservice');
    }

    public static function getProviders()
    {
        $result = array();
        $list = static::getSenderInfoList();
        foreach ($list as $item)
        {
            $item['from'] = static::getSenderFromList($item['id']);
 
            $result[] = $item;
        }
 
        return $result;
    }

    public static function getSenderNames()
    {
        $list = array();
        foreach (self::getProviders() as $item)
        {
            if (!$item['canUse'] || count($item['from']) == 0)
            {
                continue;
            }
            foreach ($item['from'] as $number)
            {
                $id = $item['id'] . ':' . $number['id'];
                $name = $item['id'] === 'rest' ? $number['name'] : ($item['shortName'] ?: $item['name']);
                $list[$id] = $name;
            }
        }
 
        return $list;
    }

    public static function getDailyLimits()
    {
        return MessageService\Sender\Limitation::getDailyLimits();
    }

    public static function send($senderId, $from, $to, $text, $authorId = 1)
    {
        if (!static::canUse())
        {
            return false;
        }
 
        $sender = MessageService\Sender\SmsManager::getSenderById($senderId);
        if (!$sender)
        {
            return false;
        }
 
        $smsMessage = MessageService\Sender\SmsManager::createMessage(array(
            'AUTHOR_ID' => $authorId,
            'MESSAGE_TO' => $to,
            'MESSAGE_BODY' => $text,
            'MESSAGE_FROM' => $from,
            'MESSAGE_HEADERS' => array(
                'module_id' => 'sender'
            )
        ), $sender);
 
        $sendResult = $smsMessage->sendDirectly();
        return $sendResult->isSuccess();
    }

    public static function getManageUrl()
    {
        return MessageService\Sender\SmsManager::getManageUrl();
    }

    public static function getLimitsUrl()
    {
        return '/crm/configs/sms/?page=limits';
    }

    protected static function getSenderFromList($senderId)
    {
        $list = array();
        if (static::canUse())
        {
            $sender = MessageService\Sender\SmsManager::getSenderById($senderId);
            if ($sender)
            {
                $list = $sender->getFromList();
            }
        }
        return $list;
    }

    protected static function getSenderInfoList($getFromList = false)
    {
        $info = array();
        if (static::canUse())
        {
            $uri = new Uri(self::getManageUrl());
            foreach (MessageService\Sender\SmsManager::getSenders() as $sender)
            {
                $uri->deleteParams(['sender'])->addParams(['sender' => $sender->getId()]);
 
                $senderInfo = array(
                    'id' => $sender->getId(),
                    'isConfigurable' => $sender->isConfigurable(),
                    'name' => $sender->getName(),
                    'shortName' => $sender->getShortName(),
                    'canUse' => $sender->canUse(),
                    'isDemo' => $sender->isConfigurable() ? $sender->isDemo() : null,
                    'manageUrl' => $sender->isConfigurable() ?
                        $uri->getLocator() : ''
                );
 
                if ($getFromList)
                {
                    $senderInfo['fromList'] = static::getSenderFromList($sender->getId());
                }
 
                $info[] = $senderInfo;
            }
        }
 
        return $info;
    }
 
    public static function getFormattedOutputNumber($value)
    {
        static $numbers;
        if (null === $numbers)
        {
            $numbers = [];
            if (static::canUse())
            {
                $providers = static::getProviders();
                foreach ($providers as $provider)
                {
                    foreach ($provider['from'] as $number)
                    {
                        $numbers[$provider['id'] . ':'. $number['id']] = $number['name'];
                    }
                }
            }
        }
 
        return $numbers[$value] ?: $value;
    }
}