Webhook для приёма лидов

Авторизация

Каждый запрос должен содержать заголовок X-API-KEY с вашим личным ключом. Ключ находится в кабинете DialogCRM: Настройки → Интеграции → Public API & Webhooks.

Поддерживаются два типа ключей:

• dg_… — ключ компании. Лид попадает в воронку по умолчанию (самая старая).
• dgf_… — ключ конкретной воронки. Лид попадает сразу в эту воронку.

Тело запроса (JSON)

Примеры

Замените YOUR_API_KEY на ваш ключ из кабинета.

Копироватьcurl -X POST https://dialogsystems.ru/api/webhooks/lead \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -d '{
    "name":   "Иван Иванов",
    "phone":  "+79991234567",
    "email":  "ivan@example.com",
    "city":   "Москва",
    "budget": 100000,
    "source": "Лендинг",
    "comment":"Интересует тариф Pro"
  }'

Копировать// Браузерный fetch — только для серверных скриптов или защищённого окружения!
const response = await fetch('https://dialogsystems.ru/api/webhooks/lead', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    name: 'Иван Иванов',
    phone: '+79991234567',
    email: 'ivan@example.com',
    source: 'Лендинг'
  })
});

const data = await response.json();
console.log(data);

Копироватьimport fetch from 'node-fetch'; // или встроенный fetch в Node 18+

const res = await fetch('https://dialogsystems.ru/api/webhooks/lead', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': process.env.DIALOGCRM_API_KEY
  },
  body: JSON.stringify({
    name: 'Иван Иванов',
    phone: '+79991234567',
    source: 'Tilda'
  })
});

console.log(res.status, await res.json());

Копировать<?php
$ch = curl_init('https://dialogsystems.ru/api/webhooks/lead');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-API-KEY: YOUR_API_KEY',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'name'   => 'Иван Иванов',
    'phone'  => '+79991234567',
    'email'  => 'ivan@example.com',
    'source' => 'Лендинг',
]));

$response = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP $code\n$response";

Копироватьimport requests

r = requests.post(
    'https://dialogsystems.ru/api/webhooks/lead',
    headers={
        'Content-Type': 'application/json',
        'X-API-KEY': 'YOUR_API_KEY',
    },
    json={
        'name': 'Иван Иванов',
        'phone': '+79991234567',
        'email': 'ivan@example.com',
        'source': 'Лендинг',
    },
    timeout=10,
)

print(r.status_code, r.json())

Ответы

201 Created — создан новый лид

Копировать{
  "success": true,
  "message": "Lead created successfully",
  "leadId":  "8f3c1b1e-3a4d-4f2e-9c1d-7b8a2f0d4e21"
}

200 OK — найден дубль, новый лид НЕ создан

Если в вашей компании уже есть лид с таким же телефоном или email, новый лид не создаётся. Вместо этого самый свежий существующий лид «оживляется» — возвращается на первый этап своей воронки, менеджеру добавляется заметка о повторной заявке. В leadId приходит id этого существующего лида.

Копировать{
  "success": true,
  "deduped": true,
  "message": "Duplicate detected — existing lead revived",
  "leadId":  "8f3c1b1e-3a4d-4f2e-9c1d-7b8a2f0d4e21"
}

Ошибки

Лимиты и правила

• Rate-limit: до 100 запросов за 15 минут с одного IP.
• HTTPS: обязателен. HTTP-запросы в проде отклоняются.
• Дубли: проверяются по телефону и email в пределах вашей компании (между компаниями изоляция полная). При совпадении новый лид не создаётся — см. ответ 200 deduped выше.
• Автоматизации: триггеры lead_created (приветственные сообщения, назначение менеджера и т.д.) срабатывают только на 201 — на «оживлённый» дубль они не запускаются.

Что делать, если ключ скомпрометирован

Откройте Настройки → Интеграции → Public API & Webhooks и нажмите «Обновить». Старый ключ перестанет работать сразу, новый нужно прописать во всех ваших интеграциях.

