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

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

UniSender — один из ведущих российских сервисов email-рассылок с простым REST API. Подходит для среднего бизнеса: доступные тарифы, хорошая доставляемость на российские почтовые сервисы (Mail.ru, Яндекс.Почта).

API UniSender

Все методы доступны через https://api.unisender.com/ru/api/{method}?format=json&api_key={KEY}. Аутентификация — API-ключ в параметре запроса или заголовке. Ключ создаётся в настройках аккаунта UniSender.

Синхронизация контактов

class UniSenderClient {
    private string $apiKey;
    private string $baseUrl = 'https://api.unisender.com/ru/api/';

    public function __construct() {
        $this->apiKey = COption::GetOptionString('site', 'unisender_api_key');
    }

    public function importContacts(array $contacts, int $listId): array {
        // Пакетный импорт до 500 контактов за раз
        $fieldNames  = ['email', 'email_list_ids', 'Name', 'Phone'];
        $fieldValues = [];

        foreach ($contacts as $c) {
            $fieldValues[] = [
                $c['email'],
                (string)$listId,
                $c['name'] ?? '',
                $c['phone'] ?? '',
            ];
        }

        $http = new \Bitrix\Main\Web\HttpClient();
        return json_decode($http->post($this->baseUrl . 'importContacts', [
            'api_key'      => $this->apiKey,
            'format'       => 'json',
            'field_names'  => $fieldNames,
            'data'         => $fieldValues,
            'overwrite_tags'    => 1,
            'overwrite_lists'   => 0,
        ]), true);
    }
}

Метод importContacts — основной для массовой синхронизации. За один вызов — до 500 контактов. При экспорте всей базы разбиваем на батчи.

Обработчик подписки

AddEventHandler('subscribe', 'OnSubscribeSubscribe', function($id, $email, $fields) {
    $listId = COption::GetOptionString('site', 'unisender_list_id');
    $client = new UniSenderClient();
    $client->subscribe($email, $listId, [
        'Name'  => $fields['NAME'] ?? '',
        'Phone' => $fields['PERSONAL_PHONE'] ?? '',
    ]);
});

Метод subscribe добавляет одиночный контакт и отправляет ему письмо подтверждения (double opt-in), если эта настройка включена в UniSender.

Получение статуса контакта

Перед созданием рассылки полезно знать статус подписчика — активен ли, не отписался ли:

public function getContactStatus(string $email): string {
    $http = new \Bitrix\Main\Web\HttpClient();
    $response = json_decode($http->get(
        $this->baseUrl . 'getContact?api_key=' . $this->apiKey
        . '&format=json&email=' . urlencode($email)
    ), true);
    return $response['result']['status'] ?? 'unknown';
    // 'active', 'unsubscribed', 'bounced', 'spam'
}

Используем при обработке заказа: если покупатель отписан — не добавляем его в новые списки рассылки.

Триггерная рассылка после заказа

После оформления заказа отправляем серию транзакционных писем через UniSender Automation:

AddEventHandler('sale', 'OnSaleOrderSaved', function($order) {
    if (!$order->isNew()) return;
    $email = getOrderEmail($order);

    // Отправляем транзакционное письмо через UniSender
    $client = new UniSenderClient();
    $client->sendEmail([
        'to'         => [['email' => $email, 'name' => getOrderName($order)]],
        'subject'    => 'Заказ #' . $order->getId() . ' оформлен',
        'body'       => renderOrderEmailTemplate($order),
        'list_id'    => UNISENDER_TRANSACT_LIST_ID,
        'sender_name'  => 'Магазин',
        'sender_email' => '[email protected]',
    ]);
});

Аналитика доставляемости

UniSender предоставляет статистику через getCampaignStatus и getCampaignCommonStats. Получаем данные по каждой рассылке и логируем в пользовательский инфоблок Битрикса для мониторинга тренда:

• Open rate, CTR, bounces, unsubscribes.
• Если bounce rate > 5% — автоматически останавливаем кампанию и уведомляем маркетолога.