Підготовка сервісів до підключення BrightPrint

Цей список можна передати власнику або адміністратору друкарні до запуску. У кожному розділі є дії з вашого боку, те, що потрібно передати команді BrightPrint, і спосіб перевірити результат. Якщо сервісом не користуєтесь — повідомте про це; більшість інтеграцій можна підключити пізніше.

Секрети (токени ботів, банків, Нової пошти, JSON-ключ Google, Bitrix webhook) передавайте лише погодженим захищеним каналом. Не вставляйте їх у загальний чат, лист, скриншот або документ із відкритим доступом. Паролі від Google, банку, Telegram і «Приват24» нам не потрібні. Якщо зручніше, створимо доступ разом на дзвінку, а фінальне підтвердження у вашому кабінеті зробите ви.

Що підготувати на початку

Потрібно від друкарні	Навіщо
Назва, логотип, робочий телефон і email, сайт, домен або бажана адреса CRM	Оформлення застосунку, посилання у повідомленнях, налаштування домену
ФОП/юрособи: назва, ЄДРПОУ/ІПН, адреса, підписант, податкова примітка; для кожного рахунку — IBAN, банк, МФО, основний рахунок	Рахунки, накладні, реквізити та правильне зіставлення оплат
Відділи, список співробітників із робочими email, посадами й ролями; хто буде адміністратором	Облікові записи та доступи. Особисті паролі співробітники встановлять самі
Виробничі воронки/стадії, додаткові поля, тексти платіжних реквізитів, правила сповіщень	Початкове налаштування процесів під вашу друкарню
Контакт власника домену, адміністратора Google Workspace та уповноваженої особи в банку	Щоб погодити потрібні дії без передавання чужих паролів

1. Telegram: бот сповіщень

Потрібен для сповіщень співробітникам і, якщо клієнт сам підключиться, для повідомлень клієнту. Для повного набору сповіщень — підключаємо на старті.

1. У Telegram відкрийте тільки офіційний @BotFather.
2. Надішліть /newbot, задайте назву та унікальний username, що закінчується на bot. Інструкція Telegram.
3. Збережіть виданий token. Якщо у вашій системі є Налаштування → Інтеграції, адміністратор вводить token там сам і нікому його не передає (як). Інакше передайте нам token захищеним каналом і @username окремим звичайним повідомленням. Не потрібно створювати Telegram-групу, якщо вам не потрібне окреме групове сповіщення про оплати.
4. Після запуску кожен співробітник сам відкриє Мій профіль → Підключити Telegram і натисне Start у цьому боті.

Перевірка: тестовий співробітник отримує повідомлення. Якщо плануєте підключити Telegram Business, для нього потрібен другий бот, а не цей token.

2. Telegram Business: листування від імені акаунта друкарні

Необов’язково. Потрібен Telegram Premium на акаунті, від імені якого друкарня хоче відповідати клієнтам. Telegram дозволяє власнику вибрати, до яких чатів бізнес-бот матиме доступ і чи зможе відповідати.

1. Створіть окремого бота через @BotFather → /newbot; передайте нам його token захищеним каналом і @username.
2. У налаштуваннях цього бота в BotFather увімкніть Secretary Mode / Business Mode. Опис Telegram.
3. Ми налаштуємо вебхук. Після нашого сигналу власник Premium-акаунта відкриває Telegram → Налаштування → Telegram для бізнесу → Чат-боти, додає саме бізнес-бота, вибирає потрібні чати й надає право відповідати (Reply).
4. За потреби менеджери з Premium підключають свої акаунти до того самого бізнес-бота через підказку в профілі CRM. Нових ботів для них не треба.

Передати нам: token і @username другого бота; ім’я відповідального за спільний Premium-акаунт. Перевірка: акаунт має стан «Підключено» в «Бізнес-чати → Акаунти», повідомлення в наявному клієнтському чаті відправляє саме обраний акаунт. Новому клієнту без попереднього чату цей канал може бути недоступний; система використовує інший доступний канал.

3. Google Drive: файли замовлень і резервні копії

Потрібен Google Workspace із підтримкою Спільних дисків (Shared drives). Особистий @gmail.com і папка в «Моєму диску» для поточного способу підключення не підходять. Як створити спільний диск.

1. У Google Cloud Console створіть або виберіть проєкт для вашої друкарні. Увімкніть Google Drive API (і Gmail API, якщо підключатимете пошту). Офіційна інструкція.
2. У IAM & Admin → Service Accounts створіть сервісний обліковий запис. У вкладці Keys створіть новий ключ типу JSON і збережіть файл. Кроки Google.
3. У Google Drive створіть Спільний диск і в ньому кореневу папку для BrightPrint. Додайте email сервісного облікового запису до учасників Спільного диска з правом Content manager (або Manager). Якщо організація забороняє зовнішніх учасників, адміністратор Workspace має дозволити такий доступ або створити сервісний акаунт у погодженому проєкті.
4. Передайте нам URL кореневої папки (її ID ми візьмемо з адреси), email сервісного акаунта та JSON-ключ захищеним каналом. Не надсилайте OAuth client_secret.json замість ключа сервісного акаунта — це різні файли.

Перевірка: CRM створює папку тестового замовлення на Спільному диску та завантажує туди файл. Якщо Google Workspace без Спільних дисків, повідомте заздалегідь: поточне підключення Drive потребує іншого рішення, яке слід узгодити окремо. Докладніше про роботу файлів — Google Drive.

4. Gmail: спільна скринька друкарні

Необов’язково, але потрібна для двостороннього листування й автоматичних клієнтських листів через одну корпоративну скриньку. Потрібен Google Workspace і адміністратор із правами Super Admin. Особистий Gmail не може замінити цей сценарій.

