Главная Настройки и интеграции

Настройки и интеграции

Команда, уведомления, API и MCP
Alex Mishyn
От Alex Mishyn
• 6 статьи

Команда и роли

Рабочее пространство (воркспейс) может вести команда. У каждого участника есть роль, которая определяет, что ему разрешено. Страница: Настройки → Команда. Четыре роли | Роль | Что может | | --- | --- | | Админ | Всё, что Редактор, и вдобавок: приглашать людей и менять роли, тариф, оплата и пополнение, API-ключи, подключения Slack, Grinfi, Claude, вебхуков и CRM, выгрузка данных и удаление воркспейса | | Редактор | Кампании, агенты и AI-ядро, подключение аккаунтов Telegram, Threads и Reddit, подбор чатов и анализ истории, этапы воронки, снятие блокировки в чёрном списке, группы Telegram для лидов и частота писем. Не может то, что доступно только Админу | | Оператор | Лента, ответы лидам, воронка, задачи, блокировка отправителей. Может создавать кампании, менять их и ставить на паузу. Не может подключать аккаунты, создавать и менять агентов и AI-ядро, снимать блокировку | | Наблюдатель | Только просмотр, без каких-либо изменений - и только тех кампаний, которые ему назначены | Админ, Редактор и Оператор видят все кампании воркспейса, их лидов и переписку. ⚠️ Важно: Наблюдатель видит только назначенные ему кампании, а назначить кампанию на экране сейчас нельзя. Поэтому у Наблюдателя пустые кампании, лента и воронка. Если коллеге нужно видеть лидов, выберите для него роль Оператор. 💡 Совет: типичное распределение - владелец бизнеса как Админ, маркетолог как Редактор (настраивает кампании и агентов), менеджеры по продажам как Оператор (разбирают ленту и общаются с лидами). ℹ️ Подсказка: Оператор может заблокировать отправителя, но снять блокировку могут только Админ и Редактор: разблокировка касается всех кампаний сразу. Telegram-бота каждый участник подключает себе сам - это личная настройка, она доступна всем ролям, включая роль Наблюдатель. А вот добавлять бота в кампании Наблюдатель не может. Подробно - в статье «Уведомления». Пригласить человека Приглашать людей и менять роли может только Админ. Остальные видят на странице надпись «Приглашать и менять роли может только админ воркспейса». 1. Нажмите Пригласить. 2. Укажите Email и выберите Роль. 3. Нажмите Отправить приглашение. Человек получит письмо со ссылкой. Приглашение действует 7 дней - срок виден на странице («Приглашение действует до…»). После принятия человек появится в списке участников. Приглашения Приглашения, которые ещё не приняты, собраны в блоке Приглашения: - Отправить ещё раз - новое письмо, срок снова 7 дней; - Отозвать приглашение - ссылка из письма перестанет работать. Изменить роль или удалить участника В меню участника - Изменить роль и Удалить из команды. После удаления доступ пропадает сразу, но данные остаются: кампании, лиды и переписка на месте. Свою роль изменить и себя удалить нельзя. Роль владельца воркспейса не меняется, и владельца нельзя удалить. Один Telegram-аккаунт - один воркспейс Telegram-аккаунт можно подключить только к одному воркспейсу. Если при подключении Вы видите сообщение, что номер уже подключён в другом рабочем пространстве, - сначала отключите его там. Номер воркспейса На странице Настройки → Профиль виден Номер воркспейса в формате TG-00001. Назовите его поддержке, когда обращаетесь, - так мы найдём Ваш аккаунт быстрее всего. Что меняет только поддержка - Имя и Email участника - напишите нам, и мы изменим. - Название воркспейса. Пароль меняется самостоятельно: на странице входа нажмите Забыли пароль?, и мы пришлём письмо со ссылкой для нового пароля.

Обновлено Oct 15, 2026

Уведомления

