WhatsApp, Telegram, MAX және боттарға арналған бірыңғай API

Бір хабарлама — бір HTTP-сұраныс: WhatsApp, Telegram, MAX-қа немесе ботқа. Әр арнаға бөлек интеграцияның орнына бір келісімшарт: хат алысу тарихы, кіріс хабарламалар, таратулар, файлдар, ал статустар вебхукпен келеді.

WhatsApp, Telegram және MAX-та хабарлама мен тарату үшін API

Мессенджерлер API-інің мүмкіндіктері

  1. Транзакциялық хабарламалар

    Бір хабарлама — бір сұраныс: әр алушыға өз мәтініңіз бен тіркемеңіз, ал нәтижесі вебхукпен келеді

  2. Барлық арна — бір келісімшарт

    WhatsApp, Telegram, MAX аккаунттары QR-код не телефон нөмірі арқылы, Telegram, MAX, VK және Яндекс боттары токен арқылы қосылады; әрі қарай әдістер бірдей

  3. Сілтеме арқылы қосу

    Шақыру сұраныспен жасалады: клиент аккаунтын сілтеме арқылы, сіздің кабинетіңізге кірмей өзі қосады, ал арна id-і сізге қайтады

  4. Хат алысу тарихы

    Диалогтар мен хабарламалар бізде сақталады: тарих кәдімгі сұраныспен қайтады, мессенджерге барып, жауабын күтудің қажеті жоқ

  5. Жауаптар мен кіріс хабарламалар

    «Жауап берді» дегені ғана емес, мәтіні де: кіріс хабарлама оқиға болып келеді, оған сол жіберу әдісімен жауап беруге болады

  6. Жеткізілімді бақылау

    Әр хабарлама және таратудың әр алушысы бойынша жіберу, жеткізу және оқу статустары

  7. WebHook

    Оқиғалар туралы хабарландырулар — аккаунтты қосу, кіріс хабарламалар, таратудың жүрісі, алушылардың статустары — API-ді сұрап отырудың қажеті жоқ

  8. Базаға тарату

    Алушы көп болғанда: тарату құру, жобаны өңдеу, іске қосу, тоқтату және болдырмау — кезек пен қайталауды сервис атқарады

  9. Аудитория және дербестендіру

    Контакт сегменттері, нөмірлерді және өріс мәндерін — атын, қаласын, тапсырыс сомасын — жүктеу, олар мәтінге қойылады

  10. Жіберу қарқыны

    Қарқынды сіздің кодыңыз емес, автостратегия таңдайды: сервис жіберуді өзі созады және мессенджер аккаунтқа шектеу қойса, таратуды кідіртеді

  11. Аккаунт чекері

    Сервис нөмірдің мессенджерде бар-жоғын өзі тексереді: тіркелмегендері хабарлама алмайды және жеке статуспен қайтарылады

  12. Қолдау 24/7

    Интеграцияны енгізу мен мәселелерді шешуде жедел көмек

Мессенджерлер API-ін қалай қосуға болады

  1. 1 қадам

    Жеке кабинетке кіріңіз

    Сервисте құпия сөз жоқ: кіру Яндекс, Google арқылы немесе email бойынша.

  2. 2 қадам

    API кілтін жасаңыз

    Тарату кабинетінде «API» бөлімін ашып, «Кілт жасау» түймесін басыңыз. Токен бір рет көрсетіледі — оны бірден сақтап қойыңыз.

  3. 3 қадам

    Мессенджерлер мен боттарды қосыңыз

    WhatsApp, Telegram немесе MAX аккаунттарын — QR-код не телефон нөмірі арқылы, Telegram, MAX, VK және Яндекс боттарын — токен арқылы. Сұраныс бірдей.

  4. 4 қадам

    Хабарлама жіберіңіз

    Бір сұраныс — хабарлама нақты адамға кетеді. Алушы көп болса, сол API-мен тарату құрылады: хабарламалар, алушылар, іске қосу.

  5. 5 қадам

    Нәтижені бақылаңыз

    Әр хабарлама мен таратудың әр алушысы бойынша статустарды, жауаптар мен кіріс хабарламаларды сұраныспен не вебхукпен алыңыз.

Мессенджерлер мен боттардың API-ін қайда қолдануға болады

Мессенджерлер API-і клиенттерге хабарламалар автоматты түрде — сіздің жүйеңіздегі оқиға бойынша, бір-бірлеп немесе бірден бүкіл базаға — кетуі керек жердің бәрінде қажет.

  • CRM

    Мәміле кезеңі немесе тапсырыс статусы өзгергенде хабарлама кетеді — менеджерге кімге және қашан ескерту керегін есте сақтаудың қажеті жоқ.

  • Интернет-дүкендер

    Тапсырысты растау, төлем, жинақтау және жеткізу: сатып алушы әр қадамды поштадан хат іздемей, мессенджерден алады.

  • Лендингтер мен сайттар

    Формадан келген өтінім лид әлі ыстық кезде, бір минут ішінде жауап алады — адам сауалнамада қалдырған мессенджерге.

  • Онлайн жазылу

    Келуден бір күн бұрын еске салу және жауап хабарламамен жазылуды растау: кестеде бос терезелер азаяды.

  • Логистика

    Трек-нөмір, жөнелтілім статусының өзгеруі және тапсырылғаны туралы хабарландыру — курьердің қоңырауынсыз және қолдау қызметіне жүгінбей.

  • Биллинг және сервистер

    Шоттар, чектер, жазылымды ұзарту және техникалық хабарландырулар сіздің жүйеңізден оның өз кестесімен кетеді.

  • Маркетинг

    База сегменттері бойынша акциялар мен арнайы ұсыныстар: сегмент сіздің тарапыңызда жиналады, жіберу мен қарқынды сервис өз мойнына алады.

  • HR және іріктеу

    Сұхбатқа шақырулар және іріктеу кезеңдері бойынша үн қату статустары — кандидат өзіне ыңғайлы жерде жауап береді.

  • Сауалнамалар мен пікірлер

    Сатып алудан немесе келуден кейінгі сауалнама, ал жауаптар сіздің жүйеңізге оқиға болып — хабарлама мәтінімен бірге — қайтады.

