Интеграция 1С-Битрикс с SendPulse

Интеграция 1С-Битрикс с SendPulse

SendPulse — российский мультиканальный сервис: email, SMS, Viber, push-уведомления, чат-боты. Для российских проектов удобнее Mailchimp: рублёвые тарифы, техподдержка на русском, нет проблем с платежами. API v2 предоставляет полный набор методов для управления подписчиками и отправками.

Аутентификация в API SendPulse

SendPulse использует OAuth 2.0 Client Credentials. Перед каждой сессией получаем токен:

class SendPulseClient {
    private string $apiId;
    private string $apiSecret;
    private ?string $token = null;

    public function __construct() {
        $this->apiId     = COption::GetOptionString('site', 'sendpulse_id');
        $this->apiSecret = COption::GetOptionString('site', 'sendpulse_secret');
    }

    private function getToken(): string {
        // Кешируем токен на 1 час
        $cached = \Bitrix\Main\Data\Cache::createInstance();
        if ($cached->initCache(3500, 'sendpulse_token', '/sendpulse/')) {
            return $cached->getVars()['token'];
        }

        $http = new \Bitrix\Main\Web\HttpClient();
        $response = json_decode($http->post('https://api.sendpulse.com/oauth/access_token', [
            'grant_type'    => 'client_credentials',
            'client_id'     => $this->apiId,
            'client_secret' => $this->apiSecret,
        ]), true);

        $token = $response['access_token'];
        $cached->startDataCache();
        $cached->endDataCache(['token' => $token]);
        return $token;
    }

    public function call(string $method, string $endpoint, array $data = []): array {
        $http = new \Bitrix\Main\Web\HttpClient();
        $http->setHeader('Authorization', 'Bearer ' . $this->getToken());
        $http->setHeader('Content-Type', 'application/json');

        $url = 'https://api.sendpulse.com/' . ltrim($endpoint, '/');
        $response = $method === 'POST'
            ? $http->post($url, json_encode($data))
            : $http->get($url);

        return json_decode($response, true) ?? [];
    }
}

Управление адресными книгами

Адресная книга (mailing list) в SendPulse = список рассылки. Получаем ID книги через GET /addressbooks, сохраняем в COption.

Добавление подписчика:

public function addContact(string $email, array $variables = []): void {
    $this->call('POST', '/addressbooks/' . $this->listId . '/emails', [
        'emails' => [[
            'email'     => $email,
            'variables' => $variables, // [['name'=>'name','value'=>'Иван']]
        ]],
    ]);
}

Переменные аналогичны merge fields Mailchimp — name, phone, city, orders_count и любые кастомные.

Push-уведомления через SendPulse

Уникальная возможность SendPulse — push-уведомления в браузере. Подписчики, давшие разрешение, получают push даже без открытого сайта.

Подключение в шаблоне Битрикса:

<!-- Скрипт SendPulse Push -->
<script>
(function(d,w) {
    var n = d.getElementsByTagName('script')[0];
    var s = d.createElement('script');
    s.type = 'text/javascript';
    s.async = true;
    s.src = 'https://cdn.sendpulse.com/push/scripts/push.js';
    n.parentNode.insertBefore(s, n);
    w.PushwooshSDK_onLoad = function() {
        Pushwoosh.init({ 'applicationCode': '<?= COption::GetOptionString("site","sendpulse_push_id") ?>' });
    };
})(document, window);
</script>

При оформлении заказа — отправляем push с подтверждением через API:

$sp->call('POST', '/push/tasks', [
    'task' => [
        'list_id'    => $pushListId,
        'subject'    => 'Заказ #' . $orderId . ' принят',
        'body'       => 'Ваш заказ на сумму ' . $orderPrice . ' руб. принят в обработку',
        'send_date'  => 'now',
        'filter'     => ['variable' => 'user_id', 'operator' => '=', 'value' => $userId],
    ],
]);

Автоматизация через SendPulse Automation 360

SendPulse Automation 360 — визуальный редактор триггерных цепочек. Запускаем цепочку через API-событие:

// Запускаем автоматизацию "welcome_series" для нового подписчика
$sp->call('POST', '/flows/run', [
    'flow_id'  => 'FLOW_ID_FROM_SENDPULSE',
    'email'    => $email,
    'variables'=> ['order_id' => $orderId, 'product_name' => $productName],
]);

Цепочка в SendPulse включает: email → задержка 2 дня → SMS → если не открыл email → Viber-сообщение.