MaviBot әлемдегі ең жылдам дамып келе жатқан және танымал әлеуметтік платформалардың бірі – TikTok-пен интеграцияланады.
Бұл интеграция MaviBot экожүйесі үшін жаңа кезең ашады. Күн сайын миллиондаған пайдаланушылар араласатын TikTok заманауи коммуникацияның, трендтердің және жаңа интерактивті форматтардың орталығына айналды. Бизнес енді әлемдегі ең тартымды платформалардың бірі арқылы жас аудиторияға қол жеткізе алады.
Бұл мақалада сіз мыналарды білесіз:
- интеграцияны қалай іске қосу керек;
- қандай кері шақырулар (callbacks) қолжетімді;
- қандай рұқсаттар берілуі керек.
Сондай-ақ, аймақтық қолжетімділік пен оның шектеулерін қарастырамыз.
Маңызды
TikTok интеграциясы барлық елдерде қолжетімді емес.
TikTok Messaging API қазіргі уақытта ашық бета-нұсқада тек келесі аймақтарда қолжетімді:
- Азия-Тынық мұхиты аймағы (APAC);
- Латын Америкасы;
- Таяу Шығыс;
- Африка (METAP);
- Солтүстік Америка (Америка Құрама Штаттарын қоспағанда).
Қосылған TikTok аккаунты осы аймақтардың бірінде тіркелуі керек.
Америка Құрама Штаттарынан, Еуропалық экономикалық аймақтан (EEA), Швейцариядан немесе Ұлыбританиядан пайдаланушылар жіберген хабарларды TikTok платформасының шектеулеріне байланысты алу мүмкін емес.
Қосымша ақпарат алу үшін ресми TikTok құжаттамасын қараңыз:
https://business-api.tiktok.com/portal/docs?id=1832184145137922
Назар аударыңыз
TikTok чат-ботын жасамас бұрын, Бизнес үшін чат-ботты қалай жасау керек бөлімін қараңыз.
TikTok батырмаларының шектеулері төмендегі Батырмалар бөлімінде сипатталған.
TikTok-ты MaviBot-пен біріктіру – бұл тағы бір арна ғана емес, бұл пайдаланушылармен олар көп уақыт өткізетін жерде сөйлесуге және жоғары деңгейдегі тұтынушылармен өзара әрекеттесуді құруға мүмкіндік.
TikTok аккаунтыңызды дайындаңыз
Аккаунтыңызды MaviBot-қа қоспас бұрын, оны Бизнес аккаунтына ауыстырыңыз.
1-қадам
Параметрлер және құпиялылық бөлімін ашыңыз.
2-қадам
Аккаунт бөлімін ашыңыз.
3-қадам
Бизнес аккаунтына ауысу тармағын таңдаңыз.
4-қадам
Бизнес профиліңізді толтырыңыз.
Дайын! Енді аккаунтыңыз MaviBot-қа қосылуға дайын.
TikTok аккаунтыңызды қосыңыз
MaviBot-тағы Мессенджерлер бөлімін ашып, TikTok түймесін басыңыз.
TikTok аккаунтыңызға кіріңіз.
MaviBot-қа аккаунтыңызға кіруге рұқсат беріңіз.
Маңызды
Келесі рұқсаттарды беруді ұсынамыз:
- хабарларды оқу және басқару;
- пікірлерге қол жеткізу;
- профиль ақпаратына қол жеткізу;
- бейнелерді көру.
Осы рұқсаттарсыз чат-бот және кейбір кері шақырулар дұрыс жұмыс істемеуі мүмкін.
Қажет емес басқа рұқсаттарды беруден бас тартуыңызға болады.
Егер кейін қажетті рұқсаттардың кез келгенін қайтарып алсаңыз, оларды тек TikTok аккаунт параметрлерінен қайта қосуға болады.
Авторизациядан кейін сіз Мессенджерлер бөліміне қайта бағытталасыз, онда MaviBot интеграцияның сәтті аяқталғаны туралы хабарлама көрсетеді.
TikTok шектеулері
- Бот хабар жіберер алдында пайдаланушы әңгімені бастауы керек.
- Пайдаланушыдан хабар алғаннан кейін 48 сағат ішінде 10 хабарға дейін жібере аласыз.
- Мысал: егер пайдаланушы сізге бір хабар жіберсе, келесі 48 сағат ішінде 10 жауапқа дейін жібере аласыз. Егер пайдаланушы кейін тағы бір хабар жіберсе, 48 сағаттық жаңа терезе басталып, тағы 10 шығыс хабарға рұқсат етіледі.
- Бір хабарда мәтін мен сурет бірге бола алмайды.
- Сурет қосымшалары (attachments) тек жіберуші мен алушы жеке хабарларда суреттерді бөлісуге TikTok рұқсат ететін елдерде орналасқанда ғана қолданылады.
- Суреттің максималды өлшемі 3 МБ.
- Бір хабарға тек бір ғана қосымша қосуға болады.
Кері шақырулар (Callbacks)
Жаңа пікір
tiktok_client_new_comment <video_id>: <comment_text>
Пайдаланушы сіздің бейнелеріңіздің біріне пікір қалдырғанда іске қосылады.
Бейнемен бөлісу
tiktok_client_share_post <shared_video_id> <url>
Пайдаланушы қосылған аккаунттың жеке хабарларында TikTok бейнесімен бөліскенде іске қосылады.
Клиент айнымалылары
tiktok_comment_id
Пікір идентификаторын сақтайды.
Пайдаланушы сіздің бейнеңізге пікір қалдырғанда автоматты түрде толтырылады және сол пікірге жауап беру кезінде қолданылады.
tiktok_comment_video_id
Пікір алынған бейненің идентификаторын сақтайды.
Пайдаланушы сіздің бейнеңізге пікір қалдырғанда автоматты түрде толтырылады.
tiktok_is_follower
Пайдаланушы сіздің TikTok аккаунтыңызға жазылса, True мәнін қайтарады.
tiktok_conversation_id
Әңгімелесу идентификаторын сақтайды.
Пайдаланушы бірінші жеке хабарды жібергеннен кейін автоматты түрде жасалады.
Маңызды
Бұл айнымалыны жоймаңыз.
Ол пайдаланушыға хабар жіберу үшін қажет.
Батырмалар
TikTok хабары үш батырмаға дейін қамтуы мүмкін.
TikTok екі түрлі батырманы қолдайды:
- Кері шақыру батырмалары (Callback buttons)
- URL батырмалары
Маңызды
Бір хабарда тек бір түрдегі батырмалар болуы мүмкін.
1-мысал
2-мысал
Нәтиже
Назар аударыңыз
Батырмалары бар хабарлар TikTok Desktop нұсқасында қолданылмайды.
Жұмыс үстеліндегі пайдаланушылар оның орнына келесі хабарландыруды көреді:
Мобильді қосымшада хабар дұрыс көрсетіледі.
Батырмада көрсетілген мәтін оны басқаннан кейін ботқа қайта жіберілетін мәтінмен бірдей.
Батырма мәтіні батырма параметрлеріндегі Жауап хабар мәтіні немесе URL өрісінен алынады.
Кері шақыру батырмалары
Кәдімгі батырмалар ретінде көрсетіледі.
Басқан кезде TikTok пайдаланушы атынан ботқа батырма мәтіні бар хабар жібереді.
Максималды ұзындығы: 20 таңба.
URL батырмалары
Сілтемелер ретінде көрсетіледі.
Қазіргі уақытта TikTok URL батырмаларын басқан кезде веб-парақтарды ашуды қолдамайды.
Оның орнына, батырманы басу оның мәтінін кері шақыру батырмасы сияқты ботқа жібереді.
Максималды ұзындығы: 40 таңба.
Кері шақыру батырмалары туралы көбірек біліңіз.
Функциялар
Пікірге жауап беру
tiktok_create_comment(text, comment_video_id, comment_id)
TikTok пікіріне жауап жариялайды.
| Параметр | Сипаттама |
|---|---|
| text | Міндетті. Жауап мәтіні. |
| comment_video_id | Пікірі бар бейненің идентификаторы. Міндетті емес. Егер көрсетілмесе, tiktok_comment_video_id клиент айнымалысының мәні қолданылады. |
| comment_id | Жауап берілетін пікірдің идентификаторы. Міндетті емес. Егер көрсетілмесе, tiktok_comment_id клиент айнымалысының мәні қолданылады. |