Көмек

Жұмысты бастау

Тіркелуден бірінші жауап берген тұтынушыға дейін — алты қадам. Бірінші тіркеу кезінде сіз толық рұқсаты бар бір айлық сынақ нұсқасын аласыз.

Арналарды қосу

Әр арнаға арналған қадамдық нұсқаулықтар. Арналар бақылау тақтасындағы «Арналар» бөлімінде әр сайтқа (виджет) қосылған; арна сақталғаннан кейін Smartbtn платформаның хабарларды қабылдайтынын тексереді. Әрбір арнадан хабарлар «Сөйлесулерге» келеді.

Telegram ботыСізге қажет: @BotFather боты, оның пайдаланушы аты және таңбалауышы.6 қадам → ВК қауымдастығыСізге қажет: қауымдастыққа кіру кілті және қауымдастық сілтемесі немесе идентификаторы.5 қадам → MAX ботСізге қажет: business.max.ru сайтында расталған ұйым, бот лақап аты және таңбалауышы.6 қадам → WhatsApp Business (Cloud API)Сізге қажет: WhatsApp бар Meta Business қолданбасы, нөмір, телефон нөмірі идентификаторы, WABA идентификаторы және тұрақты токен.6 қадам · шамамен 10 минут → Avito тіркелгілеріСізге қажет: сәйкес жазылымы бар Avito тіркелгісі; Avito арқылы авторизация.4 қадам → CIANСізге қажет: «Негізгі» CIAN жоспары, CIAN API кілті және тіркелгі мекенжайы.5 қадам → Facebook MessengerСізге қажет: ұзақ мерзімді Бетке кіру белгісі және Бет мекенжайы.5 қадам → Viber ботыСізге қажет: коммерциялық Viber боты, оның URI және таңбалауышы (қолданба кілті).5 қадам → Жарайды топСізге қажет: кіру кілті және топ диалогының сілтемесі.6 қадам → AliExpressСізге қажет: AliExpress сатушы тіркелгісінен API таңбалауышы және дүкен мекенжайы немесе идентификаторы.5 қадам → Бизнеске арналған Apple MessagesСізге қажет: Infobip‑ке байланыстырылған Бизнеске арналған хабарлар тіркелгісі, Apple Business ID және Infobip API кілті.7 қадам → WordPress және басқа CMSВиджет кодын CMS көмегімен құрастырылған сайтқа орнату.3 қадам →

Telegram боты

Тұтынушылар сіздің ботыңызға Telegram‑да жазады, сіз Smartbtn‑ден жауап бересіз — жауап Telegram‑да келеді.

1. @BotFather көмегімен бот жасаңызTelegram бағдарламасында @BotFather ашыңыз, /newbot пәрменін жіберіп, боттың аты мен пайдаланушы атын орнатыңыз. Пайдаланушы аты «ботпен» аяқталуы керек.
2. Белгішені көшіріңізBotFather 123456:AAH… сияқты таңбалауышты жібереді — оны толығымен көшіріңіз.
3. Боттың пайдаланушы атын енгізіңізБақылау тақтасында «Арналарды» ашыңыз, Telegram таңдаңыз және @сыз боттың пайдаланушы атын енгізіңіз.
4. Белгішені қойыңызТокенді «Бот белгісі» өрісіне қойыңыз.
5. Telegram‑ды қосыңыз«Telegram‑ды қосу» түймесін басыңыз. Smartbtn Telegram‑дан боттың жауап беретінін сұрайды — жасыл белгі оның жауабынан кейін ғана пайда болады.
6. Ботқа жіберу/бастауTelegram‑да ботты ашып, жіберіңіз /бастаңыз. Осыдан кейін ол тұтынушылармен сөйлесе алады.

ВК қауымдастығы

VK қауымдастығыңызға хабарламалар Smartbtn‑ге келеді; Жауаптар қауымдастық атынан ВК-ға оралады. Бірнеше қауымдастықты қосуға болады.