Новые лиды видны в ленте, но ждать их там не обязательно - Telegrin может сообщать о них сам: в Telegram, в браузере и на почту. Основные настройки собраны на странице Настройки → Уведомления. Telegram-бот: два шага Бот @telegrin_signals_bot присылает карточку лида с кнопкой прямо на исходное сообщение. Чтобы карточки начали приходить, нужны оба шага ниже - одного подключения мало. Шаг 1. Подключите бота к себе 1. Откройте Настройки → Уведомления и нажмите Подключить бота. 2. Откройте бота кнопкой Открыть в Telegram или наведите камеру телефона на QR-код. 3. В боте нажмите Запустить. На странице появится Бот подключён. Каждый участник команды подключает бота сам, на свой Telegram. Шаг 2. Добавьте бота в кампании Бот присылает лидов только из тех кампаний, куда его добавили. Сам он в новые кампании не добавляется, даже если бот у Вас уже подключён. - Сразу в несколько кампаний: на карточке подключённого бота нажмите Добавить в кампании, отметьте нужные кампании (или Выбрать все) и нажмите Добавить. - В одну кампанию: на странице кампании нажмите Конвейер → + → Доставка → Telegram-бот → Добавить шаг. Шаг сохраняется сразу. ℹ️ Подсказка: бот в кампании общий для всей команды. Карточки из этой кампании получает каждый участник, который подключил бота у себя. Добавлять бота в кампании могут все роли, кроме роли Наблюдатель. Кроме лидов, бот присылает всем, кто его подключил, служебные сообщения - например, если Ваш Telegram-аккаунт отключился. Для них добавлять бота в кампании не нужно. Приглушить или отключить - /mute - тишина на 1 час, /unmute - включить раньше. /status покажет, стоит ли пауза. - /language - сменить язык уведомлений. - Чтобы одна кампания перестала присылать карточки, уберите из неё шаг Telegram-бот там же, где добавляли. Кампания продолжит работать, лиды останутся в ленте. - Кнопка Отключить на карточке бота выключает уведомления только для Вас. Сами лиды никуда не денутся - они остаются в ленте. 💡 Совет: если уведомлений слишком много, не отключайте бота целиком - уберите его из самой шумной кампании. Лиды в группу Telegram Карточки лидов могут приходить и в общий чат команды - всем сразу, без личных подписок. 1. В блоке Лиды в группу Telegram нажмите Добавить в группу. 2. Telegram спросит, в какую группу добавить бота, - выберите её. В группу приходят карточки из тех же кампаний, куда добавлен Telegram-бот. Переписку в группе бот не читает: он видит только команды, адресованные ему. ⚠️ Важно: лидов увидят все участники группы, в том числе те, у кого нет доступа в Telegrin. Добавлять и отключать группы могут роли Админ и Редактор. Почта Письма о лидах - настройка всего воркспейса, а не кампании: отдельной доставки на почту в кампании нет. Письма приходят на адрес владельца воркспейса. В блоке Почта четыре варианта: На каждый лид, Раз в день, Раз в неделю и Не присылать. По умолчанию стоит Раз в неделю. Менять вариант могут роли Админ и Редактор. При На каждый лид письмо приходит сразу о каждом новом лиде из всех кампаний. Что в письме при Раз в день и Раз в неделю: - только лиды, которые ещё не прочитаны в ленте; отклонённые AI в письмо не попадают; - до 10 самых свежих лидов: имя со ссылкой на карточку и начало сообщения, в теме письма - сколько новых лидов всего; - если непрочитанных лидов за период нет, письмо не приходит. Отдельно от этой настройки на почту приходят письма о балансе - когда осталось 20% и 5% месячного объёма кредитов и когда кредиты закончились. Они не отключаются. Уведомления в браузере Блок Этот браузер - три переключателя, которые хранятся на конкретном устройстве: Push-уведомления, Звук и Баннер на рабочем столе. В отличие от бота, их не нужно добавлять в кампании. Подробно - в статье «Уведомления в браузере». Чего здесь пока нет Блок Чего здесь пока нет честно перечисляет то, что пока не настраивается: - выбор событий - в Telegram уходит каждый найденный лид из кампаний, где есть бот; - фильтр по каналам; - тихие часы по расписанию - есть только ручное приглушение командой /mute. Если уведомления не приходят, пройдитесь по статье «Не приходят уведомления (особенно на iOS)».

