Свързване на Instagram

Преди свързване Instagram профилът трябва да е **Business** или **Creator**, не Personal. Превключването става от Instagram приложението — Settings → Account type and tools → Switch to professional account. Безплатно е и не променя как изглежда профилът ти за последователите. Подробна инструкция: вж. „Превключване към Instagram Business акаунт“.

В Dashboard → таб **Канали** има ред Instagram. Когато не е свързан, виждаш статус „Не е свързан“ и лилав бутон „Свържи“ отдясно. Кликаш бутона — отваря се модал със заглавие „Свържи Instagram“ и подзаглавие „Автоматично свързване с Meta“. Под него има секция „Преди да свържеш, увери се че имаш:“ с едно изискване — „Instagram Бизнес акаунт · Безплатен е — превключи от Настройки“.

В долния край на модала има два бутона: „Пълно ръководство стъпка по стъпка“ (отваря /guide в нов таб) и лилав CTA „Свържи с Instagram“. Под бутона стои бележка „Ще бъдеш пренасочен към Meta за оторизация“. Кликаш CTA-то.

За част от секундата виждаш черен екран с лилав spinner и текст „Connecting to Instagram…“. Това е интерстициална страница от наша страна — не е грешка. Тя съществува, защото на iOS директният HTTP redirect към instagram.com задейства Universal Links и хвърля потребителя в нативното Instagram приложение (където callback-ът никога не се връща). JS-инициираното пренасочване не задейства Universal Links и пуска login-а в браузъра. Ако стои повече от 2-3 секунди — има backup линк „If nothing happens, tap here“, който ще те откара ръчно.

Пренасочват те към `instagram.com/oauth/authorize` с параметрите: • `scope=instagram_business_basic,instagram_business_manage_messages` — точно 2 scope-а. (Преди искахме и `instagram_business_content_publish`, но Meta никога не го одобри — заявката с него тихо проваляше OAuth с „profile doesn't exist“, затова го свалихме.) • `enable_fb_login=false` — скрива опцията „Log in with Facebook“. Ако потребител има FB акаунт без свързан IG Business, този път също провалия OAuth с „profile doesn't exist“. • `force_reauth=true` — кара Instagram да поиска fresh login дори при активна сесия, така че да можеш да избереш правилния Business акаунт. Въвеждаш потребителско име/парола в IG, виждаш екран с заявените разрешения и кликаш Allow: • `instagram_business_basic` — четене на профил. • `instagram_business_manage_messages` — четене и пращане на DM. Без двете ботът не може да отговаря.

Връщаме те в dashboard-а. Ако всичко е минало — статусът на реда Instagram е зелен и виждаш handle-а на акаунта. Автоматично се абонираме за webhook-ите за съобщения и postbacks (`POST /v21.0/{ig-user-id}/subscribed_apps` с `subscribed_fields=messages,messaging_postbacks`) — без действие от твоя страна. Ако нещо се счупи на стъпката със subscribe, виждаш статус „Очаква настройка“ и бутон „Опитай пак“ — кликни го и ще пробваме отново.

**Десктоп flow-ът отгоре работи в един клик.** На телефон обаче има известен Instagram bug, който и LinkDM и други integrations имат: ако имаш активна Instagram сесия в мобилния браузър, `instagram.com/oauth/authorize` тихо те пренасочва обратно в `instagram.com` (feed) вместо да върне callback на raiceptionist.com. OAuth-ът никога не завършва, ботът остава несвързан. **Решението** (документирано от индустрията): завърши OAuth-а в **Private / Incognito таб**, където няма активна IG сесия. Там Instagram пита за нов login и flow-ът завършва нормално. За да не те караме да logнеш отново в raiceptionist.com от Private таба, имаме **bridge линк**: еднократен подписан URL, който автоматично те логва и веднага пуска IG OAuth-а.

Когато си на мобилен браузър и натиснеш „Свържи Instagram“, виждаш специален модал със заглавие „Свържи Instagram“ + Meta Verified Business app badge: **1. Копирай линка** — натискаш лилавия бутон „Копирай линка“. Bridge URL-ът (от `POST /api/auth/mobile-bridge`) е валиден **10 минути** и е **еднократен** (изтрива се след първа употреба). Автоматично се копира в clipboard-а; ако clipboard разрешенията липсват — копираш ръчно. **2. Отвори Private / Incognito таб** — • **Safari (iOS):** иконата с табове долу-вдясно → „Private“ → нов таб. • **Chrome:** меню „⋮“ → „New Incognito Tab“. **3. Залепи и Paste & Go** — дълго задържи в адресния бар → „Paste & Go“. Bridge URL-ът ни сетва signed session cookie и веднага редиректва към IG OAuth start endpoint-а. Нататък потокът е същият като desktop варианта (interstitial → instagram.com/oauth/authorize → approve → callback → dashboard).

• **Свържи** — не е свързан. • **Очаква настройка** (жълт badge) — OAuth мина, но webhook subscribe-ът не — натисни „Опитай пак“. • **Свързан** (зелен badge) — всичко работи; виждаш handle и menu бутон за disconnect. • **Токенът е изтекъл** (червен badge) — рядко; ако се случи, кликни disconnect и connect отново.

rAIceptionist е одобрен от Meta като Tech Provider от април 2026. Свързваш Instagram сам — без ръчен whitelist от наша страна.