Консоль
Интеграции

TwentyCRM

Настройка workspace TwentyCRM и маппинга полей для лидов от агентов

TwentyCRM подключается на уровне команды. Интеграция хранит workspace URL, API key, целевой объект, поле стадии и значение стадии, а также маппинг полей, которые Айва может заполнять.

Что понадобится

  • Workspace URL
  • bearer API key
  • имя целевого объекта, например clientFunnels
  • имя поля стадии, например stage
  • значение стадии, например NEW_LEAD

Как добавить интеграцию

  1. В Twenty откройте Settings -> API & Webhooks и создайте API key.
  2. В консоли Айва откройте Integrations -> TwentyCRM -> Добавить.
  3. Заполните Название, URL workspace, API key, Целевой объект, Поле стадии, Значение стадии.
  4. Сохраните запись.

Что сделать после сохранения

  • Откройте карточку интеграции и нажмите Обновить поля, чтобы Айва перечитала схему целевого объекта.
  • Включите только те поля Twenty, которые агент должен заполнять.
  • Для включенных полей добавьте инструкции, если LLM должна преобразовывать разговор в конкретный формат.
  • Нажмите Проверить интеграцию, если меняли URL, API key или схему целевого объекта.

Как назначить агенту

  1. Откройте агента.
  2. В секции интеграций выберите подготовленную запись TwentyCRM.
  3. Сохраните агента.

Маппинг полей настраивается внутри карточки интеграции. В редакторе агента вы только выбираете готовое подключение.

Безопасный пример

Title: Main sales funnel
Workspace URL: https://crm.example.com
API key: twenty-demo-key
Target object: clientFunnels
Stage field: stage
Stage value: NEW_LEAD

Если данные не уходят в Twenty

  • проверьте, что API key все еще действителен
  • убедитесь, что имя объекта и поле стадии совпадают с реальной схемой workspace
  • обновите каталог полей после изменений в Twenty