Обновлено Oct 15, 2026

MCP и публичный API

Telegrin можно подключить к Вашим инструментам двумя путями: - MCP-сервер - для AI-ассистентов (Claude, ChatGPT, Cursor, Codex): ассистент получает прямой доступ к ленте, кампаниям и воронке, и задачи решаются прямо в чате. - Публичный API - для своих интеграций и скриптов: около 130 операций через обычные REST-запросы. MCP-сервер работает через тот же публичный API, поэтому ассистенту доступны те же возможности. MCP: подключение за 2 минуты 1. Откройте раздел MCP в меню приложения. 2. Выберите вкладку Вашего клиента - Claude Code, Claude Desktop, Cursor или Codex - и скопируйте готовый текст кнопкой копирования: - Claude Code - одна команда в терминале, сервер добавится сам; - Claude Desktop - вставьте в claude_desktop_config.json (Settings → Developer → Edit Config); - Cursor - вставьте в файл ~/.cursor/mcp.json и перезапустите Cursor; - Codex - добавьте в ~/.codex/config.toml, затем выполните codex mcp login telegrin - откроется вход. 3. Адрес сервера (он уже внутри готовых текстов): https://mcp-tg.grinfi.io/mcp. 4. При первом подключении откроется окно авторизации - войдите со своим аккаунтом Telegrin. Отдельный ключ для MCP не нужен. Claude в браузере (claude.ai) В claude.ai Telegrin подключается как свой коннектор (custom connector): добавьте коннектор с адресом https://mcp-tg.grinfi.io/mcp и войдите своим аккаунтом Telegrin. Такой коннектор нужен, например, задаче Claude, которая сама разбирает новых лидов, - пошагово в статье «Telegrin → Claude: задача Claude сама разбирает новых лидов». Что умеет ассистент через MCP - читает ленту и одобряет сигналы прямо из чата; - управляет кампаниями - запуск, пауза, ключевые слова; - показывает баланс кредитов и лимиты; - двигает лидов по этапам воронки; - отдаёт статистику мониторинга и метрики. Примеры запросов: «покажи новые сигналы за сегодня и одобри подходящие», «поставь кампанию X на паузу», «сколько кредитов осталось и на что ушли последние». Публичный API: ключи и доступ 1. Откройте Настройки → API-ключи. 2. Нажмите Создать ключ, задайте Название и выберите Права: Только чтение или Чтение и запись. Нажмите Создать. 3. Скопируйте ключ сразу - он показывается только один раз. 4. Передавайте ключ в заголовке Authorization: Bearer <ключ>. Адрес API: https://tg.grinfi.io/api/v1/ext. Описание всех операций: tg.grinfi.io/api/v1/ext/reference. ⚠️ Важно: ключ даёт программный доступ ко всему воркспейсу, поэтому создавать и отзывать ключи может только Админ. Скомпрометированный ключ отзовите кнопкой Отозвать на том же экране. В списке видно, когда каждый ключ использовался последний раз. 💡 Совет: если интеграции нужно только читать данные (например, выгружать лидов в отчёт), выдайте ей ключ с правами Только чтение. Что покрывает API Те же группы операций доступны и через MCP: - Кампании - список, создание, изменение, пауза и запуск, архив, копия, ключевые слова, агенты и доставщики кампании. - Лента и лиды - карточки, решение «лид / не лид», переписка, отправка сообщения лиду, черновик дожима, чёрный список. - Воронка и задачи - этапы лидов и напоминания по ним. - Агенты и AI-ядра - список, создание и изменение. - Подбор чатов - бесплатный каталог чатов и подбор новых чатов, а также анализ истории сообщений. - Доставка - вебхуки, подключения CRM и списки Grinfi. - Аналитика - метрики и статистика мониторинга. - Биллинг - баланс, лимиты и расходы. Оплата и пополнение - только в приложении. - Воркспейс - участники команды и частота писем о лидах. На каких тарифах доступно API и MCP доступны на всех тарифах, включая пробный период. Связанные статьи «Telegrin → Claude: задача Claude сама разбирает новых лидов» · «Несколько каналов доставки лидов и их порядок» · «Агенты в кампании» · «План и лимиты»

