Агент видит в Битрикс24 только часть сделок. Почему?

Входящий вебхук работает с правами сотрудника, который его создал. Если этот сотрудник видит только свои сделки, столько же видит и агент. Создайте вебхук под сотрудником, который видит всю CRM, и вставьте новую ссылку в подключение.

Какую ссылку Битрикс24 вставлять?

Адрес входящего вебхука целиком, вида https:// .bitrix24.ru/rest/1/ /, со слешем на конце и без имени метода. Поле в форме называется «Входящий Webhook URL».

Где взять токен amoCRM?

Под администратором создайте в амоМаркете внешнюю интеграцию, в её «Ключах и доступах» сгенерируйте долгосрочный токен и сразу скопируйте его: он показывается один раз. В форму вставьте адрес аккаунта и этот токен.

RetailCRM не отдаёт заказы одного из магазинов. Что не так?

Ключ API RetailCRM видит только магазины, отмеченные в его «Типе доступа». Откройте ключ в разделе «Интеграция» RetailCRM и выберите «Доступ ко всем магазинам» или добавьте нужный магазин.

Агент может делать выплаты водителям в taxiCRM?

Только после того, как taxiCRM откроет эти методы по запросу в свою поддержку. Чтение данных парка работает сразу.

CRM

CRM подключается в разделе «Интеграции», вкладка «Сервисы»: откройте сервис и нажмите «Подключить». Общие правила (статусы карточки, строка «Изменения», второй аккаунт, отключение) описаны на странице «Подключение сервисов». Агент работает с правами того сотрудника или ключа, который вы подключили. Что агент меняет сам, а что присылает карточкой на подтверждение, описано в разделе «Как агент меняет данные». Весь список CRM в каталоге: CRM.

Bitrix24 CRM

Сделки, лиды и контакты Битрикс24. Сценарии на странице интеграции.

Что умеет агент

Читать сделки, лиды, контакты и воронки; если у вебхука есть права, создавать и двигать сделки и ставить задачи.

Что нужно заранее

Сотрудник портала, который видит всю нужную часть CRM: вебхук работает с правами своего создателя.

Шаги

Войдите на портал

Откройте свой портал вида ваш-домен.bitrix24.ru под сотрудником, который видит всю CRM.

Создайте входящий вебхук

«Приложения → Разработчикам», вкладка «Готовые сценарии» → блок «Другое» → «Входящий вебхук».

Отметьте права

Для чтения воронки хватит CRM. Чтобы агент создавал задачи и двигал сделки, добавьте «Задачи». Права можно поменять и позже.

Вставьте ссылку

Скопируйте адрес вебхука вида https://ваш-домен.bitrix24.ru/rest/1/секретный-код/ со слешем на конце и без имени метода и вставьте его в поле «Входящий Webhook URL».

Какие права выдать

CRM для чтения и правки сделок, лидов и контактов; «Задачи», если агент должен ставить задачи.

Ограничения

Агент видит ровно то, что видит создатель вебхука. Секретный код в ссылке виден только ему.

Как отозвать доступ

Нажмите «Отключить» в карточке подключения, а в Битрикс24 удалите этот входящий вебхук в разделе «Разработчикам»: после удаления ссылка перестаёт работать.

Неполадки

Видна только часть сделок: вебхук создан сотрудником с ограниченной видимостью. Создайте новый под сотрудником, который видит всю CRM.
Ссылка не принимается: проверьте слеш на конце и уберите имя метода из адреса.

AmoCRM (Kommo)

Сделки, контакты и воронки продаж. Сценарии на странице интеграции.

Что умеет агент

Читать воронки, сделки, контакты и компании, ставить задачи и менять сделки в пределах прав интеграции.

Что нужно заранее

Права администратора аккаунта amoCRM: без них долгосрочный токен не выпустить.

Шаги

Скопируйте адрес аккаунта

Под администратором скопируйте адрес аккаунта целиком, например https://your-company.amocrm.ru.

