Клиент дүкенге кіріп, себетіне тауар салды, «Рәсімдеу» батырмасын басты. Төлемге келгенде тоқтап қалды. Жиі болатын жағдай: басқа шаруасы шығып кетті, күмәнданды, картадан төлем өтпеді немесе «кешке қараймын» деп ұмытып кетті. Ол бір минут бұрын тауарды алғысы келіп, сатып алуға сәл-ақ қалған адам.
Әдетте клиентке «Себетіңізде тауар қалып қойды» деген хат жіберіледі. Оны ашатындар аз, хатты оқып дүкенге қайта кіретіндер одан да аз. Ал клиент дүкеннен шыққан соң он минуттан кейін телефон шырылдаса ше? «Сәлеметсіз бе! Біздің дүкенде себетіңізге тауар салған едіңіз. Бәрі дұрыс па? Тапсырысты рәсімдеуге бірдеңе кедергі болды ма?» Мұндай қоңырауға адамдар басқаша жауап береді.
Осы интеграцияны басынан аяғына дейін құрастырамыз. Дауыстық ЖИ-агент қоңырау кезінде себетте не барын жүйеңізден API арқылы өзі алады, клиентпен сөйлесіп, нәтижесін Telegram арқылы менеджерлерге жібереді. Кодтың бәрі төменде. Бір кеште қайталап жасауға болады.
Нәтижесінде не аламыз
GET /cart әдісін нөмір бойынша шақырып, себетте не барын біледіcallback_url мекенжайыңызға келеді, ал одан менеджерлердің Telegram тобына ұқыпты карточка болып түседіЕкінші қадамға назар аударыңыз: агент себетті алдын ала алмайды, оны қоңырау кезінде сізден өзі сұрайды. Сондықтан бүкіл дүкенге бір агент жетеді: ол нақты тапсырысқа байланбаған, әр жолы өзекті себетті клиенттің нөмірі бойынша біледі.
1-қадам. Агентті бір рет жасаймыз
Агент бір рет жасалады, кейін барлық қоңырауға қызмет етеді. Оның үш бөлігі бар: әңгіме сценарийі (prompt), ол толтыруға тиіс өрістер (data_schema) және құралдар (tools): себетті сұрау мен SMS жіберу.
Бірнеше нәрсені нақтылап алайық.
Промпт бөлімдері міндетті. ## Кто ты (сен кімсің), ## Задача звонка (қоңырау мақсаты) және ## Ход разговора (әңгіме барысы) болуы керек, оларсыз агентті жасау сұрауы 422 қайтарады. Қауіпсіздік ережелерін өзіміз қосамыз, оларды промптқа жазудың қажеті жоқ.
order құралы — дәл осы интеграцияның өзі. Қоңырау кезінде агент оны функция ретінде шақырады, ал біз URL ішіне {{phone}} мәнін, яғни клиенттің нөмірін қойып, дүкеніңізге GET сұрауын жібереміз. Серверіңіз не қайтарса, агент оны response_template үлгісі бойынша айтады. Мәндерді қою туралы толығырақ сәл төменде.
Жауап generating мәртебесімен келеді. Агент бірден дайын болмайды: оның параметрлерін есептеуге бірер секунд кетеді. GET /api/v1/agents/{id} арқылы тексеріп отырып, ready мәртебесін күтіңіз және id мәнін сақтап алыңыз: ол қоңырауларды іске қосқанда керек болады.
2-қадам. Дүкеніңіз себетті нөмір бойынша береді
Бұл сіздің жағыңызда іске қосу керек жалғыз эндпоинт. Агент оны қоңырау кезінде шақырады. Жауап пішімін өзіңіз анықтайсыз, тек өріс атаулары агенттің response_template үлгісіндегі атаулармен ({{items}} және {{total}}) сәйкес келуі маңызды.
Біз осы JSON жауабын аламыз, items мен total мәндерін үлгіге қоямыз, ал агент былай дейді: «Себетте: Samsung робот-шаңсорғышы мен саптамалар жиынтығы, жалпы сомасы 45 000 теңге». Серверіңіз жауап бермесе немесе басқа нәрсе қайтарса, агент fallback мәтінін айтып, әңгімені жалғастырады, қоңырау үзілмейді.
Эндпоинт ашық интернетке шығады, сондықтан оны токенмен жабыңыз (біз құрал баптауларындағы Authorization тақырыбын жібереміз) және нөмір бойынша тек себет құрамын беріңіз: мекенжайларсыз, карталарсыз және басқа артық деректерсіз.
3-қадам. Аяқталмаған тапсырысты анықтап, қоңырау шаламыз
Енді дүкен жағы. Жүйеңіз себетті тасталды деп шешкенде (мысалы, төлем қадамынан кейін 10 минут өтіп, төлем болмаса), бір сұрау қоңырауды іске қосады.
Бар мәселе variables өрісінде. Агент себетті сұрағанда, құралдың URL мекенжайындағы {{phone}} орнына дәл осы жердегі phone кілті қойылады. Айнымалыларға не салсаңыз, құрал соны пайдалана алады.
Бэкендіңіз Python тілінде болмаса, сол сұрау curl арқылы:
4-қадам. Telegram ботын дайындаймыз
Бот қорытындыны менеджерлер тобына жазу үшін керек. Үш қысқа әрекет:
- @BotFather ботына
/newbotкомандасын жазып, атау беріңіз. Жауап ретінде7712345678:AAExxxxxxxxxxxxтүріндегі токен аласыз. - Ботты жұмыс тобыңызға қосып, хабар жазуға рұқсат беріңіз.
- Топтың
chat_idмәнін біліңіз: оған уақытша @getidsbot ботын қосыңыз немесеhttps://api.telegram.org/bot{ТОКЕН}/getUpdatesбетін ашыңыз. Топтың id мәні теріс сан болады.
5-қадам. Нәтижені қабылдап, Telegram тобына жазамыз
Біздің callback сұрауын қабылдап, оны хабарламаға айналдыратын шағын сервисті іске қосу ғана қалды. Біз callback_url мекенжайын қоңыраудың әр өзгерісінде шақырамыз, сондықтан алдымен әңгіменің соңын аралық оқиғалардан бөліп алу керек.
Әңгіме болғанының сенімді белгісі: status_tries массивінің соңғы элементі success мәніне тең. Сонда data ішінде агент жинаған өрістер тұрады.
Ол HTTPS қолдайтын кез келген кері прокси артында кәдімгі Flask қосымшасы ретінде іске қосылады. /autocall/callback мекенжайы қоңырауды іске қосқанда callback_url өрісінде көрсеткен мекенжаймен дәл бірдей.
Нәтижені чатқа ғана емес, CRM жүйесіне де салғыңыз келсе, callback дәл осыған арналған. data ішінде data_schema өрістерінің бәрі және data["_transcript"], яғни әңгіменің толық мәтіні бар, егер ол сізге керек болса.
Қоңырауда бұл қалай естіледі
Осы сәтте менеджерлер топқа мынадай карточка алады:
Менеджерге жазбаны тыңдап, болжап отырудың қажеті жоқ: агент әңгімені өрістерге бөліп қойған. Кім шынымен сатып алғысы келіп, қай жерде тоқтап қалғаны, ал кім жай қарап жүргені көрініп тұр.
Назардан тыс қалдыруға болмайтын нюанстар
Адамға ыңғайлы уақытта бір-ақ рет қоңырау шалыңыз. Сұрауда max_tries: 1 және 10:00–20:00 аралығы бекер көрсетілмеген. Сатып алуға ниеті бар клиентке екінші рет немесе кешкі тоғызда қоңырау шалсаңыз, мазасын аласыз.
Тек success мәнін ғана қарамаңыз. Соңғы status_tries мәні no_answer немесе busy болса, әңгіме болмаған, data ішінде өрістер де болмайды. Мұндай оқиғаларды елемеуге болады, ал оларды пайдаланып әлгі «себетіңізді ұмытып кеттіңіз» хатын да жіберуге болады, енді ол қосалқы арна болады.
Нөмірін саналы түрде бермеген адамдарға қоңырау шалмаңыз. Бұл жерде бәрі таза: клиент тапсырысты рәсімдегенде телефонын өзі енгізіп, сатып алуды өзі бастады. Бұл сатып алынған база да, суық қоңырау да емес, сондықтан мұндай қоңырау жұмыс істейді және мазасыз көрінбейді. Бұл тәсілді сізден мұны сұрамаған аудиторияға қолданбаңыз.
Өзіңізге тексеріп көріңіз. Клиенттерге қоспас бұрын, тест себетпен өз нөміріңізге қоңырау жіберіңіз. Сондай-ақ агент карточкасындағы «Тексеру» батырмасы сізге браузерде қоңырау шалады, сонда алғашқы нақты қоңырауға дейін оның қалай сөйлейтінін тікелей естисіз.
Әрі қарай
Біз бір байламды құрастырдық, бірақ оның бөліктерін қайта қолдануға болады. Сол callback_url деректерді CRM жүйесіне салады, агенттің сол HTTP құралы себетті ғана емес, жүйеңіздегі кез келген деректі алады, ал қоңырауды іске қосуды кез келген оқиғаға байлауға болады: тасталған себетке ғана емес, «өтінім бір тәулік жауапсыз», «жазылым аяқталып жатыр», «тапсырыс жеткізілді» сияқты оқиғаларға да.
Әдістердің толық сипаттамасы openapi.yaml файлында, мысалдары бар шолу API және интеграциялар бетінде. Агенттің өзі қалай жұмыс істейтіні және оның сценарийден айырмашылығы туралы бөлек жаздық.