AI-черновик — шаблон из доки партнёра

Вставь то, что прислал партнёр, и получи заполненную интеграцию. Что делает, чего не трогает и что проверить.

Собирать шаблон руками — это читать API-доку партнёра и переносить значения примерно в двадцать полей. AI-черновик читает за тебя: вставляешь то, что прислал партнёр, жмёшь кнопку — форма возвращается заполненной, тебе остаётся проверить. Входит в лицензию, настраивать и подключать ничего не нужно.

Вставляй больше, а не меньше

Самая частая причина полупустого черновика — вставили слишком мало. Он читает только то, что в поле: не открывает ссылки, не заходит в кабинет партнёра и не догадывается о странице, которую ты не приложил.

Поэтому вставляй всё, что тебе дали, целиком: эндпоинт отправки, эндпоинт статусов или депозитов, список колл-статусов и примеры ответов. Целая страница доки, экспорт из Postman или сырой дамп cURL — всё годится. Приводить в порядок не нужно, и разбираться, какие куски важны, тоже — это как раз та работа, которую он делает за тебя.

Что стоит знать: партнёры почти всегда описывают отправку сверху, а статусы и депозиты — сильно ниже. Скопируешь только первый экран — получишь шаблон, который лиды отправляет, но статусы назад не тянет.

Что возвращается

Черновик, а не сохранённая интеграция. Ничего не записывается, пока ты не нажмёшь Apply и потом Save, и трафик не пойдёт, пока кампания не привязана к потоку. Получаешь транспорт, способ авторизации, маппинг полей, пути ответа и — если это описано в доке — пул статусов и их маппинг.

Всё, что определить не удалось, собрано в списке «Please provide». Это не провал, а честный перечень того, что может сказать только партнёр: выданный им affiliate id, недокументированный формат ответа, отсутствующий список статусов. Считай это своим списком дел перед запуском.

Секреты он не заполняет никогда

API-ключи, токены и пароли намеренно не переносятся, даже если в примерах партнёра стоят похожие на настоящие значения. Черновик называет заголовок или поле, куда секрет кладётся, а само значение ты вставляешь на странице партнёра. Именно это позволяет одному шаблону обслуживать многих партнёров: рецепт общий, доступы — нет.

Проверь каждое поле перед сохранением

Черновик — быстрый первый проход тем, кто прочитал твой текст, а не проверенная интеграция. Когда CRM пишет, что черновик валиден, это значит, что структура прошла наши проверки, — но не что значения совпадают с докой партнёра. Неверный путь не выдаёт ошибку: он тихо ломается на живом трафике. Пройдись по доке:

Потом жми «Send a test». Он прогонит один пробный лид по реальному конфигу и покажет запрос, сырой ответ партнёра и что из него распарсилось. Две минуты здесь стоят больше любого перечитывания.

Лимиты

Черновики считаются по лицензии — несколько в минуту и суточный лимит, чтобы один зациклившийся клиент не сжёг общий бюджет. На обычную интеграцию уходит два-пять черновиков, так что упереться в лимит трудно. Если упрёшься — об этом будет сказано прямо, а лимит обнуляется в полночь UTC.

Когда получается плохо

Если API партнёра делает что-то совсем нестандартное — пришли нам их доку, поможем смапить.