Instagram Direct у CRM: покрокове підключення в Instagram, Facebook, Meta for Developers і BeeSection

Половина записів у салоні починається з «а є вільне на суботу?» в директі. Коли директ живе на телефоні адміністратора, переписка відірвана від CRM: не видно, хто цей клієнт, скільки разів приходив і чи не скасовував минулого разу. Після підключення повідомлення з директу з'являються в розділі «Чати», а відповідь з CRM приходить клієнту в Instagram.

Підключення займає 40–60 хвилин уперше і робиться з комп'ютера. Більша частина кроків — в Instagram, Facebook і Meta for Developers: це вимоги Meta, без них жодна CRM директ не отримає. Нижче все по порядку, з тим, що саме натискати.

Чати доступні на тарифах Salon і Network.

Що вийде в результаті

• Повідомлення з директу з'являється в «Чатах» з ім'ям і фото профілю Instagram.
• Відповідь з CRM приходить клієнту в директ за кілька секунд. Якщо Instagram її не прийняв, повідомлення позначається «Не надіслано», і його можна повторити.
• Новий співрозмовник отримує картку клієнта з іменем з Instagram, поки без телефона. Якщо людина надішле в директ номер, який уже є в базі, переписка прив'яжеться до наявної картки.
• Сповіщення. Співробітники з доступом до чатів отримують «Нове повідомлення в чаті» в дзвіночок і на телефон.
• Фото, відео й аудіо з директу зберігаються в чаті одразу при отриманні.

На перше повідомлення людини автовідповідь не йде: шаблон за замовчуванням звучить як «Раді бачити вас знову», а людина пише вперше. На наступні — за загальними правилами автовідповіді.

Перед початком: чек-лист

• Акаунт Instagram салону, до якого у вас є логін і пароль.
• Особистий акаунт Facebook людини, яка підключає. Він має бути адміністратором сторінки салону.
• Тариф BeeSection Salon або Network.
• Комп'ютер: у Meta for Developers з телефона працювати незручно.
• Другий акаунт Instagram для перевірки: з нього ви напишете салону «як клієнт».

Збережіть десь поруч блокнот: по дорозі знадобиться скопіювати чотири значення — секрет застосунку, токен сторінки, слово для перевірки вебхука й адресу вебхука.

Крок 1. Професійний акаунт Instagram

Особистий акаунт Instagram повідомлень сторонній програмі не віддає. Потрібен професійний: «Автор» або «Бізнес».

1. У застосунку Instagram відкрийте профіль салону → меню ☰ → «Налаштування і діяльність».
2. Розділ «Тип акаунта та інструменти» → «Перейти на професійний акаунт».
3. Виберіть категорію (наприклад, «Салон краси») і тип «Бізнес» або «Автор».

Якщо в профілі вже є кнопки «Інструменти для професіоналів» або «Статистика», акаунт уже професійний — переходьте далі.

Крок 2. Сторінка Facebook і прив'язка Instagram

Директ потрапляє до CRM через сторінку Facebook, прив'язану до Instagram. Окремого входу «лише через Instagram» у нас немає.

1. Якщо сторінки Facebook у салону немає, створіть її: facebook.com → «Сторінки» → «Створити нову сторінку». Достатньо назви й категорії.
2. Прив'яжіть Instagram до сторінки. Найпростіше з комп'ютера: відкрийте сторінку → «Налаштування» → «Пов'язані акаунти» → Instagram → «Під'єднати акаунт» і увійдіть в акаунт салону.
3. Переконайтеся, що ваш особистий Facebook — адміністратор сторінки з повним доступом. Без цього токен сторінки не видасться.

Назви пунктів у Facebook час від часу змінюються. Якщо не знайшли «Пов'язані акаунти», пошукайте в налаштуваннях сторінки слово «Instagram» або зробіть прив'язку в Meta Business Suite: «Налаштування» → «Акаунти Instagram».

Крок 3. Дозвольте доступ до повідомлень в Instagram

Це окремий перемикач, і його найчастіше пропускають. Поки він вимкнений, Instagram не віддає повідомлення директу жодній програмі, навіть коли все інше налаштовано правильно.

1. У застосунку Instagram салону: меню ☰ → «Налаштування і діяльність» → «Повідомлення та відповіді на історії».
2. «Підключені інструменти» (або «Інструменти для повідомлень») → увімкніть «Дозволити доступ до повідомлень».

Крок 4. Застосунок у Meta for Developers

Instagram пускає CRM до повідомлень лише через застосунок, зареєстрований у Meta. Він ваш: ключі від нього лишаються у вас, а BeeSection отримує лише токен сторінки.