Обновлено Oct 15, 2026

Telegrin → Claude: задача Claude сама разбирает новых лидов

Telegrin может сам будить Вашу задачу в Claude, когда появляется новый лид или лид отвечает в переписке. Claude получает этих лидов и разбирает их по Вашим правилам: проверяет, отвечает, отсеивает. Без n8n, Make и запусков «на всякий случай» каждые пару часов. Как это работает - Новые лиды и ответы лидов собираются в пачку и уходят в Claude не чаще раза в 5 минут. Одна пачка - один запуск задачи. - Каждый запуск тратит лимит Вашей подписки Claude. Пачки нужны, чтобы лимит не уходил на каждого лида отдельно. - Автопилот Telegrin по-прежнему пишет первые ответы сам. Claude подключается дальше: разбирает ответы лидов и решает, что делать. Что нужно заранее - Платная подписка Claude: Pro, Max, Team или Enterprise. - Коннектор Telegrin в claude.ai - как подключить, описано в статье «MCP и публичный API». - Инструкция для Claude: кого считать лидом, как отвечать, сколько сообщений отправлять. Шаг 1. Создайте задачу типа «Код» 1. Откройте claude.ai/code/routines → Новая задача → Код. У задач типа Чат нет запуска по API, а тип потом не меняется. 2. Вставьте инструкцию и обязательно добавьте в неё фразу: «Разбери события Telegrin из блока routine-fire-payload». Без неё задача не станет разбирать события от Telegrin. 3. Репозиторий выбирать не нужно. В коннекторах оставьте Telegrin. 4. Добавьте запуск по расписанию раз в день - это страховка. Время ставьте не ровно на час, например 9:07: в :00 запуск может опоздать. 5. Нажмите Add another trigger → API и сохраните задачу. Шаг 2. Скопируйте адрес и ключ Откройте задачу → Edit → API. Скопируйте адрес вида https://api.anthropic.com/v1/claude_code/routines/trig_…/fire и нажмите Generate token. ⚠️ Важно: ключ показывается один раз - сразу сохраните его. Если ключ потерялся, нажмите Regenerate и впишите новый в Telegrin: старый перестанет работать. Шаг 3. Подключите задачу в Telegrin Агенты → вкладка Доставщики → Создать своего доставщика → Claude. Вставьте адрес и ключ. 💡 Совет: то же самое может сделать сам Claude. В чате с подключённым Telegrin напишите: «Создай в Telegrin подключение к моей задаче Claude, адрес …, ключ …». Какие кампании попадут в задачу: - кампании без своих доставщиков или только с Telegram-ботом - автоматически, бот продолжает работать; - кампании со своим вебхуком, Slack или CRM - добавьте Claude в их доставщики. Шаг 4. Проверьте 1. Нажмите Отправить тест у подключения. Тест запускает задачу один раз по-настоящему и тратит немного лимита. В истории задачи появится запуск. 2. Если раньше у Вас была задача квалификации по расписанию, выключите её. Иначе лиды получат два ответа. 3. Через день-два загляните в claude.ai → Настройки → Использование и посмотрите, сколько лимита уходит на запуски. Если что-то не так | Что видно | Что сделать | |---|---| | Нет кнопки Add another trigger | Это задача типа «Чат» - создайте новую, типа «Код» | | Задача запускается, но события не разбирает | Добавьте в инструкцию фразу про блок routine-fire-payload | | Задача не видит Telegrin | Edit → коннекторы → добавьте Telegrin | | У подключения ошибка HTTP 401 | Ключ неверный или перегенерирован - вставьте актуальный | | У подключения ошибка HTTP 400 | Задача на паузе - включите её | | Ошибка HTTP 429 | Больше 30 запусков в час на одну задачу. Не отправляйте тест слишком часто: пачки обычно дают не больше 12 запусков в час | | Лимит Claude уходит быстро | Каждый запуск - отдельная сессия Claude. Выберите модель попроще или оставьте одну страховку в день | ℹ️ Подсказка: если ошибки идут подряд, подключение выключится само. Исправьте причину и включите его снова.