1. Створіть або визначте спільну скриньку, наприклад info@ваш-домен. Повідомте її точну адресу. Gmail API має бути увімкнено в тому самому Cloud-проєкті, що й сервісний акаунт із кроку 3.
2. У Cloud Console відкрийте сервісний акаунт → Advanced settings і скопіюйте його числовий Client ID для domain-wide delegation.
3. Super Admin відкриває Google Admin → Security → Access and data control → API controls → Manage Domain Wide Delegation, додає цей Client ID і тільки scopes: https://www.googleapis.com/auth/gmail.modify та https://www.googleapis.com/auth/gmail.send.
4. Повідомте нам адресу скриньки й підтвердження, що доступ надано. Пароль від скриньки та додатковий JSON не потрібні — використовується ключ із кроку 3. Налаштуйте SPF, DKIM і DMARC для домену за правилами вашого поштового адміністратора.

Важливо: domain-wide delegation дає сервісному акаунту доступ від імені користувачів домену в межах виданих scopes. Погодьте це з відповідальним за безпеку; наша CRM використовує лише вказану спільну скриньку. Документація Google щодо scopes. Перевірка: у Пошта → Обліковий запис видно скриньку й час синхронізації; тестовий лист можна прочитати та надіслати відповідь.

5. Google-вхід для співробітників

Необов’язково. Це окремий OAuth 2.0 Client ID, а не JSON-ключ сервісного акаунта для Drive/Gmail. Вхід працює лише для співробітників, яких уже завели в CRM із відповідним email.

1. У Google Cloud Console → Clients налаштуйте OAuth branding і створіть клієнт типу Web application.
2. У Authorized JavaScript origins додайте точну HTTPS-адресу CRM без шляху, наприклад https://crm.example.ua. У поточному режимі Google Identity Services повертає credential у JavaScript callback, тому окремий redirect URI для цього входу не потрібен.
3. Передайте нам Client ID виду …apps.googleusercontent.com і, якщо потрібно обмежити вхід, домен корпоративних email. Client secret і JSON тут не потрібні. Інструкція Google.

Перевірка: заведений співробітник входить через Google, а незаведений — не отримує доступу. Детальніше: Google-вхід.

6. Нова пошта: створення накладних

Необов’язково. Довідник міст і відділень та калькулятор доступні без ключа; ключ потрібен для створення ТТН від вашого відправника.

1. Зареєструйте або перевірте компанію/ФОП і контакт відправника в бізнес-кабінеті Нової пошти.
2. Там само: Налаштування → Безпека → Створити ключ → Отримати API Key.
3. Передайте ключ захищеним каналом. Звичайним повідомленням дайте місто відправки та номер відділення, з якого фактично здаєте посилки. Внутрішні Ref/UUID Нової пошти шукати й передавати не потрібно — CRM визначить їх за ключем.

Перевірка: у Налаштування → Нова пошта видно правильне відділення та контакт; тестова накладна створюється без помилки. Не створюйте бойову ТТН без погодження конкретного тестового відправлення.

7. Банк: автоматичне виявлення оплат

Необов’язково для старту — оплати можна вносити вручну. Для автоматичної перевірки нам потрібні IBAN кожного рахунку та доступ до його виписки. CRM використовує токени тільки для читання виписки; сам банк може визначати ширші права токена. Не передавайте пароль або одноразовий код входу.

Monobank (ФОП)

1. Власник рахунку авторизується в особистому кабінеті API monobank і створює персональний API token. Це token для виписки особистого/ФОП рахунку, а не merchant token еквайрингу.
2. Передайте token захищеним каналом і вкажіть IBAN рахунків, які потрібно перевіряти. Технічний account id ми визначимо через API разом із вами.

ПриватБанк (ФОП/бізнес)

1. Увійдіть у Приват24 для бізнесу → Облік та звіти → Інтеграція (Автоклієнт), підключіть API-додаток і отримайте token. Покрокова інструкція ПриватБанку.
2. Передайте token захищеним каналом і вкажіть IBAN рахунків, виписку яких слід підключити.

Для обох банків повідомте, з якої дати потрібно звіряти платежі та хто в друкарні перевірятиме перші надходження. Ми налаштовуємо окрему перевірку кожного рахунку; секрети зберігаються поза CRM. Є також режим прийому оплат від окремого зовнішнього банківського сервісу — його налаштовуємо індивідуально. Перевірка: контрольний платіж з’являється в «Платежі» рівно один раз і потрапляє до правильного ФОП/рахунку. Докладніше: банківська інтеграція.

8. Якщо переносите дані з Bitrix24

Це окремий одноразовий етап, не вимога для нової порожньої CRM. Узгодьте з нами перелік контактів, угод і файлів та дату, після якої працюєте вже в BrightPrint.

Якщо імпорт іде через API, адміністратор Bitrix24 створює вхідний webhook: Applications → Developer resources → Common use cases → Other → Inbound webhook. Надайте доступ до CRM і користувачів лише в обсязі, потрібному для узгодженого перенесення, та передайте секретний URL захищеним каналом. Офіційна інструкція Bitrix24. Після завершення імпорту webhook можна відкликати. Альтернатива — погоджений експорт; спосіб визначаємо після оцінки ваших даних.

Що підтвердити перед запуском

• Бот сповіщень працює; співробітники знають, як підключити його в профілі.
• Якщо замовили Business — окремий бот і потрібні Premium-акаунти підключені.
• Тестовий файл з’явився на Спільному диску; за потреби перевірено Gmail.
• Google-вхід, Нова пошта й банки перевірені, якщо їх замовили.
• Власник друкарні звірив ФОП, IBAN, тексти реквізитів та права персоналу.
• Узгоджено дату запуску, відповідальну людину й спосіб зв’язку при помилці.

Далі — перші кроки після реєстрації.