Создание лида в CRM через API: заявки из вашей системы с источником

Создание лида в CRM через API нужно, когда заявки рождаются не в форме на сайте, а в вашей системе: личном кабинете, мобильном приложении, калькуляторе, учётной программе. Если такие заявки переносить руками, они опаздывают, а источник рекламы теряется. Отчёты показывают непонятный трафик, и бюджет на рекламу распределяют вслепую.

API — это набор запросов, через которые программа обменивается данными с CRM без участия человека. Программист один раз настраивает отправку, и каждая заявка сразу становится лидом — карточкой клиента в CRM. Посмотрите видео на две минуты, а ниже — пошаговая настройка.

Зачем бизнесу заявки через API

• Сервис с личным кабинетом. Пользователь зарегистрировался — в CRM появляется лид, и менеджер звонит, пока интерес горячий.
• Магазин на своей платформе. Заказ в один клик становится лидом, а состав заказа — комментарием в карточке.
• Калькулятор или квиз на своём движке. Ответы ложатся в поля карточки, и менеджер видит задачу ещё до звонка.
• Своё приложение. Заявка из мобильного приложения сразу попадает в общую воронку вместе с заявками с сайта и звонками.

Как работает API CRM

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

Схема входа «API» собирается из тех же блоков, что и схема входящих звонков, — об этом статья «Виртуальная АТС для бизнеса».

Как подключить создание лида через API

1. 1
   Откройте документацию

   Меню «Помощь» → «Документация по API». Там запросы, поля и примеры: передайте ссылку программисту.
2. 2
   Получите токен

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

   Если заявка пришла с сайта, на его страницах должен стоять код системы: он запоминает визит посетителя. Программист передаёт идентификатор визита (view_id) в запрос создания лида, и у лида появятся источник, кампания и ключевое слово.
4. 4
   Настройте вход «API»

   «Телефония» → «Настройка входящих» → строка «API». Добавьте блоки: дозвон менеджерам, сообщение клиенту, автоворонку. Пока у входа метка «Нет блоков», обращения никуда не идут.
5. 5
   Проверьте

   Отправьте тестовую заявку из своей системы и откройте лида в CRM: контакты, поля и источник должны быть на месте.

Как получать данные из CRM в свою систему

Обратное направление тоже автоматизируется. В меню «Помощь» → «Менеджер webhook» укажите адрес вашей системы: при каждом изменении лида — смене шага, правке полей, новом комментарии или платеже — кабинет сам отправит его данные POST-запросом. Подробно об этом — в статье «Вебхук CRM». Через API те же данные можно забирать запросами: лида по номеру, список лидов проекта, комментарии и историю переписки.

Если программиста нет

API — инструмент для программиста. Без него заявки с сайта подключаются кодом и разметкой форм — см. статью «Заявки с сайта в CRM», а формы Tilda и Flexbe — вебхуком конструктора: «Заявки с Tilda в CRM». Нужна сложная связка с вашей системой — закажите внедрение под ключ: кнопка в конце статьи.

Читайте также: Вебхук CRM, Заявки с сайта в CRM, Интеграция с Битрикс24