Создайте внешнюю интеграцию

амоМаркет → «Создать интеграцию» → «Внешняя интеграция». Заполните название и обязательные настройки и сохраните.

Проверьте права интеграции

В блоке «Разрешить доступ» оставьте сделки, контакты, компании и задачи.

Выпустите токен

В «Ключах и доступах» сгенерируйте долгосрочный токен, выберите срок и сразу скопируйте его. В форму вставьте «Адрес аккаунта» и «Долгосрочный токен».

Какие права выдать

Сделки, контакты, компании и задачи. Без них агент не увидит воронки и не сможет ставить задачи.

Ограничения

Токен показывается один раз и действует до срока, который вы выбрали при выпуске. После него подключение перестанет работать: выпустите новый токен.

Как отозвать доступ

Нажмите «Отключить» в карточке, а в amoCRM удалите токен или саму внешнюю интеграцию в амоМаркете.

Неполадки

«Ключи не приняты»: у токена истёк срок или интеграцию удалили. Выпустите токен заново и нажмите «Ввести ключи заново».
Нет задач или компаний: в блоке «Разрешить доступ» сняты нужные права.

RetailCRM

CRM для интернет-магазинов: заказы, клиенты, товары, справочники, задачи и аналитика. Сценарии на странице интеграции.

Что умеет агент

Читать и менять заказы, клиентов, товары, справочники и задачи в магазинах, которые открыты ключу.

Что нужно заранее

Доступ к настройкам RetailCRM, где выпускаются ключи API.

Шаги

Запишите поддомен и домен

В адресе https://myshop.retailcrm.ru поддомен это myshop, а «Домен аккаунта» это retailcrm.ru после точки. Иногда это retailcrm.pro.

Добавьте ключ API

Шестерёнка настроек слева вверху → «Интеграция» → вкладка «Ключи доступа к API» → «Добавить».

Выберите магазины

В «Тип доступа» выберите «Доступ ко всем магазинам» или отметьте нужные в поле «Магазины».

Отметьте методы и скопируйте ключ

В «Разрешённые методы API» включите заказы, клиентов, товары, справочники, задачи и пользователей, сохраните и вставьте ключ в поле «API-ключ», поддомен в «Поддомен».

Какие права выдать

Методы заказов, клиентов, товаров, справочников, задач и пользователей.

Ограничения

По магазинам вне списка ключа заказы и клиенты не придут.

Как отозвать доступ

Нажмите «Отключить» в карточке и удалите ключ на вкладке «Ключи доступа к API» в RetailCRM.

Неполадки

Нет заказов одного магазина: магазин не отмечен в «Типе доступа» ключа.
Отказ по части действий: метод не включён в «Разрешённые методы API».

Мегаплан

Сделки, задачи, проекты, контакты и события. Сценарии на странице интеграции.

Что умеет агент

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

Что нужно заранее

Доступ к настройкам интеграций Мегаплана.

Шаги

Скопируйте адрес аккаунта

Полный адрес из браузера, например https://company.megaplan.ru, вставьте в поле «URL сервера».

Создайте токен

В настройках интеграций Мегаплана создайте токен с правами, которые нужны агенту.

Вставьте токен

Вставьте его в поле «API-токен». Пароль сотрудника сохранять не нужно.

Какие права выдать

Те, что нужны задаче: на чтение для отчётов, на изменение, если агент должен вести сделки и задачи.

Как отозвать доступ

Нажмите «Отключить» в карточке и удалите токен в настройках интеграций Мегаплана.

Неполадки

«Не хватает прав»: у токена нет нужного права. Выпустите токен с более широкими правами.

BPMSoft CRM

Контакты, контрагенты, лиды, продажи и бизнес-процессы. Сценарии на странице интеграции.

Что умеет агент

Читать и менять записи BPMSoft через OData с правами пользователя подключения.

Что нужно заранее

