Справочник аккаунта amoCRM/Kommo: account (название, поддомен, валюта), users (id, name, email, active) и pipelines со statuses (id, name, type: open/won/lost). Вызывайте первым в разговоре: id воронок, этапов и менеджеров нужны фильтрам crm_search_leads, crm_tasks, crm_pipeline_report и записи в crm_create_lead / crm_update_lead. Результат кэшируется на 10 минут, повторно вызывать не нужно. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.

Ищет сделки по тексту (название, телефон, e-mail, значения полей) и фильтрам: воронка, этап, ответственный, период создания. Возвращает count, total_budget и leads (id, name, price, pipeline, status, responsible, даты, tags, contact_ids, custom_fields), свежие изменения первыми. Используйте, чтобы найти сделку или список сделок; полная карточка с контактами и задачами — crm_get_lead, агрегированная аналитика — crm_pipeline_report, зависшие сделки — crm_stale_leads. Этап фильтруется только вместе с pipeline_id (иначе ошибка). Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.

Полная карточка одной сделки по id: всё из crm_search_leads плюс contacts (телефоны, e-mail, доп. поля, is_main), company, open_tasks (со сроком и флагом overdue) и последние notes (текст, автор, дата). Используйте перед звонком или письмом клиенту, чтобы понять историю; id берите из crm_search_leads или crm_find_contact. Несуществующий id вернёт ошибку «не найдена». Делает 3–5 запросов к API. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.

Создаёт сделку одним запросом вместе с новым контактом (имя, телефон, e-mail), компанией и тегами; при note добавляет примечание. Без pipeline_id/status_id сделка встаёт в первый этап основной воронки; id бери из crm_account. amoCRM может склеить контакт с существующим — тогда merged_with_existing=true. Возвращает lead_id, contact_id, company_id. Чтобы изменить уже существующую сделку, используйте crm_update_lead; не создавайте дубль — сначала проверьте crm_find_contact. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.

Частично обновляет существующую сделку: передавайте только поля, которые меняются. Перевод по воронке — status_id (+ pipeline_id при смене воронки), закрыть успешно — status_id 142, проиграно — 143; tags заменяют весь набор тегов; custom_fields — [{field_id, value}]. Возвращает updated и список changed. Без изменяемых полей — ошибка. Новую сделку создаёт crm_create_lead, примечание — crm_add_note. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.

Ищет контакты по имени, телефону (в любом формате) или e-mail — например при входящем звонке или письме. Возвращает contacts: id, name, phones, emails, responsible, lead_ids (связанные сделки), company_ids, custom_fields. Дальше откройте сделку через crm_get_lead; искать сами сделки удобнее crm_search_leads. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.

Добавляет обычное текстовое примечание в ленту сделки, контакта или компании: итог звонка, договорённости, комментарий. Не меняет поля сущности (для этого crm_update_lead) и не ставит задач (crm_create_task). Возвращает note_id. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.

Незавершённые задачи: scope=open — все, overdue — просроченные, today — со сроком до конца сегодняшнего дня; фильтры по ответственному и по сделке. Возвращает count и tasks (id, text, due, overdue, responsible, entity_type, entity_id), ближайшие сроки первыми. Используйте для «что просрочено у менеджера» и планирования дня; поставить задачу — crm_create_task, закрыть — crm_complete_task. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.

Ставит задачу со сроком: звонок или встреча, привязанная к сделке, контакту или компании (или без привязки), с ответственным. Дата без времени означает 18:00 по часовому поясу сервера; для точного времени передайте ISO с зоной, например 2026-10-01T11:00:00+03:00. Возвращает task_id и due. Закрыть задачу — crm_complete_task, посмотреть задачи — crm_tasks. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.

Закрывает задачу по id с текстом результата (например «Дозвонился, отправил КП»); результат виден в ленте сделки. id берите из crm_tasks или crm_get_lead. Закрытую задачу этим инструментом не открыть. Возвращает completed. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.

Аналитика отдела продаж по одной воронке для сделок, созданных за период (по умолчанию 30 дней): stages (сделки и бюджет по этапам), won/lost/open, win_rate_pct (успешные / закрытые), avg_deal, avg_cycle_days (от создания до успеха) и managers — рейтинг менеджеров по выигранному бюджету. Используйте для «как идут продажи», «кто лучше закрывает», сравнения месяцев; конкретные сделки ищите crm_search_leads, проблемные — crm_stale_leads. Загружает до max_leads сделок (truncated=true, если упёрлись), на больших периодах может занять десятки секунд. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.

Открытые сделки под риском: без изменений days+ дней, без запланированной задачи или с просроченной задачей. Возвращает count, at_risk_budget и leads (id, name, price, stage, pipeline, responsible, idle_days, reasons), сначала самые дорогие. Используйте для «что зависло», ежедневной ревизии воронки и напоминаний менеджерам; общая картина — crm_pipeline_report, задачи — crm_tasks. Смотрит до 3000 открытых сделок. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.