Bitrix24-ті Qenguru AI-ға қосу

Қадамдық нұсқаулық: Маркетплейстен орнату, OAuth арқылы қосу, CRM маршруттауын баптау.

Не аласыз

Бот диалогтарынан лидтер мен мәмілелер автоматты түрде жасалады
Контактілерді синхрондау: аты, телефоны, мессенджері
Хат алмасу тарихы клиент карточкасына жазылады
Open Lines — клиенттерге бастапқы қолдау көрсететін бот
Қайта келген клиенттер бұрынғы менеджерлеріне автоматты түрде бағытталады
CRM пайдаланушы өрістерін сәйкестендіру (маппинг)

Не дайындау керек

Bitrix24 порталындағы әкімші құқықтары
Qenguru аккаунты (аккаунтты менеджер береді — әлі жоқ болса, өтінім қалдырыңыз)
Боттың міндетін түсіну: не істеуі керек, кімге жауап беруі керек

Қадамдық нұсқаулық

1-қадам. QenguruAI қолданбасын Bitrix24 Маркетплейсінен орнатыңыз

Bitrix24 порталыңызды ашыңыз → Маркет → QenguruAI қолданбасын тауып, «Орнату» түймесін басыңыз. Қолданбаны тек портал әкімшісі орната алады (бұл қауіпсіздік талабы, себебі қолданба CRM-ге қолжетімділік сұрайды).

Орнатқаннан кейін порталдың сол жақ мәзірінде QenguruAI бөлімі пайда болады — соны басыңыз.

2-қадам. Qenguru-ға кіріңіз

Кіру беті ашылады. Email мен құпиясөз арқылы кіріңіз. Qenguru аккаунтыңыз әлі жоқ болса, оны менеджер береді: өтінім қалдырыңыз, біз сізді қосамыз.

Кіргеннен кейін Qenguru дашбордына өтесіз. Сол жақта ұйымдарыңыз бен агенттеріңіздің тізімі тұрады.

3-қадам. Агент жасаңыз немесе барын ашыңыз

Агент — клиенттеріңізбен сөйлесетін бот. Әр агенттің өз жүйелік промпты, білім қоры және арналар жиынтығы бар.

Керекті агентті ашыңыз → «Промпттар» қойындысы → «Промпт баптаулары» бөлімі. Мұнда жүйелік промпт (негізгі нұсқаулық: рөлі, ережелері, сөйлеу мәнері) және компания туралы мәліметтер беріледі: немен айналысады, мекенжайы, жұмыс уақыты.

Сәлемдесу, бастапқы промпт және техникалық қате кезіндегі хабарлама — «Агент шарттары» бөлімінде, жауап мәнері — «Агент мінез-құлқы» бөлімінде.

«Промпттар» қойындысы — жүйелік промпт және компания туралы мәліметтер

4-қадам. Байланыс арналарын қосыңыз

«Арналар» қойындысын ашыңыз. Мұнда бот клиенттерге жауап беретін арналар қосылады: 2ГИС пікірлері, Telegram Bot, Telegram (аккаунт), WhatsApp, Instagram, сайтқа арналған виджет (Website Chat), Wazzup, ChatApp, Email.

Әр арнаның өз «Қосу» түймесі бар. Қосу нұсқаулары тікелей интерфейсте көрсетіледі.

«Арналар» қойындысы — «Қосу» түймелері бар қолжетімді арналар

5-қадам. «Интеграциялар» бөлімін ашыңыз

«Интеграциялар» қойындысына өтіңіз. Оң жақ бағанда «Қосылмаған» күйіндегі Bitrix24 карточкасын және «Қосу» түймесін көресіз.

«Интеграциялар» қойындысы — Bitrix24 әлі қосылмаған

6-қадам. OAuth арқылы қосылыңыз