Отдельный пользователь BPMSoft с лицензией и доступом к OData. Сервер должен открываться из интернета.

Шаги

Скопируйте адрес

Адрес BPMSoft из адресной строки до первого слеша, вида https://crm.company.ru, вставьте в «URL сервера».

Заведите сотрудника

Дизайнер системы → «Пользователи и администрирование» → «Пользователи системы» → «Добавить пользователя», тип «Сотрудник компании».

Отметьте лицензию

В карточке пользователя на вкладке «Лицензии» отметьте лицензию: без неё вход по логину и паролю отклоняется.

Выдайте доступ к OData

Дизайнер системы → «Права доступа на операции» → операция «Доступ к OData»: добавьте пользователя или его роль. Вставьте «Имя пользователя» и «Пароль».

Какие права выдать

Операция «Доступ к OData» и права на нужные разделы у роли пользователя.

Ограничения

Если сервер пускает только известные адреса, добавьте адреса, указанные в окне подключения, в список разрешённых.

Как отозвать доступ

Нажмите «Отключить» в карточке и заблокируйте пользователя подключения в BPMSoft или снимите у него «Доступ к OData».

Неполадки

Логин и пароль не принимаются: у пользователя не отмечена лицензия.
Нет данных раздела: у роли нет прав на этот раздел.

Yclients

Записи, клиенты, услуги и расписание салона. Сценарии на странице интеграции.

Что умеет агент

Читать и менять записи, клиентов и услуги филиала.

Что нужно заранее

Пользователь, который управляет филиалом, и доступ к кабинету разработчика YCLIENTS.

Шаги

Откройте кабинет разработчика

Войдите под пользователем, который управляет филиалом, и откройте yclients.com/appstore/developers.

Скопируйте партнёрский токен

В «Настройках аккаунта» скопируйте API-ключ и вставьте его в «Партнёрский токен».

Создайте приложение

В «Моих приложениях» создайте приложение и в его разделе «Доступ к API» отметьте права системного пользователя: клиенты, записи, услуги.

Заберите User token и номер филиала

Скопируйте «User token» в «Пользовательский токен», а число из адресной строки кабинета филиала в «ID компании».

Какие права выдать

Клиенты, записи и услуги у системного пользователя приложения.

Ограничения

Одно подключение работает с одним филиалом. Второй филиал подключается через «Добавить ещё».

Как отозвать доступ

Нажмите «Отключить» в карточке и удалите приложение в «Моих приложениях» кабинета разработчика.

Неполадки

API не отвечает вовсе: не вставлен партнёрский токен, без него не работают даже публичные методы.

taxiCRM

Водители, поездки, выплаты, смены, штрафы, автомобили и аренда таксопарка. Сценарии на странице интеграции.

Что умеет агент

Читать данные парка: водителей, поездки, смены, выплаты, штрафы, аренду. Выплаты и правку баланса после того, как taxiCRM их откроет.

Что нужно заранее

Доступ к настройкам компании в кабинете парка.

Шаги

Запишите поддомен

В адресе https://вашпарк.taxicrm.ru поддомен это часть до .taxicrm.ru. Вставьте её в «Поддомен».

Откройте «API»

«Компания» → «Настройки компании» → «API».

Скопируйте ключ парка

Вставьте API-ключ парка в поле «API-ключ».

Какие права выдать

Ключ один на весь парк и открывает все его данные: держите его как пароль.

Ограничения

Выплата водителю, изменение баланса и снятие блокировки транзакции открываются только по запросу в поддержку taxiCRM.

Как отозвать доступ

Нажмите «Отключить» в карточке. Ключ один на весь парк: как сменить его, чтобы закрыть доступ и на стороне taxiCRM, уточните в поддержке taxiCRM.

Неполадки

Отказ на выплате: методы выплат не открыты, попросите поддержку taxiCRM.

Нужной CRM нет

CRM с открытым API можно подключить сразу на вкладке «Свой API»: «Свой API и MCP».