Обновлено Oct 15, 2026

Уведомления в браузере

Уведомления в браузере сообщают о новых сигналах и о новых личных сообщениях от лидов в Telegram, пока Вы работаете за компьютером или с телефона, где установлен Telegrin. В отличие от Telegram-бота, их не нужно добавлять в кампании: они приходят по всем кампаниям воркспейса. Где найти Настройки → Уведомления, блок Этот браузер. Быстрый путь - колокольчик в верхней панели → Настроить уведомления. Настройки хранятся на конкретном устройстве и не переносятся на телефон. Работаете с ноутбука и с рабочего компьютера - включите их на каждом. Три переключателя Push-уведомления Главный переключатель: он подписывает этот браузер на уведомления. Они приходят, даже когда вкладка закрыта. Без него не работают ни баннер, ни звук. При первом включении браузер спросит разрешение - нажмите Разрешить. Если включить нельзя, под переключателем написана причина: - «Браузер заблокировал уведомления. Разрешите их в настройках сайта» - разрешение когда-то было отклонено, см. раздел «Устранение проблем» ниже; - «Этот браузер не умеет push-уведомления» - откройте Telegrin в другом браузере. Баннер на рабочем столе Системный баннер о новом сигнале - всплывает, когда вкладка свёрнута или закрыта. Если его выключить, push продолжит приходить, но всплывать ничего не будет. Звук Короткий сигнал, когда вкладка Telegrin открыта. Удобно, если Telegrin в соседнем окне. Звук срабатывает вместе с push, поэтому Push-уведомления тоже должны быть включены. ℹ️ Подсказка: если сигналы приходят один за другим, браузер покажет одно общее уведомление, а не десяток подряд. Какую комбинацию выбрать | Сценарий | Push-уведомления | Баннер на рабочем столе | Звук | | --- | --- | --- | --- | | Хочу всё | Вкл. | Вкл. | Вкл. | | Только звук, без баннеров | Вкл. | Выкл. | Вкл. | | Только баннеры, без звука | Вкл. | Вкл. | Выкл. | | Тишина в этом браузере | Выкл. | - | - | 💡 Совет: браузер сообщает только на том устройстве, где включён push. Чтобы не пропускать лидов вне компьютера, подключите Telegram-бота и добавьте его в кампании - как это сделать, описано в статье «Уведомления». Устранение проблем Переключатель Push-уведомления не включается - Причина: уведомления для сайта заблокированы в браузере, и переключатель не может обойти этот запрет. - Решение: нажмите на значок слева от адреса tg.grinfi.io → Уведомления → Разрешить, затем включите переключатель снова. В режиме «Инкогнито» push обычно недоступен - пользуйтесь обычным окном. Звука не слышно - Причина: звук выключен в системе, или браузер не даёт странице играть звук, пока Вы с ней не взаимодействовали. - Решение: проверьте громкость, кликните в любом месте страницы Telegrin и дождитесь следующего сигнала. Если всё настроено, а уведомления не приходят (особенно на iPhone и Mac), - полный разбор в статье «Не приходят уведомления (особенно на iOS)».

Обновлено Oct 15, 2026

Не приходят уведомления (особенно на iOS)

