Telegrin можна підключити до власних інструментів двома способами: через публічний REST API або через MCP-сервер для AI-асистентів (наприклад, Claude). Обидва способи працюють з тими самими даними, що й застосунок: кампанії, сигнали, ліди, CRM, статистика.
Де знайти налаштування
У застосунку відкрийте Робочий простір → вкладка API. Тут створюються API-ключі та знаходиться блок Підключити до Claude (MCP).
Публічний REST API
API дає програмний доступ до робочого простору: читання сигналів і лідів, керування кампаніями, CRM-стадії, статистика тощо.
- На вкладці API натисніть Створити ключ. Вкажіть назву і рівень доступу: Лише читання або Читання та запис.
- Скопіюйте ключ одразу - після закриття вікна він більше не відображатиметься.
- Надсилайте ключ у заголовку Authorization: Bearer у кожному запиті.
- Базова адреса: https://tg.grinfi.io/api/v1/ext
Повний перелік методів з прикладами - в інтерактивній документації: https://tg.grinfi.io/api/v1/ext/reference (посилання Повна документація API є й на вкладці).
⚠️ Важливо: API-ключ відкриває доступ до даних робочого простору. Зберігайте його як пароль, не публікуйте в коді та відкликайте ключі, якими більше не користуєтеся.
MCP-сервер: керуйте Telegrin у чаті з Claude
MCP (Model Context Protocol) дозволяє AI-асистенту працювати з Telegrin від вашого імені: переглянути нові сигнали, схвалити відповідь, створити кампанію, вивантажити лідів - звичайним текстом у чаті.
Як підключити (потрібні права адміністратора робочого простору):
- Скопіюйте адресу MCP-сервера на вкладці API: https://mcp-tg.grinfi.io/mcp
- У Claude відкрийте Settings → Connectors → Add custom connector, вставте адресу і натисніть Connect.
- У вікні, що відкриється, увійдіть у свій акаунт Telegrin.
Після підключення Claude бачить ваші кампанії, сигнали і лідів - а перед кожною важливою дією (надсилання відповіді, видалення) запитує підтвердження.
Що обрати
- Потрібна інтеграція з вашою CRM, скриптами чи звітами - використовуйте REST API.
- Хочете керувати Telegrin розмовою, без коду - підключіть MCP до Claude.
Обидва способи можна використовувати одночасно.