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

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

Від Alex Mishyn

• 5 статті

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

Робочий простір може вести команда. Кожен учасник має роль, яка визначає, що йому дозволено. Сторінка: Налаштування → Команда. Чотири ролі У інтерфейсі назви ролей не перекладаються - вони виглядають так само в усіх мовах. | Роль | Що може | | --- | --- | | Admin (адміністратор) | Усе: запрошення й ролі, кампанії, ліди, API-ключі, тариф і оплата | | Editor (редактор) | Кампанії й підключення акаунтів. Не може запрошувати людей, змінювати ролі і торкатися оплати | | Operator (оператор) | Робота з лідами: стрічка, відповіді, пайплайн, блокування відправників. Кампанії створювати й змінювати не може | | Viewer (спостерігач) | Лише перегляд. Будь-яка зміна відхиляється | 💡 Порада: типовий розподіл у команді - власник бізнесу як Admin, маркетолог як Editor (він налаштовує кампанії й ключові слова), менеджери з продажу як Operator (вони розбирають стрічку і спілкуються з лідами). ⚠️ Важливо: Operator може додати відправника в чорний список, але не може його звідти прибрати - розблокування доступне ролям Admin і Editor. Це навмисно: зняття блокування зачіпає всі кампанії відразу. Viewer не може змінювати нічого, окрім одного - власних сповіщень у Telegram-боті. Це особисте налаштування кожного, і воно не впливає на колег. Запросити людину 1. Натисніть Запросити. 2. Вкажіть Email і оберіть Роль. 3. Натисніть Надіслати запрошення. Людина отримає лист із посиланням. Після прийняття вона з'явиться у списку учасників. Змінити роль або прибрати учасника У меню учасника - Змінити роль і Видалити з команди. Видалення закриває доступ до робочого простору, але нічого не видаляє: кампанії, ліди й листування, з якими працювала людина, залишаються на місці. Один акаунт - один робочий простір Telegram-акаунт може бути підключений лише до одного робочого простору. Якщо при підключенні ви бачите повідомлення, що номер уже використовується, - спершу відключіть його там, де він підключений зараз. Номер робочого простору На сторінці Налаштування → Профіль видно номер робочого простору у форматі TG-00001. Назвіть його підтримці, коли звертаєтеся, - так ми знайдемо ваш акаунт швидше за все інше. Що змінює тільки підтримка - Ім'я і email учасника - напишіть нам, і ми змінимо. - Назва робочого простору. Пароль змінюється самостійно через відновлення: на сторінці входу натисніть посилання про забутий пароль, і ми надішлемо лист із посиланням для встановлення нового.

Востаннє оновлено Aug 02, 2026

Сповіщення