Бір сұраныс мессенджер аккаунттары үшін де, боттар үшін де жұмыс істейді: тағы бір арна қосу — бұл жаңа интеграция емес, сұраныстағы басқа мән. Аккаунт әлі хат алыспаған адамға жазу үшін керек; бот — өз жазылушыларымен жұмыс істеу үшін, оған нөмір мүлде қажет емес. Тарату — сол арна, тек алушысы көп.

Әзірлеумен айналысқыңыз келмесе, сол мүмкіндіктер кодсыз да қолжетімді: CRM-мен интеграция — Битрикс24 және амоCRM-мен дайын байланыс, онда хат алысу клиент карточкасында жүреді, ал сегменттер мен воронка оқиғалары сіздің CRM-нен келеді; MCP арқылы ЖИ-ассистентке қосылу клиенттермен қарым-қатынас сценарийлерін сөзбен сипаттауға мүмкіндік береді.

API туралы жиі қойылатын сұрақтар

  • Мессенджерлер API-і қанша тұрады?

    API үшін бөлек ақы жоқ — сервистің кәдімгі тарифтері қолданылады. Жеке кабинетке алғаш кіргеннен кейін тегін «Basic» тарифі қосылады — күніне 15 хабарлама, мәңгі; бұл интеграцияны әзірлеу мен тестілеуге жеткілікті.

    Жұмыс көлемдері үшін тарифтер бар:

    • «Light» тарифі – күніне 300 хабарлама.
    • «Professional» тарифі – күніне 3 000 хабарлама.

    Кез келген тарифте лимиттен тыс хабарламаларды әр хабарлама үшін қосымша ақымен жіберуге болады. Тарифтердің бағасы және лимиттен тыс хабарламаның құны — тарифтер бетінде.

    Тегін тариф туралы бір ескерту: онда таратулар құрылады және жіберіледі, ал алушылардың жауаптарын, аккаунттың диалогтары мен контактілерін оқу үшін аккаунт синхронизациясы бар тариф қажет.

  • Бір хабарлама жіберудің таратудан айырмашылығы неде?

    Бұл — бір API-дің екі әдісі. Бір хабарлама — нақты адамға өз мәтінімен не тіркемесімен кететін бір сұраныс: телефон нөмірі бойынша, Telegram мен MAX-тағы аккаунт аты бойынша немесе бұрыннан бар диалогқа. Интеграцияның негізгі сценарийі осы: тапсырысты растау, код, қабылдау туралы еске салу, кіріс хабарламаға жауап.

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

    Тарату алушы көп болғанда керек: сегмент не нөмірлер тізімі, өріс мәндері қойылатын ортақ мәтін, жіберу қарқыны және әр алушы бойынша статустар. Екі әдісте де арна мен аккаунт бірдей.

  • API қандай мессенджерлер мен боттарды қолдайды?

    WhatsApp, Telegram және MAX аккаунттары, сондай-ақ Telegram, MAX, VK және Яндекс боттары. API бірыңғай: қосу, таратуларды құру және статустарды алу әдістері бәріне бірдей — сұраныста арнаны көрсету жеткілікті. Боттың екі айырмашылығы бар: ол QR-код не телефон нөмірі емес, токен арқылы қосылады және жүктелген нөмірлерге емес, өз жазылушыларына жібереді — Bot API бірінші болып жазуға рұқсат бермейді.

  • Хабарламалар қай аккаунттардан жіберіледі?

    Мессенджер қосымшасында тіркелген өзіңіздің кәдімгі аккаунттарыңыздан. Аккаунт QR-код немесе телефон нөмірі арқылы — API арқылы не жеке кабинетте — қосылады және келесі жіберулер үшін қосулы күйінде қалады. Алушылардың жауаптары да осы аккаунттарға келеді. Тарату боттан жүрсе, жіберуші боттың өзі болады, ал ол үшін нөмір мүлде қажет емес.

  • API-кілтті қалай аламын?

    Кілтті өзіңіз жасайсыз: тарату кабинетінде «API» бөлімі → «Кілт жасау». Токен бір рет көрсетіледі, кейін оны қайтару мүмкін емес — жоғалтсаңыз, жаңа кілт жасап, ескісін өшіріңіз. Кілт жобаға беріледі, бірнеше кілт жасауға болады — мысалы, әр интеграцияға жеке кілт.

    Токен әр сұраныстың тақырыбында беріледі: Authorization: key СІЗДІҢ_ТОКЕНІҢІЗ. Барлық әдістердің сипаттамасы — API құжаттамасында, сол жерде өз кілтіңізбен сұранысты браузерден бірден орындап көруге болады.

  • Сұраныс жиілігіне шектеу бар ма?

    Жиілікті тариф белгілейді: «Basic»-те минутына 60 сұраныс, «Light»-та 300, «Professional»-да 1200. Лимит кілтке емес, жобаға есептеледі: жаңа кілттер шығару оны кеңейтпейді.

    Лимиттен тыс сұраныс 429 кодымен және Retry-After тақырыбымен қабылданбайды: оны көрсетілген уақыттан кейін қайталаңыз. Кәдімгі интеграцияға — воронка оқиғалары, тапсырыстарды растау, статустар — бұл жеткілікті; жаппай жіберуді жеке сұраныстар ағынымен емес, таратумен жасаңыз.