amoCRM и интеграции
API простыми словами: что это и что спросить у подрядчика
Разбираем, что стоит за фразой «подключим по API», как выглядят запрос и ответ и какие вопросы задать до начала работ.
Коротко: API простыми словами — это правила, по которым одна программа обращается к другой без участия человека: отправляет запрос и получает ответ. Так заявка с сайта сама попадает в CRM, и менеджеру не приходится переносить её вручную. Фраза «подключим по API» означает работу разработчика, поэтому заранее выясните, есть ли доступ на вашем тарифе, какие действуют лимиты, сколько живут ключи и кто будет поддерживать связку.
Что такое API простыми словами
API (Application Programming Interface, программный интерфейс приложения) — это возможности и правила внутри программы, через которые с ней работают другие программы. MDN, справочник для веб-разработчиков, предлагает считать API простым контрактом между приложением и внешними программами или устройствами (в переводе). Человек управляет сервисом кнопками на экране, а программе для того же нужен API.
Помогает сравнение со складом. Посторонних внутрь не пускают, зато у стойки выдачи можно подать заполненный бланк, показать пропуск и получить товар или ответ, почему отказали. Бланк здесь похож на формат запроса, пропуск — на ключ доступа, а что происходит на полках, заказчику знать незачем.
Условный пример: на созвоне маркетолог спрашивает, как заявки с сайта окажутся в CRM, и слышит: «Подключим по API». За этой фразой стоит работа: разработчик по правилам CRM настраивает обмен между двумя программами, а потом кто-то следит, чтобы обмен не остановился.
Зачем API бизнесу и чем он отличается от интеграции
API нужен бизнесу, чтобы программы обменивались данными без ручного переноса. В документации Битрикс24 это описано так: программа шлёт запрос к методу, команде вроде «создать сделку», система выполняет её и возвращает результат. Такая связка создаёт сделки из заявок с сайта. Через API Яндекс Метрики управляют счётчиками без веб-интерфейса, получают отчёты и передают данные о расходах, заказах из CRM и звонках.
Слова «API» и «интеграция» легко спутать, и тогда неясно, за что платить подрядчику. Удобно считать API средством, которое даёт сервис, а интеграцию результатом, который на нём построили. amoCRM называет интеграцией любое взаимодействие сторонней системы с ней, а Битрикс24 — программу, которая работает через его API. Поэтому в смете подрядчика проверьте, отдельно ли названы разработка, настройка, проверка и поддержка такой связки.
API нужен не всегда. Если у сервиса есть готовая интеграция с вашей CRM, своя разработка может не понадобиться. Допустим, отдел раз в месяц сводит отчёт из двух таблиц: выгрузка вручную может выйти дешевле, чем разработка и поддержка обмена.
Как выглядят запрос и ответ: условный пример
Запрос и ответ выглядят как несколько строк текста: программа отправляет запрос, сервер возвращает ответ. Допустим, сайт магазина шин передаёт заявку в условную CRM. В запросе указаны действие, адрес, ключ доступа и сами данные в JSON, текстовом формате обмена:
POST /leads HTTP/1.1
Host: crm.example.com
Authorization: Bearer ключ_доступа
{"name": "Заявка с сайта", "phone": "+7 000 000-00-00"}Условная CRM создала запись и ответила так:
HTTP/1.1 201 Created
{"id": 1042, "status": "new"}Слово POST значит, что программа передаёт данные, а GET служит для чтения. Число 201 называют кодом ответа. Коды делятся на пять групп, и руководителю они подсказывают, к кому идти со сбоем.
| Код | Что значит | Кто обычно разбирается |
|---|---|---|
| 200, 201 | запрос успешен, при 201 создан новый объект | сбоя нет: сверяют результат в самой CRM |
| 400 | сервер не обрабатывает запрос из-за ошибки отправителя | подрядчик проверяет отправленные данные |
| 401 | нет действительных учётных данных, например ключа | подрядчик проверяет ключ и его срок |
| 403 | сервер понял запрос и отказал, обычно дело в правах | подрядчик проверяет права и состояние аккаунта |
| 404 | объект не найден, причём в API адрес может быть верным | подрядчик сверяет адрес и номер объекта |
| 429 | слишком много запросов за период | подрядчик снижает частоту и ждёт |
| 500, 503 | непредвиденная ошибка сервера, при 503 он не готов обработать запрос, обычно из-за обслуживания или перегрузки | поддержка сервиса, если сбой повторяется позже |
Значения кодов общие, а правила у каждого сервиса свои. На добавление сделок amoCRM отвечает 200, хотя для созданного объекта типичен 201. Слишком частые запросы в amoCRM и Метрике дают 429, а в облачном Битрикс24 — 503 с пометкой QUERY_LIMIT_EXCEEDED. Поэтому ответы сервиса сверяют с его собственной документацией.
Что такое REST API и при чём здесь вебхук
REST API в обычном разговоре значит веб-сервис, с которым программы говорят запросами и ответами. Строго говоря, REST — это набор требований к устройству сервиса, архитектурный стиль, который описал Рой Филдинг в диссертации 2000 года. MDN оговаривается, что так иногда зовут любой API на HTTP, протоколе обмена в вебе, даже если соблюдены не все требования.
Пример ближе к сайту: в REST API WordPress запрос GET к wp-json/wp/v2/posts отдаёт список записей, а POST с авторизацией создаёт новую. На выбор руководителя слово REST почти не влияет: договариваться всё равно придётся о доступе, лимитах и ключах.
От вебхука API отличается тем, кто начинает разговор: к API программа обращается сама, когда ей нужны данные, а вебхук, автоматический запрос о событии, сервис присылает по мере появления данных.
Что спросить у подрядчика или сервиса до интеграции
Спросите о тарифе, лимитах, сроке ключей, владельце аккаунта, поддержке сервиса, окончании подписки и сопровождении.
- Тариф. Есть ли API на нашем тарифе? Бывает, что он доступен не на всех: у Tilda, например, только на тарифе Business.
- Лимиты. Хватит ли их на наш поток данных? amoCRM допускает до 7 запросов в секунду на интеграцию и до 50 на аккаунт, а при многократном превышении отвечает 403 на любой запрос. Tilda ставит предел 150 запросов в час и запрещает обращаться к своему серверу при каждом заходе посетителя.
- Срок ключа. Кто и когда обновляет ключ доступа, он же токен? В amoCRM Access-токен, рабочий ключ, живёт сутки, а Refresh-токен для его обновления — три месяца: если связка простоит три месяца, доступ придётся выдавать заново. Долгосрочный токен действует от 1 дня до 5 лет, срок выбирают при создании.
- Аккаунт. В чьём аккаунте создадут интеграцию? В amoCRM она закрепляется за аккаунтом, и любой его администратор получает доступ к её общим ключам. Решите заранее, что станет с этим доступом после ухода подрядчика.
- Поддержка сервиса. Какой тип интеграции вы делаете? При приватной интеграции, доработке под одну компанию, клиент на обычном, нетехническом аккаунте заполняет заявление на отказ от техподдержки amoCRM. Обращения по ошибкам системы она на этом аккаунте не примет, хотя консультаций и вопросов по оплате это не касается. Отозвать заявление нельзя.
- Подписка. Что будет, когда она закончится? В amoCRM запись через API закрывается сразу, доступ к данным — через 30 дней, а сервер отвечает кодом 402.
- Сопровождение. Кто заметит, что обмен остановился, и кто его починит? Условный пример: в пятницу вечером истёк ключ, а в понедельник менеджер видит, что заявок с сайта в CRM нет с пятницы. Запишите ответ в договор.
Принимайте работу на тестовой заявке с вымышленными данными. Пусть подрядчик проведёт её от сайта до CRM, а затем покажет, как связка ведёт себя с неверным ключом и кто об этом узнает.
Как обращаться с ключами, доступами и данными клиентов
Обращайтесь с ключом доступа как с паролем. RFC 6750, стандарт для таких токенов, описывает их как данные, которыми может воспользоваться любой их обладатель (в переводе). Названия у сервисов разные: amoCRM говорит о токенах и client_secret, Tilda о publickey и secretkey, а во входящем вебхуке Битрикс24 секретный код стоит прямо в адресе.
- Права. Выбирайте минимум прав и короткий срок токена, как советует GitHub, сервис для хранения кода. В amoCRM токен имеет права пользователя, который дал доступ, поэтому заранее посмотрите, что этому пользователю разрешено.
- Передача. Тот же GitHub просит: не отправляйте ключи без шифрования почтой или мессенджером и не вписывайте их в код. Токен не передают в адресах страниц: адрес может остаться в истории браузера и журналах сервера.
- Хранение. Держите токены и
client_secretв безопасном хранилище, как требует amoCRM. Яндекс не рекомендует хранить токен в браузере и открытых конфигурационных файлах. - Утечка. Порядок у GitHub такой: выпустить новый ключ, заменить его везде, удалить старый. В amoCRM сначала обновляют
client_secret, затем токены. - Отзыв. Когда работа закончена, закройте лишние доступы: долгосрочный токен amoCRM отзывают на вкладке «Выданные доступы» кнопкой «Отозвать доступ».
Если через API идут имена и телефоны клиентов, учитывайте Федеральный закон от 27.07.2006 № 152-ФЗ в редакции от 26.07.2026. Персональные данные в нём — «любая информация, относящаяся к прямо или косвенно определенному или определяемому физическому лицу» (п. 1 ст. 3), а передача входит в обработку (п. 3 ст. 3).
Оператором закон называет того, кто организует или ведёт обработку и определяет её цели, состав данных и действия с ними (п. 2 ст. 3). Оператор вправе поручить обработку другому лицу с согласия человека, чьи это данные, если иное не предусмотрено федеральным законом, на основании договора (ч. 3 ст. 6). Защищать данные от неправомерного доступа он обязан правовыми, организационными и техническими мерами (ч. 1 ст. 19). Заранее решите, какие поля нужны в обмене. Относится ли норма о поручении к вашему подрядчику и как оформить документы, сверьте с юристом.
Как это устроено в чате Мигом
Связать чат Мигом с CRM, сервисом поддержки или внутренними инструментами можно через API и вебхуки: передавать обращения, сообщения и историю переписки. Для разработчиков есть REST API и история переписки, вебхуки с подписью и повторами, JS API виджета с типами TypeScript. На любом тарифе доступны API, вебхуки и свой интерфейс: чат в дизайне вашего сайта на API Мигом. Основная интеграция чата Мигом — amoCRM. Посмотреть, как команда работает с чатом, можно на главной.
Сразу честно: готового подключения к каждой CRM не обещают. Способ зависит от возможностей вашей системы и подбирается вместе с вами.
Итог. API даёт программам общие правила обмена данными, а «подключим по API» означает разработку и её поддержку. Перед договором получите от подрядчика ответы на семь вопросов. Работу примите на тестовой заявке с вымышленными данными, а ключи держите под контролем.
FAQ
Нужен ли программист, чтобы подключить API?
Обычно да: запросы, обработку ошибок и обновление ключей настраивает разработчик. Если готовая интеграция сервиса с вашей системой уже есть, программист может не понадобиться.
Что лучше: API или вебхук?
Зависит от задачи. Вебхук сообщает о событии почти сразу, а через API удобно запрашивать данные, которые нужны разово или время от времени.
Можно ли переслать ключ подрядчику в мессенджере?
Лучше так не делать. Если сервис позволяет, выдайте подрядчику отдельный доступ с нужными правами: его проще отозвать после работы. Если ключ нужен команде, GitHub советует держать его в защищённом общем хранилище.
Почему связка по API вдруг перестала работать?
Обычно проверяют три вещи: срок ключа, оплату сервиса и лимиты. Подсказку даёт код ответа: 401 указывает на учётные данные, 402 в amoCRM — на окончание подписки, 429 — на превышение лимита.
Источники
- API — глоссарий MDN, по состоянию на 05.11.2026
- REST — глоссарий MDN, по состоянию на 05.11.2026
- Обзор протокола HTTP — MDN, по состоянию на 05.11.2026
- HTTP request methods — MDN, по состоянию на 05.11.2026
- HTTP response status codes — MDN, по состоянию на 05.11.2026
- Коды состояния ответа HTTP — MDN, по состоянию на 05.11.2026
- 401 Unauthorized — MDN, по состоянию на 05.11.2026
- 403 Forbidden — MDN, по состоянию на 05.11.2026
- 429 Too Many Requests — MDN, по состоянию на 05.11.2026
- 500 Internal Server Error — MDN, по состоянию на 05.11.2026
- RFC 8259. The JavaScript Object Notation (JSON) Data Interchange Format — IETF, по состоянию на 05.11.2026
- RFC 6750. The OAuth 2.0 Authorization Framework: Bearer Token Usage — IETF, по состоянию на 05.11.2026
- RFC 9110. HTTP Semantics — IETF, по состоянию на 05.11.2026
- Representational State Transfer (REST) — диссертация Роя Филдинга, глава 5, по состоянию на 05.11.2026
- Возможности — документация amoCRM, по состоянию на 05.11.2026
- Сделки — документация amoCRM, по состоянию на 05.11.2026
- Ограничения и рекомендации — документация amoCRM, по состоянию на 05.11.2026
- oAuth 2.0 — документация amoCRM, по состоянию на 05.11.2026
- Пример по шагам — документация amoCRM, по состоянию на 05.11.2026
- Начало работы — документация amoCRM, по состоянию на 05.11.2026
- С чего начать — документация REST API Битрикс24, по состоянию на 05.11.2026
- Лимиты REST API — документация Битрикс24, по состоянию на 05.11.2026
- API Яндекс Метрики — документация Яндекс Метрики, по состоянию на 05.11.2026
- Квотирование — документация Яндекс Метрики, по состоянию на 05.11.2026
- Обновление токена — документация Яндекс ID, по состоянию на 05.11.2026
- API — справка Tilda, по состоянию на 05.11.2026
- Key Concepts — документация WordPress REST API, по состоянию на 05.11.2026
- About webhooks — документация GitHub, по состоянию на 05.11.2026
- Keeping your API credentials secure — документация GitHub, по состоянию на 05.11.2026
- Федеральный закон от 27.07.2006 № 152-ФЗ «О персональных данных» — КонсультантПлюс, ред. от 26.07.2026, по состоянию на 05.11.2026
- Федеральный закон от 27.07.2006 № 152-ФЗ, ст. 3 — КонсультантПлюс, ред. от 26.07.2026, по состоянию на 05.11.2026
- Федеральный закон от 27.07.2006 № 152-ФЗ, ст. 6 — КонсультантПлюс, ред. от 26.07.2026, по состоянию на 05.11.2026
- Федеральный закон от 27.07.2006 № 152-ФЗ, ст. 19 — КонсультантПлюс, ред. от 26.07.2026, по состоянию на 05.11.2026
- Мигом — по состоянию на 05.11.2026