Захват лидов и CRM

Ключевая фича — бот сам распознаёт email и телефон в сообщениях посетителей и автоматически создаёт лид в вашей CRM Framix. Никакой настройки форм, никакого кода — просто отвечает на вопросы и между делом собирает контакты.

Как это работает

1. Посетитель пишет боту: «Здравствуйте, меня Коля зовут, моя почта kolya@example.com — пришлите прайс».
2. Сервер распознаёт kolya@example.com регексом — создаёт запись в таблице CRM project_collection.
3. В CRM лид появляется с привязкой к агенту и сессии диалога.
4. Если в настройках указан webhook — POST-запрос с данными лида уходит на ваш URL.
5. Бот продолжает разговор как обычно.

Лид создаётся один раз на сессию — дубликатов не будет, даже если тот же email упоминается повторно.

Что ищется

• Email — стандартный формат name@domain.tld
• Телефон — 10–15 цифр, с любыми разделителями (+, пробел, -, (), .)

Распознаются вперемешку с любым текстом — пользователь может написать «звоните +7 999 123-45-67 или на mail@domain.ru» — и оба контакта попадут в лид.

Где посмотреть лидов

Личный кабинет → CRM (/account/crm) — общий список. Лиды от агентов показываются вперемешку с лидами из форм на сайтах — единый канал обработки.

В карточке лида (клик по строке):

• Название агента, который захватил лид
• Захваченный email и/или телефон
• Данные посетителя: страна, город, устройство, IP
• История диалога — полный текст разговора с ботом / оператором, с Markdown, Markdown-ссылками, пометкой роли (бот / оператор)
• Кнопка «Открыть в агенте» → переходит сразу на карточку сессии в разделе агента (можно ответить как оператор из CRM-контекста)

Настройка

В настройках агента → блок «Безопасность и UX»:

• Захват лидов в CRM — тумблер. По умолчанию включён. Выключи, если не хочешь автоматически создавать лиды (например, тестовый бот).
• Webhook на захват лида — опциональное поле. Если задан URL — при каждом захвате туда полетит POST-запрос с JSON.

Webhook payload

{
  "event": "lead_captured",
  "agentId": "agt_abc123",
  "sessionId": "ses_xyz789",
  "leadId": "lead_0001",
  "email": "kolya@example.com",
  "phone": "+7 999 123-45-67",
  "capturedAt": "2026-04-15T12:34:56.789Z"
}

Используй для:

• Интеграции с внешней CRM (amoCRM, Bitrix24, HubSpot): принимай POST → создавай сделку / карточку.
• Уведомлений в Telegram/Slack: бот создаёт лид → тебе приходит сообщение в мессенджер.
• Webhook-платформ типа Make/Zapier: подключи endpoint к своему сценарию.

Framix выполняет webhook асинхронно, один раз. Если endpoint вернул ошибку — повторно не шлём. Для надёжной доставки используй промежуточный сервис-коннектор (Make/n8n/Zapier).

Подключение оператора из CRM

В карточке лида кнопка «Открыть в агенте» ведёт напрямую на сессию диалога в агенте. Там можно:

• Прочитать весь диалог
• Увидеть онлайн-статус посетителя и его текущую страницу
• Нажать «Подключиться к чату» и ответить ему руками
• После ответа — передать обратно боту или продолжить самому

Это связка CRM + Агенты + Оператор в одном потоке: пришёл лид → смотришь историю → подключаешься к живому чату → закрываешь сделку.

Советы

1. Попроси бота самого собирать контакт. В системном промпте агента:

   Если посетитель проявляет интерес (спрашивает о ценах, хочет оформить, просит помочь с выбором) — попроси оставить email или телефон, чтобы менеджер связался для уточнения деталей.
   

   
   Бот будет активно подталкивать к контакту, захват сработает.
2. Не собирай всех подряд. Отключи автозахват для bot-FAQ / helpdesk, где email — просто часть вопроса, а не лид.
3. Комбинируй с quick-replies. Бот может предложить кнопку «Оставить контакт» → клик → пользователь вводит почту → лид готов.
4. Свой webhook + CRM. Если уже работаете в другой CRM — настрой webhook, чтобы лиды из Framix дублировались туда. Всё остальное (история диалога, файлы, аналитика) остаётся в Framix.