Розробка бота Instagram з інтеграцією Бітрікс24 під ключ

При отриманні webhook-події сервер повинен відповісти 200 OK. У запиті міститься JSON з полями sender.id (IGSID) та message.text. Приклад:

{ "entry": [{ "id": "IG_ACCOUNT_ID", "messaging": [{ "sender": { "id": "IG_USER_IGSID" }, "recipient": { "id": "IG_ACCOUNT_ID" }, "timestamp": 1710000000000, "message": { "mid": "aWdfZAG9...", "text": "Скільки коштує доставка?" } }] }] } 

IGSID — унікальний ID користувача в межах вашого додатка. Профіль отримується через Graph API: https://graph.instagram.com/{igsid}?fields=name,username&access_token=.... Він повертає ім'я та @handle, але не email або телефон.

Як бот обробляє повідомлення?

Прийом повідомлень через webhook

Код отримання та обробки webhook:

{ "entry": [{ "id": "IG_ACCOUNT_ID", "messaging": [{ "sender": { "id": "IG_USER_IGSID" }, "recipient": { "id": "IG_ACCOUNT_ID" }, "timestamp": 1710000000000, "message": { "mid": "aWdfZAG9...", "text": "Скільки коштує доставка?" } }] }] } 

IGSID (Instagram-Scoped ID) — унікальний ID користувача для вашого додатка. Це не публічний Instagram ID.

Отримання профілю користувача Instagram

$profile = json_decode(file_get_contents( "https://graph.instagram.com/{$igsid}?fields=name,username&access_token=" . IG_ACCESS_TOKEN ), true); // Повертає: name (display name), username (@handle) 

Такий підхід легкий, але не дає email або телефон. Ці дані ми отримуємо через сценарій кваліфікації.

Сценарії взаємодії: автоматичні відповіді та ice breakers

Автовідповідь на згадування в Stories

При згадуванні вашого акаунта в Stories приходить webhook-подія messaging_referral з type=STORY_MENTION. Бот може автоматично подякувати:

if ($event['type'] === 'STORY_MENTION') { sendIgMessage($igsid, "Дякуємо, що відзначили нас у Stories! 🙌 Хочете дізнатися про актуальні акції?"); logLeadSource($igsid, 'story_mention'); } 

Story mentions — теплі ліди: людина вже взаємодіяла з брендом.

Ice breakers: питання при першому відкритті діалогу

Через API додатка налаштовуються підказки, які користувач бачить при першому відкритті діалогу з бізнес-акаунтом:

callMetaApi('me/messenger_profile', 'POST', [ 'platform' => 'instagram', 'ice_breakers' => [ ['call_to_actions' => [ ['type' => 'postback', 'title' => 'Дізнатися про доставку', 'payload' => 'DELIVERY_INFO'], ['type' => 'postback', 'title' => 'Залишити заявку', 'payload' => 'LEAVE_REQUEST'], ['type' => 'postback', 'title' => 'Переглянути каталог', 'payload' => 'CATALOG'], ]], ], ]); 

Ice breakers скорочують час першої відповіді та збільшують конверсію.

Як відбувається інтеграція з Бітрікс24?

Сценарій кваліфікації ліда

1. Вхідне повідомлення.
2. Якщо стан відсутній — привітання + швидкі відповіді.
3. При виборі "Хочу замовити" — запит телефону/email.
4. Створення ліда в Бітрікс24 та повідомлення менеджера.
5. Відповідь: "Менеджер зв'яжеться з вами протягом години".

Стани діалогу зберігаються в Redis за ключем ig_dialog:{igsid}. TTL — 24 години (вікно активності в Instagram).

REST API Бітрікс24: створення ліда та активності

Інтеграція реалізується за допомогою REST API Бітрікс24:

function createInstagramLead(string $igsid, string $username, array $data): int { return $b24->callMethod('crm.lead.add', [ 'fields' => [ 'TITLE' => "Instagram: @{$username}", 'SOURCE_ID' => 'WEBFORM', 'SOURCE_DESCRIPTION' => 'Instagram Direct', 'PHONE' => !empty($data['phone']) ? [['VALUE' => $data['phone'], 'VALUE_TYPE' => 'WORK']] : [], 'EMAIL' => !empty($data['email']) ? [['VALUE' => $data['email'], 'VALUE_TYPE' => 'WORK']] : [], 'COMMENTS' => "Instagram: @{$username}\nIGSID: {$igsid}", 'UF_CRM_IG_IGSID' => $igsid, ], ])['result']; } // Історія переписки — в активність $b24->callMethod('crm.activity.add', [ 'fields' => [ 'OWNER_TYPE_ID' => 1, 'OWNER_ID' => $leadId, 'TYPE_ID' => 4, 'SUBJECT' => "Instagram Direct: @{$username}", 'DESCRIPTION' => implode("\n", $dialogMessages), ], ]); 

Ліду присвоюється джерело "Instagram Direct", що дозволяє відстежувати ефективність каналу.

Чому варто автоматизувати Instagram Direct?

Автоматизація скорочує час відповіді з 30 хвилин до 5 секунд. Бот обробляє до 80% типових питань, розвантажуючи менеджерів. Всі ліди потрапляють в CRM без ручного введення, що виключає втрати. Менеджери продовжують діалог з Бітрікс24, бачачи всю історію переписки. Знижується вартість обробки заявки, а конверсія в угоду зростає. Отримайте консультацію по вашому проекту — ми допоможемо оцінити економію бюджету.

Як ми прискорюємо проходження рев'ю Meta?

Досвідчені розробники готують документацію та тестовий акаунт заздалегідь: надаємо скріншоти сценаріїв, відео роботи бота. Це скорочує перевірку до 3–5 робочих днів. Ми гарантуємо, що ваш бот відповідає політикам платформи, — рев'ю проходить з першої спроби.

Терміни та вартість

Разом: 2–3 тижні з урахуванням рев'ю Meta.

Що входить в роботу

• Проектування архітектури та схеми діалогу.
• Розгортання webhook-сервера та налаштування HTTPS.
• Реалізація всіх сценаріїв (ice breakers, кваліфікація, story mentions).
• Інтеграція з Бітрікс24 через REST API (ліди, активності, повідомлення).
• Документування API та інструкція для менеджерів.
• Допомога в проходженні рев'ю Meta.
• Тестування та відлагодження в пісочниці.
• Гарантія на код та підтримка після запуску.

Замовте розробку бота Instagram з інтеграцією Бітрікс24. Отримайте персональну оцінку термінів та вартості. Зв'яжіться з нами для обговорення деталей.