Экспорт контактов из YouGile: инструмент, который мы сделали сами 📢

Лайфхак для всех, кто работает в YouGile!
Мы столкнулись с проблемой, что в сервисе нет функции экспорта контактов и организаций из CRM. Нет кнопки, нет отчёта, поддержка отвечает, что фича в разработке. Зато есть API для сделок.

Мы написали инструмент, который закрывает эту дыру, и решили поделиться.

Это один HTML-файл, который открывается в браузере. Скачивать и устанавливать ничего не нужно.
Сделки выгружаются через официальный REST API v2 по вашему ключу. Справочник контактов официальным путём не отдаётся вообще, поэтому используются недокументированные методы, а на запасной случай есть букмарклет: он читает те же данные прямо с открытой страницы CRM, как будто вы сами прокручиваете таблицу и переписываете её в Excel, только автоматически.

Данные идут только между вами и ru.yougile.com.
Сторонних серверов нет.

Что нужно, чтобы запустить у себя
Интернет с доступом к ru.yougile.com.
Аккаунт YouGile с доступом к нужному CRM-проекту.
Наш HTML-файл.
Ключ получает права своего аккаунта, поэтому если CRM не видна в интерфейсе, выгрузка придёт пустой.

Свой ключ каждый получает его сам через «Нет ключа, получить по логину и паролю», пересылать ключи друг другу не нужно.
По ключу можно не только читать данные, но и удалить его или действовать от имени владельца. Для сотрудника без доступа к CRM проще завести отдельный аккаунт только с просмотром проекта и выдать ключ от него.

О чём предупредить коллег
Галочку «запомнить ключ» ставить только на своей машине.

При наличии ключа любой пользователь в браузере получает доступ к данным, включая возможные вирусы или ворующие данные аддоны, поэтому и есть это правило. И рекомендуем использовать инструмент только там, где вы доверяете цифровому окружению.

Справочник контактов идёт через недокументированные методы API. Если YouGile их уберёт, вместо имён появятся ID, а в логе будет предупреждение. Тогда пригодится букмарклет как запасной путь.
Готовый файл можно переименовать и положить куда угодно: на общий диск, в мессенджер, базу данных.

Если вам знакома эта же боль с YouGile, забирайте и пользуйтесь.