1. Қауымдастыққа кіру кілтін жасаңызҚауымдастықта «Басқару» → «Қосымша» → «API пайдалану» → «Кіру токендері» қойындысын → «Токен жасау» тармағын ашыңыз. «Қауымдастық хабарламалары», «Қауымдастықты басқару», «Фотосуреттер», «Құжаттар» құқықтарын белгілеп, «Жасау» түймесін басыңыз; VK қолданбасында немесе SMS арқылы растаңыз.
2. Кілтті қойыңызБақылау тақтасында «Арналар» → VK ашыңыз және кілтті «Қауымдастық белгісі» өрісіне қойыңыз.
3. Қауымдастықты көрсетіңіз«Қауымдастық сілтемесі немесе идентификаторы» өрісіне қауымдастық мекенжайын (мысалы, vk.com/club123456) немесе оның сандық идентификаторын қойыңыз.
4. Қауымдастықты қосыңыз«Қосылу» түймесін басыңыз. Хабарларды қабылдау (Callback API, message_new оқиғасы) автоматты түрде конфигурацияланады — басқа ештеңе істемейді.
5. ТексеруҚауымдастыққа сынақ хабарламасын жіберіңіз — ол «Сөйлесулерде» пайда болуы керек.

MAX бот

MAX мессенджеріндегі ботқа хабарламалар Smartbtn‑ге келеді, жауаптар MAX‑ке оралады.

1. MAX серіктес платформасында бот жасаңызbusiness.max.ru (немесе «Бизнеске арналған MAX» шағын қолданбасы) сайтына кіріңіз, ұйымыңыздың, жеке кәсіпкердің немесе өзін-өзі жұмыспен қамтыған адамның (Ресей тұрғындары үшін қолжетімді) профилін жасаңыз және растаңыз, содан кейін «Чат боттарында» «Жасау» түймесін басыңыз.
2. Бот картасын толтырыңызЛоготипті жүктеп салыңыз, атау мен сипаттаманы орнатыңыз. Лақап ат автоматты түрде жасалады (мысалы, idINN_bot). Жасалғаннан кейін бот модерациядан өтеді.
3. Белгішені көшіріңізМодерациядан кейін «Чат боттары» → сіздің ботыңыз → ⋮ → «Параметрлер» тармағын ашып, таңбалауышты көшіріңіз.
4. Бот лақап атын енгізіңізБақылау тақтасында «Арналар» → MAX ашыңыз және лақап атын @сыз енгізіңіз.
5. Белгішені қойыңызТокенді «Бот белгісі» өрісіне қойыңыз.
6. Сақтау«Параметрлерді сақтау» түймесін басыңыз.

WhatsApp Business (Cloud API)

WhatsApp ресми Meta WhatsApp Business Cloud API арқылы қосылған: бір нөмір сөйлесулерге жауап береді және бекітілген үлгілері бар хаттарды жібереді. «Қосылымдар» бөлімінде орнату шамамен 10 минутты алады.

1. Мета қолданбасын жасаңызMeta for Developers қолданбасында бизнес қолданбасын жасаңыз (немесе бар қолданбаны пайдаланыңыз) және WhatsApp өнімін қосыңыз.
2. Нөмірді қосыңызWhatsApp → API орнату: нөміріңізді қосыңыз (оны WhatsApp қолданбасында қолданбау керек), оны кодпен растаңыз және дисплей атауын бекітуді күтіңіз.
3. Идентификаторларды көшіріңізТелефон нөмірі идентификаторы мен WhatsApp бизнес тіркелгісінің идентификаторын көшіріңіз.
4. Тұрақты белгіні жасаңызMeta Business → Параметрлер → Жүйе пайдаланушылары: әкімші жасаңыз, оған қолданба мен WhatsApp тіркелгісін беріңіз, whatsapp_business_messaging және whatsapp_business_management рұқсаттарымен мерзімі ешқашан аяқталмайтын белгіні жасаңыз.
5. Сақтау және тексеруБақылау тақтасында «Байланыстар» → WhatsApp ашыңыз, деректерді қойыңыз және «Сақтау және тексеру» түймесін басыңыз.
6. Кіріс хабарламаларды қосыңыз«Автоматты түрде қосылу» түймесін басып, жауаптар мен жіберулер үшін сайттарды (жобаларды) таңдаңыз.

Avito тіркелгілері

Avito чаттары тіркелгілер арқылы қосылған: әрбір тіркелгі Avito‑да жеке авторизация болып табылады, бірнеше қосуға болады. Avito жазылымы қажет: Тауарлар мен жұмыс орындары үшін «Максималды», қызметтер үшін «Кеңейтілген» немесе «Максималды».

1. Тіркелгіні атаңыз«Арналар» → Avito тармағында тіркелгі атауын енгізіңіз (50 таңбаға дейін) — бұл тіркелгілерді бір‑бірінен ажыратуға көмектеседі.
2. Есептік жазбаны қосыңыз«Тіркелгі қосу» түймесін басыңыз — Avito авторизациясы беті ашылады.
3. Қол жеткізуОң жақ Avito тіркелгісіне кіріп, Avito мессенджеріндегі хабарларды оқу және өзгерту құқықтарын тексеріп, «Қолданбаға рұқсат беру» түймесін басыңыз.
4. Есептік жазбаларды басқаруҚосымша тіркелгілерді қосыңыз немесе қажетсіздерін жойыңыз — тізім сол бетте.