«Қосу» түймесін басыңыз — Bitrix24 терезесі «Қосылым» қойындысында ашылады. Bitrix24 порталыңыздың мекенжайын yourcompany.bitrix24.kz пішімінде (https:// қоспай) енгізіп, «Bitrix24 арқылы авторизация» түймесін басыңыз.

Рұқсат сұрайтын Bitrix24 терезесі ашылады — «Рұқсат беру» түймесін басыңыз. Авторизация сәтті өткен соң терезе өздігінен «CRM баптаулары» қойындысына ауысады — портал қосылғанға дейін ол бұғатталған.

Bitrix24 қосу терезесі — портал мекенжайы және «Bitrix24 арқылы авторизация» түймесі

7-қадам. Қосылым орнатылды

Авторизация сәтті өткен соң Bitrix24 карточкасында «Қосылған» күйі және порталыңыздың мекенжайы көрсетіледі. Карточкада «Ажырату» түймесі мен баптаулар белгішесі (тісті доңғалақ) пайда болады.

Bitrix24 қосылған — портал мекенжайы, «Ажырату» түймесі және баптаулар белгішесі

8-қадам. CRM-де маршруттауды баптаңыз

Bitrix24 карточкасындағы баптаулар белгішесін (тісті доңғалақ) басыңыз → «CRM баптаулары» қойындысы. Мұнда боттың CRM-мен қалай жұмыс істейтіні анықталады:

Жауапты пайдаланушы — жасалатын лидтер мен мәмілелер кімге тағайындалады.
Мәміле құбыры және әдепкі кезең — жаңа мәмілелер қайда түседі.
Алғашқы хабарламада синхрондау — контактіні автоматты түрде жасау.
Лидті / мәмілені автоматты жасау — бөлек ауыстырғыштар.
CRM синхрондауы — бүкіл интеграцияның негізгі ауыстырғышы.
Қайта келген клиенттерді бағыттау — клиент Bitrix24-те бұрыннан бар болса және оған менеджер тағайындалса, диалог автоматты түрде сол менеджерге беріледі.
Агент құралдары — диалог кезінде бот Bitrix24-те не істей алады: лид немесе мәміле жасау, клиентті іздеу, пікір қосу, диалогты операторға беру және т.б. Әр құрал бөлек ауыстырғышпен қосылады.

Өзгерістер бірден сақталады; терезенің төменгі жағында — «Дайын» түймесі.

«CRM баптаулары» қойындысы — жауапты пайдаланушы, мәміле құбыры, кезең, ауыстырғыштар

9-қадам. Басқа порталды қалай қосуға болады

Агентке бір Bitrix24 порталы қосылады. Қосылған интеграцияның «Қосылым» қойындысын ашсаңыз, «Bitrix24 қосылып қойған» деген хабарлама шығады. Порталды ауыстыру үшін алдымен Bitrix24 карточкасындағы «Ажырату» түймесін басыңыз, содан кейін жаңа порталды қайта қосыңыз (6-қадам).

Қосылған порталдың «Қосылым» қойындысы — «Bitrix24 қосылып қойған»

10-қадам. Дайын

Енді клиент қосылған арнаға (Telegram, WhatsApp, Instagram) әр жазған сайын QenguruAI:

Бапталған жүйелік промпт пен білім қоры арқылы клиентке жауап береді.
Bitrix24-те контакті жасайды («Алғашқы хабарламада синхрондау» қосулы болса).
Таңдалған мәміле құбыры мен кезеңде лид/мәміле жасайды.
Хат алмасу тарихын клиент карточкасына (түсініктемелерге немесе таймлайнға) жазады.
Триггер іске қосылғанда (кілт сөз, сәтсіз жауаптар шегінен асу және т.б.) диалогты менеджерге береді.

Жиі қойылатын сұрақтар

Қолданба қандай құқықтарды (scopes) сұрайды?: QenguruAI Bitrix24-тің мына бөлімдеріне қолжетімділік сұрайды: crm (контактілер, лидтер, мәмілелер), user (маршруттауға арналған пайдаланушылар туралы ақпарат), im (чат), imopenlines (ашық желілер), placement (интерфейске ендіру). Әр scope тек осы нұсқаулықта аталған функциялар үшін пайдаланылады.
Деректер физикалық түрде қайда сақталады?: Qenguru серверлері Амстердамда (DigitalOcean) орналасқан. Хат алмасу тарихы 12 айдан аспайтын мерзімге сақталады. Хабарламалардың мазмұны LLM-инференс үшін OpenAI, Anthropic және Google-ға беріледі. Толығырақ — Құпиялық саясатында.
Интеграцияны өшіруге бола ма?: Иә. «Интеграциялар» қойындысындағы Bitrix24 карточкасында «Ажырату» түймесін басыңыз — барлық OAuth-токендер жойылады, бот CRM-ге жазуды тоқтатады. Бұрын жасалған лидтер мен мәмілелер Bitrix24-те қалады (Qenguru оларды жоймайды).
Қолданбаны Bitrix24-тен жойғанда не болады?: Bitrix24 Qenguru серверіне ONAPPUNINSTALL оқиғасын жібереді — біз сақталған токендерді автоматты түрде кері қайтарып аламыз. Qenguru-дағы аккаунтыңыз сақталады, кейін басқа Bitrix24 порталын қайта қосуға болады.
Жаңа лидтерге жауапты менеджерді қалай ауыстыруға болады?: «CRM баптаулары» → «Жауапты пайдаланушы» ашылмалы тізімі → керекті қызметкерді таңдаңыз. Өзгеріс бірден сақталады және барлық жаңа диалогтарға қолданылады; бұрын жасалған лидтер мен мәмілелер өзгермейді.
Bitrix24-ке пайдаланушы өрістерін (custom fields) беруге бола ма?: Иә. «CRM баптауларында» «Пайдаланушы өрістері» бөлімі бар — бот айнымалысын (мысалы, клиенттің бюджеті, таңдалған өнім) Bitrix24-тегі өріске сәйкестендіріңіз. Бот лид немесе мәміле жасаған кезде бұл өрістерді автоматты түрде толтырады.
Бот жауап бермесе немесе лидтер жасалмаса, не істеу керек?: Тексеріңіз: (1) интеграция күйі — «Қосылған» болуы керек; (2) «CRM синхрондауы қосулы» негізгі ауыстырғышы; (3) лидтер күтсеңіз — «Лидті автоматты жасау» ауыстырғышы. Бәрі қосулы болса да ештеңе жұмыс істемесе, қолдау қызметіне жазыңыз.

Шықпады ма?

Қолдау қызметіне жазыңыз: support@qenguru.ai немесе WhatsApp +7 708 173 32 99. Сондай-ақ демонстрацияға тапсырыс беруге болады — 30 минутта баптауға көмектесеміз.