Интеграции

Обмен с 1С: готовая обработка

Программист 1С не нужен. Обработку «Дворум: обмен с 1С» присылает техническая поддержка, подключает её бухгалтер.

1. Модератор выпускает токен в настройках объекта: «Оплата» → «Интеграция с 1С».
2. Бухгалтер открывает обработку в 1С, вставляет токен и выбирает месяц.
3. Нажимает «Обменяться»: показания приходят таблицей, начисления и оплаты уходят в Дворум. В журнале обмена видно, что принято, а что нет и почему.
4. Чтобы обмен шёл сам, обработку подключают в «Дополнительные отчёты и обработки» и задают расписание — например, каждый день в 7:00.

Начисления и оплаты обработка сама берёт из документов «1С:Бухгалтерии предприятия 3.0». Для других программ 1С, например для ЖКХ, — из файла Excel, сохранённого из отчёта. Плательщика обе системы узнают по номеру договора.

Вебхуки: как устроены

Модератор объекта добавляет адрес в настройках на вкладке «Интеграции», выбирает события и получает секрет подписи. Дальше каждое событие уходит POST-запросом с JSON.

События

request.created

Новая заявка

request.status_changed

Смена статуса заявки

payment.received

Поступление оплаты

pass.created

Пропуск выписан

pass.entered

Въезд или проход по пропуску

pass.exited

Выезд или выход по пропуску

tenant.moved_in

Въезд арендатора

tenant.moved_out

Выезд арендатора

payment.deleted

Поступление снято

pass.cancelled

Пропуск отменён

bill.created

Новое начисление

request.rated

Оценка выполненной заявки

request.sla_breached

Заявка вышла за норматив

В сообщении нет имён, телефонов, почты и госномеров. Помещение передаётся номером (дом, офис, квартира), организация — названием, люди — никак. Подробности открываются по ссылке на карточку.

Формат сообщения

Поле id одно и то же во всех повторах одного события: по нему получатель отсекает дубли.

POST https://your-crm.example/hook
Content-Type: application/json
X-Dvorum-Event: request.status_changed
X-Dvorum-Delivery: 66f1c0e2a9b3d4e5f6a7b8c9
X-Dvorum-Signature: t=1758795300,v1=5f2b…

{
  "id": "66f1c0e2a9b3d4e5f6a7b8c0",
  "type": "request.status_changed",
  "createdAt": "2026-09-25T10:15:00.000Z",
  "place": { "id": "…", "name": "…" },
  "data": {
    "request": {
      "id": "…",
      "title": "…",
      "status": "IN_PROGRESS",
      "category": { "key": "plumbing", "name": null },
      "house": { "id": "…", "name": "312", "building": "A", "floor": 3 },
      "zone": null,
      "tenant": { "id": "…", "name": "…" },
      "planned": false,
      "createdAt": "2026-09-25T09:02:11.000Z",
      "url": "https://dvorum.com/requests/…"
    },
    "from": "ACCEPTED",
    "to": "IN_PROGRESS"
  }
}

Подпись

Заголовок X-Dvorum-Signature содержит метку времени t и подпись v1 — HMAC-SHA256 от строки «t.тело» на секрете. Проверяйте подпись по телу в том виде, в каком оно пришло, до разбора JSON, и отбрасывайте метки старше пяти минут.

import crypto from "node:crypto";

function verify(secret, header, rawBody) {
  const sig = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${sig.t}.${rawBody}`)
    .digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}

Доставка и повторы

• Ответ 2xx в течение 10 секунд — сообщение доставлено. Любой другой ответ или его отсутствие — ошибка.
• После ошибки попытка повторяется через 1 минуту, 5 минут, 30 минут, 2 часа, 6 часов и сутки — всего семь попыток.
• Если адрес не принимает сообщения трое суток, он выключается, а модераторам объекта приходит уведомление.
• Журнал доставок за 30 дней — с телом сообщения и ответом получателя — открывается на странице вебхука; там же кнопки «Проверить» и «Повторить сейчас».

Битрикс24

Подключается в настройках объекта, на вкладке «Интеграции»: адрес входящего вебхука портала и выбор — лид или сделка. Дальше Дворум сам вызывает REST портала.

• Новая заявка — лид или сделка: заголовок, помещение, зона, тема и ссылка на карточку заявки.
• Смена статуса заявки — комментарий в ленте той же записи.
• «Проверить» показывает, на связи ли портал и есть ли у вебхука право CRM.

Как и в вебхуке, имён, телефонов и почты в записи нет. Остальные события — оплаты, пропуска, арендаторы — Битрикс24 принимает через обычный вебхук.

amoCRM

Подключается в настройках объекта, на вкладке «Интеграции»: адрес аккаунта, долгосрочный токен приватной интеграции и этап, куда встаёт новая сделка. Дальше Дворум сам вызывает API аккаунта.

• Новая заявка — сделка в выбранном этапе с примечанием: помещение, зона, тема и ссылка на карточку заявки.
• Смена статуса заявки — примечание к той же сделке.
• Этап сделки может менять статус заявки: подписка на смену этапа — кнопкой в настройках, этапы сопоставляются со статусами.
• «Проверить» показывает, действует ли токен и на месте ли выбранный этап.

Как и в вебхуке, имён, телефонов и почты в сделке нет.