Разработка бота 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. Получите персональную оценку сроков и стоимости. Свяжитесь с нами для обсуждения деталей.