amoCRM

amoCRM — облачная CRM для продаж. Блок ходит в REST API v4: читает и меняет сделки, контакты, задачи и примечания. Для стабильной работы нужен долгосрочный токен приватной интеграции и поддомен аккаунта.

С amoCRM в Pailot вы можете:

• Получать список сделок — поиск, фильтр по воронке, постраничный вывод
• Создавать и обновлять сделки — название, бюджет, воронка, этап, ответственный, пользовательские поля (JSON)
• Работать с контактами — список с поиском, создание с телефоном и email
• Создавать задачи — текст, дедлайн (Unix), тип (звонок / встреча / письмо), привязка к сделке, контакту или компании
• Добавлять примечания — к сделке, контакту или компании

Интеграция поддерживает триггер по вебхуку amoCRM (вебхук — входящий HTTP-запрос от сервиса): процесс запускается при выбранных событиях, если в amoCRM указан URL из блока.

Как подключить

1. В amoCRM откройте Настройки → Интеграции и создайте интеграцию (или используйте существующую).
2. Создайте приватную интеграцию, откройте вкладку Ключи и доступы и выпустите долгосрочный токен. Используйте именно его: обычный OAuth access token (вход по разрешению сервиса) живёт около 24 часов, и блок его не обновляет — поток обновления токена в Pailot не реализован, поэтому на коротком токене интеграция отвалится через сутки.
3. В блоке укажите Поддомен — часть адреса до .amocrm.ru (для mycompany.amocrm.ru это mycompany).
4. Вставьте токен в поле Access token блока.

Триггер (вебхук)

1. Включите режим Триггер у блока и сохраните настройки.
2. Скопируйте сгенерированный URL вебхука.
3. В amoCRM: Настройки → Интеграции → Вебхуки — добавьте URL и отметьте нужные события (add_lead, update_lead, status_lead, add_contact и другие).

Что приходит в выходы триггера. amoCRM шлёт тело формой (x-www-form-urlencoded) со скобочными ключами вида leads[add][0][id]; Pailot разворачивает их в объекты, поэтому leads, contacts, tasks и account приходят готовыми структурами. Обращаться к полям можно как <Триггер.leads.add[0].id>.

Поля event amoCRM не присылает: действие закодировано во вложенности ключей. Pailot выводит имя события сам — leads[add] даёт add_lead, leads[status] даёт status_lead, task[add] даёт add_task. Имена у провайдера несимметричны: сделки — leads во множественном числе, задачи — task в единственном.

Документация API: справочник, вебхуки.

Инструменты

amocrm_get_leads

Список сделок с опциональным поиском и фильтром по воронке.

Выход: total, items (массив сделок), message.

amocrm_create_lead

Создание сделки.

Выход: id, name, message.

amocrm_update_lead

Обновление сделки по ID. Остальные поля — как при создании, частичное обновление.

Выход: id, name, message.

amocrm_get_contacts

Список контактов: query, limit, page. Выход: total, items, message.

amocrm_create_contact

Создание контакта (имя, телефон, email; доп. поля через JSON). Выход: id, name, message.

amocrm_create_task

Выход: id, text, message.

amocrm_add_note

Выход: id, entityType, entityId, message.