Сигнали не обов'язково перевіряти вручну - Telegrin може повідомляти про нових лідів сам. Сторінка: Налаштування → Сповіщення. Бот у Telegram Найзручніший спосіб: картка ліда приходить вам у приватні повідомлення разом із кнопкою відповіді. 1. Підключіть бота кнопкою на сторінці Сповіщення (або на сторінці Агенти). 2. Увімкніть перемикач Надсилати сигнали в Telegram. ℹ️ Підказка: цей перемикач особистий. Кожен учасник команди вмикає і вимикає сповіщення для себе, на колег це не впливає. Приглушити на час Приглушити сповіщення можна в самому боті. Якщо ви це зробили, на сторінці налаштувань з'явиться нагадування Сигнали приглушено з кнопкою повернення - щоб не забути, що ви їх колись вимкнули. По конкретних кампаніях Telegram-бот - звичайний агент-доставщик, як Slack чи вебхук. Окремого перемикача «сповіщення в бот» у кампанії більше немає: бот видно в списку доставщиків кампанії, і керуєте ви ним там само. Щоб приглушити одну кампанію - відкріпіть від неї бота-доставщика: кампанія працюватиме далі, просто її ліди не приходитимуть у Telegram. 💡 Порада: якщо в Telegram надто багато сповіщень, не вимикайте бота повністю - відкріпіть його від найгучнішої кампанії. Інакше ризикуєте пропустити справді цінного ліда. Сповіщення в браузері Три налаштування, які зберігаються на конкретному пристрої і не переносяться на телефон: - Push-сповіщення - приходять, навіть коли вкладку закрито; - Звук - короткий сигнал, коли вкладку відкрито; - Банер на робочому столі - спливає, коли вкладку згорнуто. Якщо push не вмикається, найімовірніше їх заблокував браузер: дозвольте сповіщення в налаштуваннях сайту. ⚠️ Важливо: push-підписка прив'язана до конкретного браузера. Працюєте і з ноутбука, і з комп'ютера - увімкніть її окремо в кожному. Листи На пошту надходять системні листи про баланс - коли залишається 20% і 5% місячного обсягу кредитів і коли вони закінчилися. Окремого налаштування вони не мають і не вимикаються. Ліди на пошту теж приходять. Додайте кампанії доставку Пошта, а темп оберіть у Налаштування → Сповіщення: - за кожним лідом - окремий лист одразу, щойно лід підтверджено; - раз на день - один дайджест зі свіжими лідами; - раз на тиждень - те саме, але щотижня; - вимкнено - тиша. ℹ️ Підказка: порожній дайджест не надсилається - якщо лідів за період не було, листа не буде. Темп одразу стоїть раз на тиждень, щоб пошта не перетворювалася на спам. Чого поки немає Чесно про обмеження, щоб ви не шукали ці налаштування: - вибір подій - у Telegram іде кожен знайдений лід; - фільтр за каналами - окремо ввімкнути тільки LinkedIn чи тільки Telegram не можна; - тихі години за розкладом - є лише ручне приглушення в боті. Найгнучкіший інструмент сьогодні - перемикач по кожній кампанії.

Востаннє оновлено Sep 03, 2026

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

Telegrin можна підключити до ваших інструментів двома шляхами: - MCP-сервер - для AI-асистентів (Claude, ChatGPT, Cursor): асистент отримує прямий доступ до стрічки, кампаній і воронки - задачі вирішуються прямо в чаті. - Публічний API - для власних інтеграцій і скриптів: ті самі можливості через REST-запити. MCP-сервер - це дзеркало публічного API один до одного: все, що вміє API (близько 90 операцій), доступне й асистенту через MCP. MCP: підключення за 2 хвилини 1. Відкрийте розділ MCP у навігації застосунку. 2. Оберіть вкладку вашого клієнта - Claude Code, Claude Desktop або Cursor - і скопіюйте готовий сніпет кнопкою копіювання: - Claude Code - одна команда в терміналі, сервер додається сам; - Claude Desktop - вставка в claude_desktop_config.json (Settings → Developer → Edit Config); - Cursor - вставка у файл ~/.cursor/mcp.json і перезапуск. 3. Адреса сервера (вже всередині сніпетів): https://mcp-tg.grinfi.io/mcp. 4. При першому підключенні відкриється вікно авторизації - увійдіть зі своїм акаунтом Telegrin. Окремий ключ для MCP не потрібен. Що вміє асистент через MCP - читає стрічку і схвалює сигнали прямо з чату; - керує кампаніями - запуск, пауза, ключові слова; - показує баланс кредитів і ліміти; - рухає лідів стадіями воронки; - віддає статистику моніторингу й метрики. Приклади запитів асистенту: «покажи нові сигнали за сьогодні й схвали релевантні», «постав кампанію Х на паузу», «скільки кредитів залишилось і на що витратились останні». Публічний API: ключі й доступ 1. Відкрийте Налаштування → API-ключі. 2. Натисніть «Створити ключ», дайте йому назву. 3. Скопіюйте ключ одразу - він показується лише один раз. 4. Передавайте ключ у заголовку Authorization: Bearer <ключ>. ⚠️ Важливо: ключ дає програмний доступ до всього воркспейса, тому створювати й відкликати ключі може лише адмін воркспейса. Компрометований ключ відкличте на тому ж екрані - це миттєво. Що покриває API Групи операцій (ті самі доступні через MCP): - Кампанії - список, створення, редагування, запуск/пауза, доставщики кампанії. - Сигнали і ліди - стрічка, схвалення/відхилення, картки лідів, стадії воронки. - Агенти - список агентів і шаблони. - AI-ядра - читання й оновлення ядер. - Відстежувані пости - підключення й архівація постів. - Аналітика - метрики дашборда, воронка моніторингу. - Білінг - баланс кредитів і ліміти (без оплат - покупки лише в застосунку). - Блок-лист - додавання й видалення записів. - Вебхуки - керування ендпоінтами доставки (деталі - стаття «Вебхук-доставка лідів у вашу CRM»). - Сканування історії, воркспейс, пошук чатів - службові операції. На яких тарифах доступно API і MCP доступні на всіх тарифах - і на тріалі, і на платних (Starter, Growth і Scale). Ключі створює адміністратор воркспейса в Налаштування → API-ключі. Пов'язані статті «Вебхук-доставка лідів у вашу CRM» · «Кілька каналів доставки лідів і їхній порядок» · «План і ліміти»

