Расширяйте возможности с API

Мы стараемся предоставить максимальные возможности для интеграции amoCRM с другими сервисами и системами, чтобы вы, наши клиенты и партнеры, могли расширить возможности amoCRM для себя и других наших и ваших пользователей.

Написание собственных виджетов и интеграций не так сложно, как может показаться на первый взгляд. Для того, чтобы еще больше облегчить жизнь разработчику, кроме инструкций, мы приводим примеры использования методов, их описание.

Также вы можете воспользоваться консолью и пробовать работать с нашим API. (Консоль станет доступна в ноябре 2017).

Что такое виджет?

Если вам необходимо просто обмениваться данными между amoCRM и внешней системой, то вы можете использовать REST API. Через него вы можете удаленно получать, добавлять и обновлять данные в amoCRM.

В случае, если ваше решение должно быть доступно всем клиентам amoCRM или вам необходимо подключить JS и взаимодействовать с пользователем в браузере, дополнять интерфейсы системы, то все эти возможности есть в системе виджетов.

Виджет - это набор настроек, JS и PHP-файлов, которые могут быть подключены в любой аккаунт amoCRM, через включение виджета клиентом.

Текущий механизм виджетов в будущем будет признан устаревшим. Новый формат виджетов и интеграций будет описан в ближайшее время в документации. Принцип взаимодействия принципиально не изменится, но появятся новые возможности.

Примеры использования виджетов из жизни

  • Я хочу вывести дополнительную информацию о контакте (в карточке контакта) из моей внутренней учетной системы;
  • Я хочу, чтобы сотрудники моей компании могли отправлять запрос в бухгалтерию на формирование платежки непосредственно из карточки сделки;
  • Я являюсь разработчиком стороннего сервиса (телефонии, email-рассылок) и хочу предоставить клиентам amoCRM возможность использовать мой сервис, опубликовав публичный виджет и сделав интеграцию прозрачнее и проще.

Словарь amoCRM

Термин Значение
Виджет/Add-on Дополнение к системе, которое может быть включено и настроено пользователем для своего аккаунта с целью расширения функций amoCRM. Может содержать JS-файл, файл настроек, php-файл, изображения, шаблоны используемые в работе дополнения.
Языки/Локализация amoCRM переведена на три языка: английский/испанский (amocrm.com) и русский (amocrm.ru). Вы можете публиковать виджеты на трех языках явно указав это в манифесте. Не забудьте также сделать перевод и учесть формат времени. Новый формат виджетов не будет поддерживать множественную локализацию и вам необходимо будет делать несколько виджетов, если вы хотите использовать разные локализации.
Манифест/manifest.json Файл, загружаемый вместе с виджетом, содержащий описание и настройки виджета
Настройки виджета При установке некоторые виджеты требуют ввода настроек, к примеру, название аккаунта во внешней системе, параметры авторизации в ней, настройки полей и т.д.
Аккаунт Учетная запись компании в amoCRM, имеющая собственные платежные реквизиты, биллинговую информацию, собственные данные и список пользователей, которым разрешен доступ к этим данным. Каждый аккаунт имеет свой субдомен в системе, например, company.amocrm.ru