CIAN

CIAN есептік жазбаңыздан келген хабарлар Smartbtn қызметіне келеді.

1. CIAN API кілтін алыңыз«Негізгі» жоспар қажет. CIAN тіркелгісінде API бөлімін ашып, «API кілтін алу» түймесін басыңыз.
2. Электрондық поштаңыздағы кілтті табыңызCIAN тіркелгінің электрондық поштасына ACCESS KEY жібереді. Сондай‑ақ my.cian.ru/settings/chats сайтында хабарларды қабылдау қосылғанын тексеріңіз.
3. Есептік жазба мекенжайын енгізіңіз«Арналар» → CIAN ішіне CIAN тіркелгі мекенжайын қойыңыз.
4. Кілтті қойыңызКілтті «CIAN API кілті (ACCESS KEY)» өрісіне қойыңыз.
5. Сақтау«Параметрлерді сақтау» түймесін басыңыз.

Facebook Messenger

Messenger қолданбасындағы Facebook парақшаңызға жіберілген хабарлар Smartbtn қызметіне келеді. Messenger тұтынушы хабарламасынан кейін 24 сағат ішінде еркін жауап беруге мүмкіндік береді.

1. Messenger таңдаңыз«Арналар» бөлімінде Messenger белгішесін басыңыз.
2. Бет белгісін алыңызӘзірлеушілерге арналған мета нұсқаулығы бойынша ұзақ мерзімді Бетке кіру таңбалауышын алыңыз.
3. Бет мекенжайын енгізіңізFacebook парақшасының мекенжайын «Facebook бетінің мекенжайы» өрісіне қойыңыз.
4. Белгішені қойыңызБет таңбалауышын «Құпия кілт» өрісіне қойыңыз.
5. Сақтау«Параметрлерді сақтау» түймесін басыңыз.

Viber боты

Viber ботыңызға хабарламалар Smartbtn‑ге келеді.