Востаннє оновлено Sep 03, 2026

Сповіщення в браузері

Сповіщення в браузері повідомляють про нові сигнали, поки ви працюєте за комп'ютером. Рівень налаштовується - від повної тиші до push зі звуком. Де знайти Налаштування → Сповіщення; швидкий доступ - іконка дзвіночка у верхній панелі. Якщо браузерні сповіщення недоступні на цьому пристрої, екран чесно каже про це - сигнали все одно приходять у Telegram-бот. Три перемикачі (блок «Цей браузер») Налаштування діють для поточного браузера - на кожному пристрої свої. Екран чесно перелічує й те, чого тут ЩЕ немає: вибору подій, фільтра за каналами, тихих годин. 1. Push Сповіщення приходять навіть при закритій вкладці. При першому вмиканні браузер запитає дозвіл - натисніть «Дозволити», без нього push не запрацює. ℹ️ Підказка: якщо ви раніше заборонили сповіщення для tg.grinfi.io, перемикач не зможе ввімкнути їх самостійно - дозвіл браузера має пріоритет. Дозвольте сповіщення в налаштуваннях браузера: іконка замка в адресному рядку → Сповіщення → Дозволити. 2. Звук Короткий звуковий сигнал при новому сигналі, поки вкладка відкрита, - корисно, коли Telegrin у сусідньому вікні. 3. Банер Системний банер, коли вкладка відкрита, але в фоні. Яку комбінацію обрати | Сценарій | Push у браузері | Звук | Системні сповіщення | | --- | --- | --- | --- | | Хочу все | Увімк. | Увімк. | Увімк. | | Без банерів, але зі звуком | Вимк. | Увімк. | Вимк. | | Тиша | Вимк. | Вимк. | Вимк. | 💡 Порада: щоб не пропускати сигнали поза комп'ютером, додатково встановіть застосунок на телефон і підключіть Telegram-бота - разом ці канали покривають усі ситуації. Як це зробити - у розділі 6 «Сповіщення і застосунок», статті «Встановлення застосунку (PWA) на iOS і Android» та «Сповіщення в Telegram (бот)». Усунення проблем Перемикач «Push у браузері» не вмикається - Причина: сповіщення для сайту заблоковані на рівні браузера - перемикач не може обійти цю заборону. - Рішення: дозвольте сповіщення в налаштуваннях браузера (іконка замка в адресному рядку → Сповіщення → Дозволити) і ввімкніть перемикач знову. У режимі «Інкогніто» push зазвичай недоступний - користуйтеся звичайним вікном. Звуку не чути - Причина: звук вимкнено в системі, або браузер блокує відтворення, доки ви не взаємодіяли зі сторінкою. - Рішення: перевірте гучність системи, потім клацніть будь-де на сторінці Telegrin - так браузер дозволить відтворення звуку - і дочекайтеся наступного сигналу. Якщо сповіщення не приходять попри правильні налаштування (зокрема на iOS і macOS) - повний розбір у розділі 9 «Вирішення проблем», стаття «Не приходять сповіщення (особливо на iOS)».

Востаннє оновлено Aug 09, 2026

Не приходять сповіщення (особливо на iOS)