Почему уведомления о новых лидах не приходят - в Telegram, в браузере, на iPhone, на Mac или на почту - и как это исправить. Начните с первого раздела: это самая частая причина. Бот подключён, а карточек нет - Причина: бот не добавлен в кампанию. Подключение только подписывает Вас на бота, а карточки приходят из тех кампаний, где есть шаг Telegram-бот. Сам он в новые кампании не добавляется, даже если бот у Вас уже подключён. - Решение: 1. Откройте Настройки → Уведомления и на карточке бота нажмите Добавить в кампании. 2. Отметьте нужные кампании (или Выбрать все) и нажмите Добавить. Кампании, где бот уже есть, отмечены уже добавлен. 3. Для одной кампании можно и так: страница кампании → Конвейер → + → Доставка → Telegram-бот → Добавить шаг. ℹ️ Подсказка: кнопки Добавить в кампании нет у роли Наблюдатель - попросите коллегу с другой ролью. Если кампания на паузе (в списке она отмечена на паузе), новых лидов не будет, пока Вы её не запустите. Бот не подключён или подключение слетело - Причина: на странице Уведомления видна кнопка Подключить бота вместо надписи Бот подключён. Так бывает, если не нажали Запустить в самом боте, или если бота заблокировали либо удалили чат с ним в Telegram - тогда подключение снимается само. - Решение: 1. Настройки → Уведомления → Подключить бота (та же карточка есть на странице Агенты во вкладке Доставщики). 2. Откройте бота кнопкой Открыть в Telegram или по QR-коду и нажмите Запустить. 3. Если появилось сообщение, что код устарел, нажмите Подключить бота ещё раз: ссылка одноразовая. Включена пауза - Причина: в боте отправлена команда /mute - она глушит уведомления на 1 час. - Решение: отправьте боту /status - рядом с аккаунтом будет пометка о паузе. Команда /unmute включает уведомления сразу. Проверьте также, что уведомления от приложения Telegram разрешены на телефоне и чат с ботом не выключен по звуку. Push в браузере не приходит - Причина: на этом устройстве не включены Push-уведомления, или браузер запретил уведомления для сайта. - Решение: 1. Откройте Настройки → Уведомления, блок Этот браузер, и включите Push-уведомления. 2. На запрос браузера нажмите Разрешить. 3. Если под переключателем написано «Браузер заблокировал уведомления. Разрешите их в настройках сайта» - нажмите на значок слева от адреса tg.grinfi.io → Уведомления → Разрешить. 4. Push включён, но ничего не всплывает - проверьте Баннер на рабочем столе: если он выключен, push приходит без баннера. Если написано «Этот браузер не умеет push-уведомления», откройте Telegrin в другом браузере. В режиме «Инкогнито» push обычно недоступен. Уведомления не приходят на iPhone - Причина: на iPhone push работает только в приложении, установленном на экран «Домой» через Safari (нужна iOS 16.4 или новее). Обычная вкладка Safari уведомлений не присылает. - Решение: 1. Откройте tg.grinfi.io именно в Safari. 2. Нажмите Поделиться → На экран «Домой» → Добавить. 3. Открывайте Telegrin только с иконки на экране «Домой». 4. Внутри приложения включите Push-уведомления (Настройки → Уведомления) и подтвердите запрос iOS. 5. Если уведомлений всё ещё нет - проверьте разрешение для telegrin в Настройках iOS, раздел уведомлений. 💡 Совет: самый надёжный канал на телефоне - Telegram-бот: он не зависит от разрешений браузера. Только не забудьте добавить его в кампании. Уведомления не приходят на Mac - Причина: уведомления выключены на уровне macOS, а не браузера. - Решение: 1. Откройте Системные настройки (System Settings) → Уведомления (Notifications). 2. Найдите в списке Ваш браузер (Chrome, Safari, Edge) и включите Разрешить уведомления (Allow notifications). 3. Проверьте, не включён ли режим Фокусирование / Не беспокоить (Focus / Do Not Disturb): он глушит уведомления даже при всех разрешениях. Не приходят письма о лидах - Причина: почта - настройка всего воркспейса, а не кампании. Письма приходят на адрес владельца воркспейса и только тогда, когда есть что прислать. - Решение: проверьте вариант в блоке Почта на странице Уведомления: при Не присылать писем нет. При Раз в день и Раз в неделю письмо приходит, только если за период есть непрочитанные лиды. Загляните и в папку «Спам». Как устроены все уведомления - в статьях «Уведомления» и «Уведомления в браузере».

Обновлено Oct 15, 2026