1. Viber таңдаңыз«Арналар» бөлімінде Viber белгішесін басыңыз.
2. Viber ботын алыңыз2024 жылдың 5 ақпанынан бастап Viber боттары тек коммерциялық шарттарда жасалады: тікелей Viber қызметіне немесе оның ресми серіктесі (developers.viber.com) арқылы хабарласыңыз. Токен Viber‑де: Қосымша → Параметрлер → Боттар → Ақпаратты өңдеу → «Қолданбаңыздың кілті».
3. Бот URI кодын енгізіңізБот URI кодын (viber://pa?chatURI=… сілтемелеріндегі сияқты) «Bot URI» өрісіне қойыңыз.
4. Белгішені қойыңызҚолданба кілтін «Бот белгісі» өрісіне қойыңыз.
5. Сақтау«Параметрлерді сақтау» түймесін басыңыз.

Жарайды топ

OK тобына жіберілген хабарлар Smartbtn қызметіне келеді.

1. Кіру кілтін алыңызOK API нұсқаулығында сипатталғандай топқа кіру кілтін алыңыз.
2. OK таңдаңыз«Арналар» бөлімінде OK белгішесін басыңыз.
3. Топ мекенжайын енгізіңізТоп параметрлерінде «Топтың диалогтық терезесіне тікелей сілтеме» ішінен group/58269558636565/messages сияқты бөлікті көшіріп, оны «Топтың мекенжайы» өрісіне қойыңыз.
4. Кілтті қойыңыз1-қадамдағы кілтті «Кіру кілті (таңбалауыш)» өрісіне қойыңыз.
5. Сақтау«Параметрлерді сақтау» түймесін басыңыз. Вебхук автоматты түрде тіркеледі.
6. ТексеруSmartbtn OK хабарламаларды қабылдауды растағанын көрсетеді. Топқа сынақ хабарламасын жіберіңіз — ол «Сөйлесулерде» пайда болады.

AliExpress

AliExpress‑тен сатып алушының хабарламалары Smartbtn‑ге келеді.

1. API токендері бетін ашыңызСатушы тіркелгісіне (seller.aliexpress.ru) кіріп, seller.aliexpress.ru/token‑management/active ашыңыз.
2. Токен жасаңыз«Токен жасау» түймесін басыңыз, содан кейін таңбалауышты басып, оны көшіріңіз.
3. Дүкенді көрсетіңіз«Арналар» → AliExpress дүкенінің мекенжайын немесе идентификаторыңызды енгізіңіз.
4. Белгішені қойыңызБелгішені «API таңбалауышы» өрісіне қойыңыз.
5. Сақтау«Параметрлерді сақтау» түймесін басыңыз.

Apple Messages for Business

Apple Messages for Business (бұрынғы Business Chat) хабарлары Smartbtn‑ге Infobip провайдері арқылы келеді: Apple бизнеске тікелей кіруге мүмкіндік бермейді.

1. Apple компаниясына тіркеліңізApple Business Register жүйесінде (register.apple.com) ұйымды тіркеңіз және Messages for Business тіркелгісін жасаңыз; Хабар алмасу қызметінің провайдері ретінде Infobip таңдаңыз.
2. Тіркелгіні Infobip бағдарламасымен байланыстырыңызЕсептік жазбаны Infobip тіркелгісімен байланыстырыңыз және Apple мақұлдауын күтіңіз — күй ONLINE болады.
3. Infobip негізгі URL мекенжайын енгізіңіз«Арналар» → Бизнеске арналған хабарлар ішіне Infobip негізгі URL мекенжайын қойыңыз (мысалы, xxxxx.api.infobip.com).
4. Apple Business ID енгізіңізОны Apple Business Register‑ге көшіріңіз: Messages for Business тіркелгісі → «Сілтемелер» → «Идентификаторды көшіру».
5. Infobip API кілтін қойыңызInfobip (API кілтін басқару) ішінде API кілтін жасаңыз және оны қойыңыз — кері шақыру URL мекенжайы төменде пайда болады.
6. Infobip ішінде кері шақыру URL мекенжайын орнатыңызInfobip ішінде: Арналар мен нөмірлер → Арналар → Бизнеске арналған Apple хабарлары → Жіберушілер → ⋮ → Кіріс конфигурацияларын өңдеу → HTTP мекенжайына қайта бағыттау, кері қоңырау шалу URL мекенжайын қойыңыз.
7. Сақтау«Параметрлерді сақтау» түймесін басыңыз.

WordPress, Tilda және басқа CMS

Виджет бір орнату кодымен орнатылған — ол кез келген сайтта және CMS‑те жұмыс істейді.

1. Орнату кодын көшіріңізБақылау тақтасында «Виджетті» ашыңыз және орнату кодын көшіріңіз.
2. Оны сайтқа қойыңызКодты жабу тегіне дейін әрбір бетке қосыңыз: WordPress жүйесінде — тақырып (footer.php) немесе үстіңгі деректемеге/колонтитулға код енгізуге арналған кез келген плагин арқылы; басқа CMS‑де — теңшелетін HTML/JS кодының өрісінде.
3. ТексеруСайтты ашыңыз — түйме пайда болады; одан әрі дизайн өзгерістері кодты қайта орнатусыз бақылау тақтасында жасалады.

Білім базасы

Көмектеседі, ұсынады, үйретеді. Теруді бастау — терген кезде тізім сүзеді.

smartbtn_widget_api.setContactInfo({
  name: «Алекс Морган»,
  email: "email@example.com",
  phone: "+17584987855",
  description: "Description text"
});

smartbtn_widget_api.setCustomData([
  {
    title: "Actions",
    content: "Add contact",
    link: "https://crm.example.com/contacts/new"
  },
  {
    content: "Open customer profile",
    link: "https://crm.example.com/customers/42"
  }
]);

curl -H "Authorization: Bearer <token>" https://<host>/api/v1/chats

// → { "data": [...], "next_cursor": "..." | null }

• Браузердің мекенжай жолағы жоқ дербес PWA терезесі, Dock белгісі және Web Push хабарландырулары
• Барлық құралдарға жылдам қол жеткізу: WhatsApp, Telegram, Instagram, Messenger, AI екінші ұшқышы, чатбот, кері қоңырау шалу, бағыттар, баға
• Жаңа хабарлар мен кері қоңырау шалу сұраулары үшін push хабарландырулары
• Операторды бақылау, SLA таймерлері және статистика — тікелей қолданбада

Бізге хабарласыңыз

Сұрақ немесе ұсыныс бар ма? Бізге жазыңыз!

Компания мәліметтері

Келісімшарттар мен шот‑фактуралар үшін оператор мәліметтері.

Құқықтық құжаттар

Қызметті пайдалану және жеке деректерді өңдеу шарттары.