Чому сповіщення про нові сигнали не надходять - у браузері, на iPhone, на Mac або в Telegram - і як це виправити. Push у браузері не приходить - Причина: перемикач «Push у браузері» вимкнено, або браузер не має дозволу на сповіщення. - Наслідок: сигнали з'являються в застосунку, але сповіщень немає. - Рішення: 1. Відкрийте Налаштування → Сповіщення - перемикачі браузера зібрані в блоці «Цей браузер». 2. Увімкніть Push - сповіщення приходитимуть навіть при закритій вкладці. 3. На запит браузера натисніть «Дозволити» - без цього дозволу браузер не показуватиме push. 4. Якщо запит не з'явився (раніше натиснули «Заблокувати») - дозвольте сповіщення для tg.grinfi.io у налаштуваннях браузера: іконка замка в адресному рядку → Сповіщення → Дозволити. Як працюють усі три перемикачі сповіщень - у розділі 6 «Сповіщення і застосунок», стаття «Сповіщення в браузері». Сповіщення не приходять на iOS - Причина: на iPhone браузерні push-сповіщення працюють лише в застосунку, встановленому на Початковий екран через Safari (потрібна iOS 16.4 або новіша). Звичайна вкладка Safari сповіщень не надсилає. - Наслідок: на комп'ютері сповіщення є, на iPhone - ні. - Рішення: 1. Відкрийте tg.grinfi.io у Safari - Chrome на iOS не вміє встановлювати PWA з push. 2. Натисніть Поділитися → «На Початковий екран» → Додати - так Telegrin стане застосунком з іконкою. 3. Відкривайте Telegrin тільки з іконки на Початковому екрані - push приходять лише у встановлений застосунок. 4. Усередині застосунку ввімкніть Push (Налаштування → Сповіщення) і підтвердьте системний запит iOS - це і є дозвіл на сповіщення. 5. Якщо сповіщень досі немає - перевірте дозвіл для telegrin у Налаштуваннях iOS у розділі сповіщень (шлях може трохи відрізнятися залежно від версії iOS). Покрокове встановлення застосунку - у розділі 6 «Сповіщення і застосунок», стаття «Встановлення застосунку (PWA) на iOS і Android». 💡 Порада: найнадійніший канал на телефоні - Telegram-бот @telegrin_signals_bot: він не залежить від браузерних дозволів. Підключення описано в розділі 6 «Сповіщення і застосунок», стаття «Сповіщення в Telegram (бот)». Сповіщення не приходять на macOS - Причина: сповіщення заблоковані на рівні операційної системи, а не браузера - macOS не показує банери, навіть якщо в самому браузері все дозволено. - Рішення: 1. Відкрийте Системні налаштування (System Settings) → Сповіщення (Notifications). 2. Знайдіть у списку ваш браузер (Chrome / Safari / Edge) - саме він показує сповіщення від Telegrin. 3. Увімкніть «Допускати сповіщення» (Allow notifications) і оберіть стиль банера - так система дозволить браузеру показувати сповіщення. 4. Перевірте, чи не увімкнено режим Фокусування / Не турбувати (Focus / Do Not Disturb) у Пункті керування - він глушить сповіщення навіть з увімкненими дозволами. Сповіщення в Telegram не надходять - Причина: бот не підключений, або активна пауза /mute. - Рішення: 1. Відкрийте екран Агенти - картка підключення бота завжди зверху → Підключити → підтвердьте в Telegram кнопкою Start. 2. Якщо бот уже підключений - надішліть йому /status: можливо, увімкнена пауза. Команда /unmute відновлює сповіщення. 3. Перевірте, що сповіщення від самого застосунку Telegram дозволені на телефоні - інакше повідомлення бота приходитимуть беззвучно. Звук або банери вимкнені - Причина: перемикачі «Звук» і «Банер» на екрані Сповіщень вимкнені. - Рішення: увімкніть «Звук» (короткий сигнал, поки вкладка відкрита) та «Банер» (банер, коли вкладка в фоні). Ці перемикачі стосуються лише браузера і не впливають на Telegram-бота. ℹ️ Найнадійніша альтернатива браузерним сповіщенням - доставщики кампанії: Telegram-бот або пошта (лист на кожен лід або дайджест) - вони не залежать від дозволів браузера.

Востаннє оновлено Aug 09, 2026