REST API Работает

Заявки с сайта попадают в воронку

Форма на вашем сайте отправляет один запрос — и заявка становится сделкой на первом этапе. Роботы срабатывают так же, как если бы сделку завели руками: назначают ответственного, ставят задачу, двигают по воронке.

Телефония находит клиента по номеру

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

Обмен с учётной системой

Параметр updated_since отдаёт только изменившееся с прошлого обмена — выгрузка по расписанию не тянет базу целиком. А чтобы узнавать об изменениях сразу, есть веб-хуки: событие о новой сделке и смене этапа уходит на ваш адрес с подписью.

Доступ под контролем

Токен работает от имени выбранного сотрудника — его права ограничивают выдачу. Есть режим «только чтение», срок действия и отзыв в один клик.

1. Выпустить токен

Настройки → Интеграции и API → API-токены. Укажите название, сотрудника, от имени которого работает интеграция, и уровень доступа. Токен показывается один раз — скопируйте его сразу.

2. Проверить связь

Запрос к /api/v1/me с заголовком Authorization покажет компанию, сотрудника токена и включённые модули. Если ответ пришёл — всё настроено верно.

3. Подключить систему

Дальше по документации: список и создание сделок, смена этапа, поиск и создание контрагентов, справочник воронок и этапов.

Границы первой версии

• Позиции товаров в сделке пока не принимаются — их пересчёт завязан на склад; сумму передавайте отдельным полем
• Задачи, объекты, наряды и остатки — следующие разделы в очереди

Ограничения и безопасность

• 120 запросов в минуту
• Данные строго в пределах компании токена
• В базе хранится только хеш токена — восстановить значение нельзя, можно выпустить новый
• Отзыв мгновенный: остальные интеграции продолжают работать