1. Відкрийте developers.facebook.com і увійдіть тим самим Facebook, що адмініструє сторінку. Якщо ви тут уперше, Meta попросить зареєструватися як розробник: підтвердіть телефон і пошту.
2. «Мої застосунки» → «Створити застосунок».
3. Якщо Meta питає про сценарій використання, виберіть «Інше». Тип застосунку — «Бізнес». Назва — будь-яка, наприклад «BeeSection — Easy Peasy». Бізнес-портфоліо — ваш, якщо він є.
4. На панелі застосунку додайте продукти Messenger і Webhooks (кнопка «Налаштувати» біля кожного).
5. Відкрийте «Налаштування застосунку» → «Основне». Натисніть «Показати» біля «Секрет застосунку» (App Secret) і скопіюйте його в блокнот. Це секрет: не пересилайте його в месенджерах і не публікуйте.

Крок 5. Вічний токен сторінки

Токен сторінки — це «ключ», яким BeeSection надсилає ваші відповіді від імені сторінки. Важливо взяти саме довгостроковий токен: короткий живе близько години, і наступного дня відповіді перестануть іти.

1. Відкрийте Graph API Explorer: developers.facebook.com/tools/explorer.
2. Праворуч у полі «Застосунок Meta» виберіть свій застосунок із кроку 4. У полі «Користувач або сторінка» — «Отримати маркер доступу користувача».
3. Додайте дозволи: pages_show_list, pages_messaging, pages_manage_metadata, instagram_basic, instagram_manage_messages. Якщо сторінка в бізнес-портфоліо, додайте ще business_management.
4. Натисніть «Generate Access Token». Facebook покаже вікно входу: виберіть сторінку салону і пов'язаний Instagram, дозвольте все запитане.
5. Скопіюйте отриманий токен і відкрийте «Налагоджувач маркерів доступу»: developers.facebook.com/tools/debug/accesstoken. Вставте токен, натисніть «Налагодити», а внизу — «Продовжити маркер доступу». Скопіюйте новий, довгий токен.
6. Поверніться в Graph API Explorer, вставте довгий токен у поле токена і виконайте запит me/accounts. У відповіді знайдіть свою сторінку: значення access_token поруч із нею і є токен сторінки. Скопіюйте його в блокнот.
7. Перевірте його в налагоджувачі з пункту 5: у рядку «Термін дії» має бути «Ніколи». Якщо там дата — ви взяли не той токен, повторіть пункти 5–6.

Токен сторінки, отриманий так, не має терміну дії. Але він перестає працювати, якщо людина, яка його видала, змінить пароль Facebook або забере доступ застосунку. Тоді повторіть цей крок і вставте новий токен у BeeSection.

Крок 6. Підключення в BeeSection

1. «Налаштування» → «Інтеграції» → у каталозі виберіть Instagram Direct. (Поруч є «Facebook Messenger» і «Meta» — вони на тому ж коді, для директу беріть саме Instagram Direct.)
2. Заповніть поля:
   • Page Access Token (Long-Lived) — токен сторінки з кроку 5.
   • Webhook Verify Token — поле вже заповнене випадковим словом. Скопіюйте його в блокнот зараз: після збереження воно буде приховане. Можна вписати й своє слово, головне — запам'ятати.
   • App Secret (для перевірки підпису webhook) — секрет застосунку з кроку 4. Поле обов'язкове: без нього CRM відкидає всі повідомлення, бо не може переконатися, що їх надіслала саме Meta.
   • Instagram Business Account ID — можна залишити порожнім.
3. Натисніть «Підключити інтеграцію».

Перевірка підключення покаже назву сторінки і номер прив'язаного профілю Instagram. Якщо номера Instagram немає, Instagram не прив'язаний до цієї сторінки (крок 2) — директ не прийде.

Після підключення в картці з'явиться блок «Адреса для провайдера» — адреса вебхука виду https://api.beesection.com/chats/wh/meta/…. Скопіюйте її в блокнот. Не збирайте адресу вручну: у ній номери вашої компанії та інтеграції.

Крок 7. Вебхук у Meta

Вебхук — це адреса, на яку Meta надсилає кожне нове повідомлення з директу.

1. У Meta for Developers відкрийте свій застосунок → Webhooks.
2. У списку об'єктів виберіть Instagram і натисніть «Підписатися на цей об'єкт».
3. «URL зворотного виклику» — адреса з картки BeeSection. «Підтвердити маркер» — слово з поля Webhook Verify Token.
4. Натисніть «Підтвердити та зберегти». Meta одразу перевірить адресу. Якщо зберіглося — слово збіглося, адреса правильна.
5. У списку полів знайдіть messages і натисніть «Підписатися». За бажанням — також messaging_postbacks і messaging_referrals.

Якщо Meta пише, що адресу не вдалося перевірити, найчастіше слово для перевірки в Meta і в BeeSection відрізняється: перевірте пробіли на початку й у кінці.

