Интеграция Linear: задачи и запросы клиентов из чатов – Linear в Binom

Интеграция Linear с Binom связывает разговоры с клиентами и разработку: ИИ-сотрудник создаёт задачу по сообщению об ошибке, фиксирует запрос клиента на доработку и сообщает статус. Linear доступен по запросу в кабинете Binom: Интеграции → Больше интеграций → Linear.

Что Binom умеет в Linear

Binom здесь означает вашего ИИ-сотрудника. После подключения Linear он вызывает действия сервиса, когда разговору нужны эти данные. Какие действия ему доступны, решаете вы. В кабинете каждое действие помечено: read (Binom только смотрит данные), write или delete (Binom меняет или удаляет данные в Linear).

Может ли чат-бот создать задачу в Linear?

Да. Binom ищет похожие задачи ("Search Issues") и создаёт новую ("Create Issue") с описанием из разговора.

Запрос клиента на доработку

Когда клиент просит новую функцию, Binom создаёт или обновляет клиента ("Upsert Customer") и фиксирует его запрос ("Create Customer Need"), чтобы продукт видел, кто чего ждёт.

Статус задачи

Binom находит задачу ("Get Issue") и называет её статус, а детали добавляет комментарием ("Create Comment").

Какие доступы понадобятся

Способы подключения на выбор: API-ключ; вход через OAuth 2.0 (вы входите в свой аккаунт сервиса и подтверждаете доступ). Подробности по каждому способу показаны в блоке "Аутентификация" на странице Linear в кабинете.

Как получить интеграцию Linear

Linear подключается по запросу: сначала команда Binom настраивает интеграцию для вашего аккаунта. Общие правила каталога описаны в инструкции как подключить сервис из "Больше интеграций".

1. Откройте Интеграции → Больше интеграций, введите "Linear" в поле "Поиск интеграций" и откройте карточку Linear.
2. На странице "Интеграция Linear для ассистента" будет сообщение "Интеграция доступна по запросу. Запросите сейчас, и мы настроим её для вас в приоритетном порядке." Ассистент здесь это ваш Binom. Блок "Аутентификация" показывает, какие доступы понадобятся, а список "Действия" показывает всё, что Binom умеет делать в Linear.
3. Нажмите "Запросить интеграцию". Появится "Запрос отправлен. Вы получите уведомление, когда интеграция станет доступна.", а кнопка сменится на "Запрошено".
4. С вами свяжется сотрудник Binom по настройке. Когда интеграция будет готова, на странице Linear появится кнопка "Подключить".
5. Нажмите "Подключить", пройдите шаги в окне "Подключение Linear" и нажмите "Готово". После "Подключается…" статус станет "Подключено". Если появилось "Подтверждение пока не пришло. Подключение ещё может завершиться – проверьте через минуту.", нажмите "Проверить ещё раз".

Как выбрать, что Binom может делать в Linear

Подключённая интеграция ничего не делает, пока вы не разрешите действия. В кабинете это сказано прямо: "Отметьте действия, которые может вызывать ассистент. Пока ничего не отмечено, ему недоступно ни одно."

1. На странице Linear отметьте галочками нужные действия в списке "Действия". Найти их по названию помогает поле "Фильтр по действиям". Счётчик показывает, сколько выбрано.
2. Проверьте переключатель "Спрашивать перед изменением данных". Он включён по умолчанию: перед действием на запись или удаление Binom опишет, что собирается сделать, и дождётся ответа.
3. Нажмите "Сохранить". Сообщение "Разрешённые действия сохранены" подтверждает изменения.

Для начала достаточно "Search Issues", "Create Issue", "Upsert Customer" и "Create Customer Need". Действия на изменение и удаление добавляйте, когда будете готовы доверить Binom изменения в Linear.

Как проверить, что интеграция работает

• Начните новый диалог с вашим Binom, например по публичной ссылке на чат, опишите тестовую ошибку и проверьте задачу в Linear.

Возможные проблемы

Binom не использует данные Linear в ответах

Что проверить: статус Linear "Подключено", и нужные действия отмечены (например "Create Issue").
Что сделать: отметьте действия и нажмите "Сохранить".
Как понять, что решено: появилось "Разрешённые действия сохранены", и в новом диалоге Binom отвечает по данным Linear.

"Не удалось записать запрос. Попробуйте ещё раз."

Что сделать: снова нажмите "Запросить интеграцию". Если сообщение повторяется, напишите на support@binomai.com: название вашего Binom и интеграции (Linear).
Как понять, что решено: на кнопке появилось "Запрошено".

"Интеграция временно недоступна – ваш запрос записан."

Больше ничего делать не нужно: запрос сохранён, и вы получите уведомление, когда Linear можно будет подключить.

"Нужно переподключить"

Что это значит: "Сервис больше не принимает сохранённые доступы, поэтому ассистент им не пользуется."
Что сделать: откройте страницу Linear в Больше интеграций, нажмите "Переподключить" и пройдите окно подключения заново.
Как понять, что решено: статус "Подключено".

"Не удалось начать подключение. Попробуйте ещё раз."

Что сделать: снова нажмите "Подключить". Если сообщение повторяется, напишите на support@binomai.com: название вашего Binom, интеграции (Linear) и скриншот сообщения.
Как понять, что решено: открывается окно "Подключение Linear".

"На платном тарифе" вместо кнопки подключения

На странице будет "Доступно на платном тарифе. Скажите, что нужно, и мы сообщим о запуске." Что входит в тарифы, смотрите на странице тарифов и цен подписки, а как сменить тариф, описано в инструкции как сменить или повысить тариф. После смены тарифа вернитесь в Больше интеграций и снова откройте Linear.

"У вас нет прав для управления этим разделом."

Что это значит: интеграциями управляют только пользователи с уровнем доступа Владелец или Администратор.
Что сделать: попросите владельца аккаунта выдать вам уровень Администратор или подключить Linear самому. Подробнее: уровни доступа в команде.
Как понять, что решено: после обновления страницы открываются настройки интеграции.

Если проблема не решилась, напишите на support@binomai.com или в чате Тьютора "Хочу поговорить с человеком". Укажите название Binom, интеграции и приложите скриншот сообщения.

Как отключить Linear

На странице Linear нажмите "Отключить". В окне "Отключить Linear?" будет предупреждение: "Ассистент потеряет доступ к сервису. Чтобы вернуть его, интеграцию придётся подключить заново и снова ввести доступы." Подтвердите, и появится "Интеграция отключена".

Как ещё спрашивают

Нужен ли программист для интеграции Linear?

Нет. Вы запрашиваете Linear в разделе Интеграции → Больше интеграций, команда Binom настраивает интеграцию, а затем вы сами подключаете аккаунт и выбираете действия.

Что дальше

• Интеграция Jira