Skip to main content
Glama

Сопоставление полей Битрикс24

manage_quiz_crm_mapping
Destructive

Сопоставление полей опроса с полями Bitrix24: «пусть телефон из опроса попадает в телефон лида». Задаётся по одной сущности за вызов — lead, contact, company или deal — и заменяет её целиком: чего в переданном наборе нет, того в сопоставлении не останется, остальные сущности вызов не трогает. Прежде чем править, посмотрите справочники и текущее сопоставление через get_quiz_crm_fields: имена полей берутся оттуда, а идентификаторы вопросов — из quiz://{id}/structure. Стадия принадлежит воронке, и несовместимую сохранить нельзя. amoCRM этим инструментом не настраивается: там сопоставление задаётся по воронкам, это manage_quiz_amocrm_mapping.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "quiz_id": "<quiz_id>",
      "entity": "<entity>"
    },
    "name": "manage_quiz_crm_mapping"
  }
}

Input Schema

NameRequiredDescriptionDefault
entityYesЧто настраиваем: lead — лид, contact — контакт, company — компания, deal — сделка.
fieldsNoСопоставление: ключ — имя поля Bitrix24 из справочника (TITLE, PHONE, UF_CRM_…), значение — откуда брать. Набор заменяется целиком.
statusNoСтатус лида (STATUS_ID) из справочника. Только для lead.
enabledNoОтправлять ли эту сущность вообще. Без неё сущность не создаётся. Незаданное значение остаётся прежним.
quiz_idYesID опроса.
title_typeNoОткуда берётся название: Field — из ответа на вопрос, Static — заданный текст.
category_idNoНомер воронки сделки. 0 — воронка по умолчанию. Только для deal.
title_valueNoСамо название: при Field это ID вопроса, при Static — текст. Если название собрать не удалось, Bitrix24 подставит «Lead #номер» или «Deal #номер».
link_to_leadNoПривязать сделку к созданному лиду. Только для deal.
default_stageNoСтадия сделки. У воронки по умолчанию не начинается с «C», у воронки N обязана начинаться с «CN:». Только для deal.
add_id_to_titleNoДописывать номер заявки в название. Только для lead.
company_title_valueNoТо же для названия компании. Для lead и company.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true and openWorldHint=true, but the description adds what the annotations cannot: the mapping is replaced wholesale ('чего в переданном наборе нет, того в сопоставлении не останется'), other entities are untouched, and incompatible stages cannot be persisted. It does not say what happens on a rejected stage, what the response contains, or whether partial failures are possible — the main remaining gap for a destructive multi-parameter mutation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and the example are front-loaded, then prerequisites, then the destructive-replacement caveat, then the sibling exclusion — a logical order with no filler sentences. It is dense and packs several rules into long clauses, but each sentence carries operative information for a 12-parameter destructive tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 12-parameter, nested-object, destructive mutation, the description covers scope isolation, replace-all semantics, prerequisite lookups, the stage/pipeline constraint and the amoCRM exclusion. Remaining gaps are error/response behavior and permission requirements, which matter somewhat since there is no output schema to fall back on.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the schema already explains entity enum values, the fields nested object, category_id/title_type semantics and the 'only for lead/deal' scoping, so the baseline is 3. The description does add value by tying field-name keys to the get_quiz_crm_fields reference and widget_id values to quiz://{id}/structure, but it does not give extra syntax or interaction detail (e.g. title_type/title_value coupling) beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence gives a concrete verb and resource ('сопоставление полей опроса с полями Bitrix24') plus a worked example ('пусть телефон из опроса попадает в телефон лида'). It then bounds the scope — one entity per call from an enumerated set — and names the sibling it is not (manage_quiz_amocrm_mapping), so an agent can distinguish it without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly instructs the agent to read get_quiz_crm_fields and quiz://{id}/structure before editing, states that field names and question IDs must come from those sources, and routes amoCRM configuration to manage_quiz_amocrm_mapping with the reason (per-pipeline mapping). It also states the one-entity-per-call constraint and the stage/pipeline compatibility rule.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources