Что такое API
Заявка с сайта сама появляется в CRM, оплата из банка сама отмечается в сделке, остатки из 1С видны менеджеру — за всем этим стоит API. Слово звучит технически, но идея простая, и понимать её полезно не только программисту: так проще поставить задачу, оценить сроки и не переплатить. Разбираем, что такое API, как устроен запрос, что такое REST, ключ, токен, лимиты и вебхуки, — на примерах из жизни бизнеса — и даём шаблон ТЗ на интеграцию.
API — это договорённость между программами
API (application programming interface) — набор правил, по которым одна программа просит другую что-то сделать или отдать данные. Как меню в ресторане: вы не идёте на кухню, а выбираете из списка блюд и получаете то, что заказали. Программа тоже не лезет во внутренности другой — она отправляет запрос из разрешённого списка и получает ответ.
Сайт → CRM
сайт отправляет заявку в CRM, и в ней появляется сделка
Банк → учёт
выписка приходит в бухгалтерскую программу без ручной загрузки
CRM → 1С
выигранная сделка создаёт счёт в учёте
Мессенджер → CRM
сообщение клиента попадает в карточку контакта
Как выглядит запрос
REST — самый распространённый стиль таких API: у каждого объекта свой адрес, а действие задаётся методом. Когда разработчик говорит «у сервиса есть REST API», это значит, что к нему можно подключиться обычными запросами по интернету.
Ключи и токены: кто имеет право
Чтобы чужой не прочитал ваши данные, API пускает только с ключом или токеном — это как пропуск. Ключ обычно выдаётся один раз и действует долго; токен — временный, его регулярно обновляют. Многие сервисы, в том числе amoCRM, используют OAuth 2.0: пользователь один раз разрешает приложению доступ, а приложение получает токены и обновляет их само.
Главное правило: ключ — это пароль. Его не пересылают в чатах, не вставляют в код на сайте и не отдают подрядчику без нужды. Если ключ утёк — его отзывают и выпускают новый.
Лимиты: почему «нельзя выгрузить всё за секунду»
У любого API есть ограничение на число запросов. В amoCRM — не более 7 запросов в секунду на одну интеграцию и до 50 на весь аккаунт; подробно о возможностях и ограничениях — в статье «API amoCRM». Поэтому хорошая интеграция отправляет данные пачками, повторяет запрос при временной ошибке и не «кладёт» аккаунт при выгрузке тысяч записей.
Вебхук — когда программа сама сообщает о событии
Обычный запрос — это «спросить»: интеграция раз в минуту спрашивает, нет ли новых сделок. Вебхук — это «сообщить»: CRM сама отправляет уведомление на адрес интеграции, как только сделка изменилась. Так быстрее и экономнее — подробно в статье «Вебхук: что это простыми словами».
Когда нужна интеграция по API
Перенос руками
менеджер переписывает данные из одной системы в другую — больше 30 минут в день
Ошибки
опечатки в суммах и телефонах при переносе, потерянные заявки
Задержка
клиент ждёт, пока данные дойдут до нужного человека
Нет готового решения
в маркете нет виджета под вашу связку систем
Сначала стоит поискать готовое: для amoCRM многие задачи решают виджеты. Когда готового нет или его мало, пишут свою интеграцию — когда это оправдано, в статье «Разработка по API: когда готового виджета мало».
Как поставить задачу: шаблон ТЗ
Хорошее ТЗ на интеграцию отвечает на семь вопросов: зачем она нужна и что сейчас делается руками; какие системы и доступы; что, откуда, куда и когда передаём; какое поле чему соответствует; что делать при ошибке и кому сообщать; как проверяем результат; кто отвечает и к какому сроку. С таким ТЗ оценка точнее, а сюрпризов на приёмке меньше.
Скачать шаблон ТЗ на интеграцию · docx, 10 КБ
Интеграция amoCRM по API — с нами
Мы пишем интеграции и доработки для amoCRM по API: связь с сайтом, 1С, складом, платёжными системами, свои сценарии в виджетах. Работаем по часам: 4 000 ₽ в час; скидка возможна — индивидуально, в зависимости от объёма работ. До начала работы называем вилку по часам на вашу задачу и выставляем счёт в её рамках.
Сколько стоит типовая интеграция и из чего складывается цена — в статье «Интеграция amoCRM: цена разработки по API».
API — правила, по которым программы обмениваются данными: запрос с адресом, методом и данными, ответ с кодом. Доступ — по ключу или токену, у запросов есть лимиты, а вебхук позволяет сервису самому сообщать о событиях. Перед интеграцией полезно описать задачу в ТЗ: что, откуда, куда, когда и что делать при ошибке.
Частые вопросы
Converssion CRM — официальный партнёр amoCRM с 2017 года. Внедряем и сопровождаем amoCRM, делаем собственные виджеты для амоМаркета, чат-ботов, ИИ-агентов, сайты и рекламу. Услуги · Кейсы клиентов · Виджеты
