Инструкция · 10 мин

Статусы лидов из CRM: воронка от лида Авито до договора и окупаемость

Авито знает, сколько было звонков и чатов, но не знает, кто из этих людей дошёл до встречи, брони и договора. Это знает CRM. Подключите вебхук — и CRM будет сообщать ИИстоку статус каждого лида. Тогда ИИ-Авитолог покажет воронку «лиды CPA → встречи → брони → договоры» с причинами отказов, а страница «Окупаемость» — продажи, выручку и ROMI по каналам. Телефон на сервере сразу превращается в обезличенный ключ и не хранится; в отчётах только цифры.

1. Шаг 1

   Получите адрес вебхука

   Страница «ИИ-Авитолог» → блок «Статусы лидов из CRM» → «Получить адрес вебхука». Адрес показывается один раз — скопируйте его сразу. Потеряли или он попал не туда — «Выпустить новый адрес»: старый перестанет работать, и его нужно заменить в CRM.

2. Шаг 2

   Настройте отправку в CRM

   В CRM или в Albato/Make сделайте действие «отправить вебхук» при смене этапа сделки: метод POST, на полученный адрес, в формате JSON или обычной формы. Можно слать одно событие, массив событий или {"events": [...]} — до 500 событий за запрос.

3. Шаг 3

   Какие поля передавать

   Обязательно: phone (телефон клиента) или lead_key, и status. Статус можно слать словами из CRM: «встреча» или «показ», «бронь», «ДДУ», «договор» или «сделка», «отказ» — сервис сам разложит их по этапам. Дополнительно: reason — причина отказа; avito_id — номер объявления; at — дата события; amount — сумма сделки в рублях; source — канал: avito, direct или vk. Без source лид считается лидом Авито.

4. Шаг 4

   Пример запроса

   curl -X POST https://iistok.pro/api/crm/leads/crm_ваш_токен -H "Content-Type: application/json" -d '{"phone": "+7 900 000-00-00", "status": "ДДУ", "amount": 6450000, "source": "avito", "avito_id": "1234567890"}'. В ответ придёт {"accepted": 1, "rejected": 0}. Событие без телефона (или lead_key) или без статуса не принимается и попадает в rejected. В блоке видно время последнего полученного статуса.

5. Шаг 5

   Смотрите воронку

   Спросите Авитолога: «Покажи воронку из CRM за сентябрь», «Сколько лидов CPA дошли до брони?», «Какие причины отказов чаще всего?». Лид сопоставляется с обращением на Авито по телефону, поэтому в CRM должен быть тот номер, с которого покупатель звонил или писал. Договор считается и бронью, и встречей.

6. Шаг 6

   Считайте окупаемость

   Откройте «Окупаемость» в меню: продажи и выручка из статусов CRM ставятся рядом с расходами на Авито, Директ и VK Рекламу — видно, какой канал окупается. Продажей считается статус договора; сумма — наибольшая из присланных по лиду, поэтому повторные статусы при правке сделки не задваивают выручку.

7. Шаг 7

   Хранение и удаление

   Статусы хранятся 13 месяцев. Если клиент попросил удалить его данные, отправьте на тот же адрес его телефон с полем "delete": true — все статусы по нему сотрутся.