Налаштування та інтеграції

Команда, сповіщення, API і MCP

Від 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