Booking API — онлайн-запись (v1)

Открытый API модуля «Онлайн-запись»: показывайте услуги, свободные слоты и записывайте клиентов из своего сайта или приложения.

Авторизация не требуется: адресом служит публичный slug опубликованной страницы записи (вкладка «Витрина» в CRM). Все ответы — JSON с полем ok.

Витрина: страница (название, оформление, таймзона, правила записи), категории, услуги (id, name, durationMin, priceMode, price, isOnline, staffIds) и мастера (id, name, jobTitle, photo).

Свободные слоты дня в таймзоне страницы: [{ time: "10:00", startsAt: "…ISO…", staffIds: [...] }]. Без staffId — объединение по всем мастерам услуги («любой мастер»).

Создать запись. Тело: serviceId, startsAt (ISO из слота), name, phone, consent: true (согласие 152-ФЗ — обязательно), опционально staffId, email, comment, src (метка канала для отчёта «Откуда записываются»). Ответ 201: booking.token — ссылка клиента на управление записью: /book/{slug}?m={token}.

Поддерживается заголовок Idempotency-Key (до 80 символов): повтор запроса с тем же ключом вернёт 200 с той же записью — безопасные ретраи.

Просмотр и отмена записи по клиентскому токену (отмена доступна до дедлайна, заданного компанией).

Коды ошибок

• 409 slot_taken / 409 slot_expired — время заняли или слот больше не действует: обновите слоты и предложите другое.
• 409 too_many_bookings — превышен лимит активных записей на один номер телефона.
• 400 consent_required — не передано согласие на обработку персональных данных.
• 403 booking_disabled — онлайн-запись у компании временно отключена.
• 429 rate_limited — превышена частота запросов (слоты — 120/мин, запись — 10 за 15 минут с IP).

REST API v1 — лиды (модуль «Публичный API»)

Полноценный доступ к лидам вашей CRM для собственных интеграций: чтение и создание по токену.

Подключите модуль «Публичный API и вебхуки» в Маркетплейсе, затем в Центре интеграций выпустите токен (карточка модуля → «API и вебхуки»). Токен показывается один раз — сохраните его сразу. Права задаются на выпуске: leads:read (чтение), leads:write (создание).

Авторизация — заголовком: Authorization: Bearer dcrm_…. Лимит: 120 запросов в минуту на токен. Отзыв токена в CRM закрывает доступ немедленно.

Список лидов (новые первыми): { total, limit, offset, leads: [{ id, name, phone, email, budget, paidAmount, funnelId, stageId, managerId, tags, source, createdAt }] }. Максимум 100 за запрос.

Один лид тем же составом полей. Чужой или несуществующий id — 404.

Создать лида. Тело: name (обязательно), опционально phone, email, city, budget, source, utmSource, tags, funnelId (по умолчанию — первая воронка). Лид попадает на первый этап без ответственного — распределение выполняют ваши автоматизации (событие «Лид создан»). Ответ 201 — созданный лид.

Исходящие вебхуки

Мы сами уведомим ваш сервер о событиях сделок — без поллинга.

Подписки создаются там же («API и вебхуки»): укажите https-адрес приёмника и события — lead.created, lead.stage_changed, lead.assigned, lead.won, lead.lost, task.completed, lead.payment_received. При создании выдаётся секрет whsec_… (показывается один раз).

На событие приходит POST с JSON { event, companyId, occurredAt, lead: {…} } и заголовками X-DialogCRM-Event, X-DialogCRM-Delivery (id доставки — для дедупликации) и X-DialogCRM-Signature — HMAC-SHA256 тела запроса вашим секретом (hex). Проверяйте подпись и отвечайте 2xx в пределах 10 секунд.

Недоставленные события ретраятся через 1 мин / 5 мин / 30 мин / 2 часа. После 20 неудачных доставок подряд подписка автоматически выключается (админы получат уведомление) — включите её заново после починки приёмника; лог доставок виден в CRM.