Крок 8. Підпишіть сторінку на застосунок

Без цього кроку перевірка вебхука проходить, а повідомлення не приходять ніколи: Meta надсилає події лише для сторінок, підписаних на застосунок.

У BeeSection у картці Instagram Direct відкрийте «Додаткові дії» → «Підписати сторінку». Має з'явитися «Сторінку підписано на застосунок: повідомлення надходитимуть у CRM».

Крок 9. Перевірка тестовим акаунтом

Поки застосунок Meta в режимі розробки, Instagram надсилає в CRM повідомлення лише від людей, які мають роль у застосунку. Тому спочатку перевіряємо своїм другим акаунтом.

1. У Meta for Developers: застосунок → «Ролі застосунку» → «Ролі» → «Додати людей» → роль «Тестувальник Instagram» → введіть ім'я другого акаунта Instagram.
2. У застосунку Instagram цього другого акаунта прийміть запрошення: «Налаштування» → «Сайти і застосунки» (або «Застосунки та сайти») → «Запрошення тестувальника» → «Прийняти».
3. З другого акаунта напишіть у директ салону: «Тест 1».
4. У BeeSection відкрийте «Чати»: має з'явитися чат з ім'ям цього акаунта, повідомлення «Тест 1» і сповіщення в дзвіночку. У «Клієнтах» — нова картка без телефона.
5. Відповідайте з чату. Відповідь має прийти в директ за кілька секунд.
6. Надішліть із директу фото — у чаті воно має лягти фото.

Якщо на кроці 4 нічого немає, дивіться розділ «Якщо не працює» нижче.

Крок 10. Щоб писали всі клієнти: Live і перевірка Meta

Поки застосунок у режимі розробки, клієнти без ролі в застосунку пишуть у директ як звичайно, але в CRM ці повідомлення не потрапляють. Щоб приходило все, застосунок треба перевести в режим Live і пройти перевірку Meta (App Review).

1. Підтвердження бізнесу. У Meta Business Suite: «Налаштування бізнесу» → «Центр безпеки» → «Підтвердження бізнесу». Знадобляться назва, адреса й документ, що підтверджує діяльність (виписка, рахунок). Зазвичай кілька днів.
2. Налаштування застосунку → «Основне»: заповніть адресу політики конфіденційності, адресу інструкції з видалення даних, категорію й іконку застосунку. Політику конфіденційності можна розмістити на сайті салону.
3. App Review → «Дозволи та функції»: запросіть розширений доступ (Advanced Access) для instagram_manage_messages і pages_messaging. Для кожного Meta попросить коротко описати, навіщо він, і записати відео: клієнт пише в директ → повідомлення з'являється в «Чатах» BeeSection → адміністратор відповідає → відповідь приходить в Instagram. Перевірка триває від кількох днів до кількох тижнів.
4. Після схвалення перемкніть застосунок у режим Live перемикачем угорі панелі.

Від цього моменту в CRM потрапляють повідомлення від усіх клієнтів.

Як це працює щодня

• Вікно 24 години. Meta дозволяє відповідати в директ протягом доби після останнього повідомлення клієнта. Пізніше відповідь не піде і буде позначена «Не надіслано» — клієнт має написати знову. Тому на директ варто відповідати в той самий день.
• Хто бачить. Чати бачать співробітники з доступом до розділу «Чати». Сповіщення про нові повідомлення — у дзвіночок, на телефон і в Telegram, якщо його прив'язано в профілі.
• Запис. Надішліть у відповідь посилання на онлайн-запис — клієнт вибере час сам, див. «Посилання на запис у переписці». Якщо клієнт назвав телефон, додайте його в картку: тоді нагадування підуть і поза Instagram.
• Вкладення. Одне фото, відео чи аудіо зберігається в чаті. «Поділився публікацією», згадка в історії й reels лягають документом.

Якщо не працює

Обмеження

• Немає кнопки «Увійти через Facebook». Токен вставляється вручну за кроком 5.
• Токен не продовжується сам. Після зміни пароля Facebook його треба видати заново.
• Відповідь — лише протягом 24 годин після повідомлення клієнта, за правилами Meta.
• Картка клієнта заводиться на кожного, хто написав, включно зі спамом. Зайві картки можна видалити.
• Відповідь на конкретне повідомлення (reply) в CRM не прив'язується до вихідного повідомлення.

Якщо не виходить

Напишіть нам через кнопку «Незручно? Скажіть» у CRM і вкажіть, на якому кроці зупинилися. Підключимо разом: від вас знадобиться лише доступ адміністратора до сторінки Facebook на час налаштування.

Інші канали в тому самому вікні — Telegram, WhatsApp, пошта, веб-чат — описані в статті «Чати в одному вікні».