При интеграции через веб-хуки возникают следующие сложности:

• Внешний сервис (Битрикс24, amoCRM, платёжный шлюз) отключает webhook из-за превышения таймаута ответа (более 2-5 секунд).
• Атаки повторного воспроизведения (Replay attacks) и подделка входящих запросов из-за отсутствия валидации подписи.
• Блокировка сеансов 1С при одновременном поступлении сотен веб-хуков.
• Ошибки 404 Not Found или 500 Internal Server Error веб-сервера при вызове опубликованного HTTP-сервиса.

1. Архитектура обработки Webhook: Быстрый ACK + Фоновая очередь

HTTP-сервис 1С, принимающий веб-хук, обязан ответить статусом 200 OK в течение < 200 мс. Любая тяжелая бизнес-логика (проведение документов, пересчет регистров) должна помещаться во временный буфер (регистр сведений) и обрабатываться фоновым заданием.

2. Программный код HTTP-сервиса 1С для приема веб-хука с проверкой HMAC

// Метод HTTP-сервиса: POST /webhooks/v1/crm_event
Функция ОбработатьВходящийВебхук(ЗапросHTTP)
    
    // 1. Проверка секретного токена / HMAC-подписи
    СекретныйКлюч = "MySuperWebhookSecretKey2023";
    ПодписьЗаголовка = ЗапросHTTP.Заголовки.Получить("X-Hub-Signature-256");
    ТелоСтрокой = ЗапросHTTP.ПолучитьТелоКакСтроку(КодировкаТекста.UTF8);
    
    Если НЕ ПодписьКорректна(ТелоСтрокой, СекретныйКлюч, ПодписьЗаголовка) Тогда
        Ответ = Новый HTTPСервисОтвет(403);
        Ответ.УстановитьТелоИзСтроки("Invalid signature", КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
        Возврат Ответ;
    КонецЕсли;
    
    // 2. Быстрое сохранение в очередь без блокировок
    Попытка
        ЗаписьОчереди = РегистрыСведений.ВходящиеВебхукиОчередь.СоздатьМенеджерЗаписи();
        ЗаписьОчереди.Идентификатор = Новый УникальныйИдентификатор();
        ЗаписьОчереди.ДатаПолучения  = ТекущаяДатаСеанса();
        ЗаписьОчереди.Источник       = "Bitrix24";
        ЗаписьОчереди.ТелоЗапроса    = ТелоСтрокой;
        ЗаписьОчереди.Статус         = Перечисления.СтатусыОбработки.В_Очереди;
        ЗаписьОчереди.Записать();
        
        // 3. Немедленный ответ 200 OK внешнему сервису
        Ответ = Новый HTTPСервисОтвет(200);
        Ответ.Заголовки.Вставить("Content-Type", "application/json");
        Ответ.УстановитьТелоИзСтроки("{"status":"queued"}", КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
        Возврат Ответ;
        
    Исключение
        Ответ = Новый HTTPСервисОтвет(500);
        Ответ.УстановитьТелоИзСтроки(ОписаниеОшибки(), КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
        Возврат Ответ;
    КонецПопытки;
    
КонецФункции

3. Публикация HTTP-сервиса на веб-сервере (default.vrd)

Убедитесь, что в файле публикации default.vrd разрешен ваш HTTP-сервис:

<?xml version="1.0" encoding="UTF-8"?>
<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
       base="/trade_base"
       ib="File=&quot;C:\1C\Base&quot;;">
    <httpServices publishByDefault="false">
        <service name="WebhooksCRM"
                 rootURL="webhooks"
                 enable="true"/>
    </httpServices>
</point>