Интеграция · amoCRM · Рубли

AI API для
amoCRM

Подключите нейросеть к amoCRM через вебхуки и Digital Pipeline / Salesbot плюс ваш backend. Бот квалифицирует сделки, ставит теги и подсказывает менеджеру, а вы платите в рублях — без VPN.

Вебхуки / Salesbot REST /api/v4/leads Без VPN на сервере
GROWMI / AMOCRM LIVE
Квалифиц. сделок
128
Авто-тегов сегодня
412
Лимит на ключ
5000
Расход
214
WEBHOOK: OKVPN: НЕ НУЖЕН
Что можно сделать в amoCRM

От квалификации сделок до резюме звонков

Скоринг

Квалификация сделок

AI читает первичную заявку и поля сделки, оценивает горячесть и проставляет балл квалификации.

Воронка

Авто-теги и распределение

Размечает сделку тегами и подсказывает этап Digital Pipeline для распределения по воронке.

Менеджеру

Подсказки и ответы

Готовит вариант ответа клиенту и следующий шаг — менеджер отправляет одним кликом.

Аналитика

Резюме переписки и звонков

Краткое резюме диалога и расшифровки звонка прямо в примечании к сделке.

Архитектура

Вебхук amoCRM → backend → AI API → REST

amoCRM не ходит в модель напрямую. Между ними — ваш backend: он принимает событие сделки, вызывает AI API, а затем обновляет сделку через REST API amoCRM.

01

Событие amoCRM

Вебхук на изменение сделки или шаг Digital Pipeline / Salesbot отправляет данные на ваш URL.

02

Ваш backend

Парсит form-data, фильтрует тип события, собирает контекст сделки и системный промпт.

03

AI API GROWMI

Запрос на российский эндпоинт с base_url и ключом — ответ модели в рублях.

04

Обновление сделки

PATCH /api/v4/leads с долгоживущим токеном: теги, поля и статус по ответу модели.

Пример на Node.js / TypeScript

Вебхук сделки → AI → PATCH в amoCRM

Express принимает вебхук amoCRM (form-urlencoded), OpenAI SDK обращается к GROWMI, а затем backend обновляет сделку через /api/v4/leads.

import express from "express";
import OpenAI from "openai";

const app = express();
app.use(express.urlencoded({ extended: true })); // amoCRM шлёт form-urlencoded

const ai = new OpenAI({
  baseURL: "https://api.growmi.ru/v1",
  apiKey: process.env.GROWMI_KEY!,
});

app.post("/amo/hook", async (req, res) => {
  res.sendStatus(200);                  // сразу 200, чтобы amoCRM не ретраил
  const lead = req.body?.leads?.update?.[0];
  if (!lead) return;                       // фильтр по типу события

  const r = await ai.chat.completions.create({
    model: "gpt",
    max_tokens: 400,                       // потолок ответа = контроль расхода
    messages: [
      { role: "system", content: SYSTEM_PROMPT },
      { role: "user", content: `Сделка: ${lead.name}. Бюджет: ${lead.price}` },
    ],
  });
  const tag = r.choices[0].message.content ?? "новый";

  await fetch(`https://${process.env.AMO_DOMAIN}/api/v4/leads`, {
    method: "PATCH",
    headers: {
      "Authorization": `Bearer ${process.env.AMO_TOKEN}`, // долгоживущий токен
      "Content-Type": "application/json",
    },
    body: JSON.stringify([{ id: Number(lead.id), _embedded: { tags: [{ name: tag }] } }]),
  });
});

app.listen(3000);
Как ограничить расходы

Три рычага против неожиданного счёта

Лимит на ключ

Месячный потолок расхода в кабинете GROWMI. Дошли до лимита — запросы останавливаются, интеграция не уходит в минус.

Лимит на сделку

В backend ограничьте число вызовов AI на одну сделку (lead_id), чтобы повторные вебхуки не множили запросы.

max_tokens

Ограничение длины ответа модели. Для тега или короткого резюме хватит 200–400 токенов — это дешевле и быстрее.

Частые ошибки

Что чаще всего ломает интеграцию

Симптом

Сделки не обновляются

  • Вебхук amoCRM приходит как form-urlencoded, а backend ждёт JSON
  • Токен интеграции / долгоживущий токен истёк → 401 на /api/v4
  • Повторные вебхуки на каждое изменение → дубли вызовов и счёт
  • Долгий ответ модели до отдачи 200 → amoCRM ретраит вебхук
Решение

Что сделать

  • Парсить form-data (express.urlencoded), читать leads[update]
  • Обновлять access_token по refresh заранее, до истечения
  • Фильтровать по типу события + идемпотентность по lead_id
  • Сразу отдавать 200, AI-вызов выполнять асинхронно
FAQ

Вопросы по amoCRM

Подойдёт ли для облачной amoCRM?+

Да. Облачная amoCRM умеет слать вебхуки и работать через Digital Pipeline / Salesbot, а ваш backend обращается к amoCRM по REST API /api/v4 с долгоживущим токеном интеграции. Доступа к серверу amoCRM не требуется.

Нужен ли VPN серверу?+

Нет. Запросы к AI API идут на российский эндпоинт GROWMI, а amoCRM — российский сервис. VPN не нужен ни на сервере, ни в кабинете amoCRM.

В каком формате amoCRM шлёт вебхуки?+

amoCRM отправляет вебхуки в формате application/x-www-form-urlencoded с вложенными ключами вида leads[update][0][id], а не JSON. На backend нужно парсить form-data, а не разбирать тело как JSON.

Можно ли платить в рублях с документами для юрлица?+

Да. Оплата в рублях с карты или по счёту для юрлица с закрывающими документами. Иностранные карты и VPN не нужны.

Как избежать дублей при повторных вебхуках?+

amoCRM шлёт вебхук на каждое изменение сделки. Фильтруйте по типу события и храните последний обработанный lead_id + хэш изменения, чтобы обеспечить идемпотентность и не вызывать AI повторно.

Ранний доступ

Получите API-ключ для amoCRM

Оставьте email — пришлём ключ, тестовый баланс и готовый шаблон вебхука для amoCRM на Node.js.

Без спама — только запуск.
Читать дальше

Смежные страницы