Сыртқы арналарды чатқа қосу

Арна интеграциялары клиенттермен байланысты әртүрлі жерден бір жұмыс контурына жинайды. Клиент өзіне ыңғайлы жерге жазады — Telegram-ға, WhatsApp-қа немесе сайттағы форма арқылы, — ал хабар LadVen OS чатына түседі, онда команда жауап береді, жауапты адамды тағайындайды және өтінішті тапсырмамен немесе мәмілемен байланыстырады.

Бұл — омниарналы жұмыстың негізі: хат-хабар қызметкерлердің жеке телефондарында жоғалмайды, ал тарих порталда қалып, командаға қолжетімді болады.

Қызметкер Telegram-ды Extranet баптауларынан да байланыстыра алады: портал қосылған Telegram-ботқа жіберілетін бір реттік кодты көрсетеді. Кодты порталға қайта енгізудің қажеті жоқ; бот жауап бергеннен кейін байланысты жаңартыңыз. Telegram интеграциясы қосылмаса, оны менеджерден қосуды сұраңыз. Қатынасты сол баптаулардан қайтарып, кейін байланыстар тізімін қайта оқыңыз.

Telegram баптауларындағы белсенді күй жеткізуге кепілдік бермейді: ескі байланыс миграцияны қажет етуі мүмкін. Менеджер миграцияны бастайды немесе клиенттен қайта қосуды сұрайды. Клиент ботқа толық /bind <code> жолын жібереді де, байланыстарды жаңартады; бір реттік кодтың мерзімі шектеулі және порталға қайта енгізілмейді. Қайта жүктегеннен немесе қойынды ауысқаннан кейін жаңа код шығарыңыз. Мерзімі өткен код, қате бот/жіберілмеген команда және басқа есептік жазбаға байланған Telegram әртүрлі әрекетті талап етеді; қайшылықты әкімші босатады.

Сыртқы арна сценарийлері

Тиісті адаптер қосылса, Telegram, WhatsApp және сайт формалары чатқа хабар жібере алады. Олар жалпы /chat/integrations формасының типтері емес; бұл форма тек external, bot және webhook мәндерін қолданады.

Қазір чатқа мыналарды қосуға болады:

• Telegram — Telegram-боты немесе арнасынан келген хабарлар;
• WhatsApp — WhatsApp хабарлары;
• Сайттағы форма — сіздің сайтыңыздағы форма арқылы жіберілген өтініштер.

Әр арна жеке интеграция ретінде қосылады. Бір компанияда бірнеше интеграция қатар болуы мүмкін — мысалы, бір өнім үшін Telegram және басқа өнім үшін WhatsApp.

ескертпе

Қолжетімді арналар жиынтығы сіздің порталыңыздың баптауларына және қосылған адаптерлерге байланысты. Қажет арна тізімде болмаса, ол сіздің конфигурацияңызда қолжетімді ме екенін портал әкімшісінен нақтылаңыз.

/chat/integrations чаттағы жалпы сыртқы, bot және webhook қосылымдарын баптайды. Формада шығыс endpointUrl және кіріс inboundToken үшін типтелген өрістер бар; қосымша параметрлер JSON нысаны болуы керек. Жарамсыз JSON немесе нысан емес JSON қабылданбайды. Жеткізуді бақылау /chat/integrations/ops бетінде бөлек орналасқан; Telegram және WhatsApp провайдерін CRM Integration Hub баптайды, бұл форма оны білдірмейді.

Арнаны қалай қосу керек (басқару құқығымен)

chat.canReadSettings тізімді көруге мүмкіндік береді; құру және өзгерту үшін chat.canManageSettings қажет. Басқару құқығы болмаса, экран тек оқу режимінде қалады.

1. Баптауларда чат интеграциялары бөлімін ашыңыз.
2. Жаңа интеграция жасап, түсінікті атау беріңіз — мысалы, «Telegram: сатылым» немесе «WhatsApp: қолдау». Атау бойынша команда хабарлар қайдан келетінін түсінеді.
3. Қосылым түрін таңдаңыз.
4. Шығыс мекенжайы мен кіріс токенінің типтелген өрістерін толтырыңыз; қосымша параметрлерді тек JSON нысаны ретінде беріңіз. Жарамсыз JSON немесе нысан емес JSON қабылданбайды. Нақты мәндерді провайдерден алыңыз; портал құпияларды жарияламайды және болжамдамайды.
5. Интеграцияны қосып, сақтаңыз.

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

Арна параметрлерін алдын ала дайындап, қоспас бұрын тексеріңіз: токендегі немесе мекенжайдағы қате хабарлардың келмейтінін немесе жіберілмейтінін білдіреді.

Бұл команда үшін қалай көрінеді

Арна қосылғанда, одан келген клиент хабарлары чатқа кәдімгі сөйлесулер сияқты түседі. Әрі қарай команда олармен ішкі чаттардағыдай жұмыс істейді:

• клиентке порталдан тікелей жауап береді;
• файл тіркейді, нақты хабарға жауап береді, белгілеулерді қолданады;
• өтініш жұмыс процесіне түсуі үшін сөйлесуді тапсырмамен немесе мәмілемен байланыстырады;
• маңызды хабарларды бекітіп, хат-хабардан іздейді.

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

Жеткізу операциялары

Сыртқы арналар үшін хабарлардың келуі ғана емес, клиентке қайта кетуі де маңызды. Ол үшін жеткізудің операциялық консолі бар, онда әкімші жіберу күйін көреді:

chat.canReadSettings құқығы бар пайдаланушылар интеграциялар тізімі мен жеткізу консолін көре алады. Құру, өзгерту, қосу, өшіру, жою және қайта жіберу үшін chat.canManageSettings керек; әкімші емес оператор экранды тек оқу режимінде көре алады.

• кезекте, жіберілген, қатесі бар немесе мерзімі өткен хабарлар саны;
• интеграция, сандық шек немесе overdueOnly бойынша сүзілген тұрып қалған жеткізулер;
• күйі, әрекет саны, maxAttempts және соңғы қатесі көрсетілген dead-letter жолдары;
• қайта жіберу тек басқару құқығы бар пайдаланушыға қолжетімді: ол жасырын көшірме жасамай, сол жеткізудің, күйінің және әрекет есептегішінің өзін жаңартады.

Белсенді арналар бойынша консольді жүйелі тексеріңіз: қателер немесе тұрып қалған хабарлар саны өссе, мәселе әдетте порталдың өзінде емес, арна қатынауында немесе оның шектеулерінде болады.

Тар экранда сол деректер карточкаларға ауысады: тұрып қалған жеткізу карточкасында интеграция, pending/failed/overdue есептегіштері және ең ескі күтілетін жазбаның жасы көрінеді; DLQ карточкасында күй, attempts/maxAttempts, соңғы қате және Қайта жіберу көрсетіледі. chat.canManageSettings болмаса, қайталап жіберу өшірулі болады; түсіру кезінде оны баспаңыз, сонда кадр тек оқуға арналған болып, кезек өзгермейді. Жергіліктендірілген скриншотта мақсатты тілдегі белгілер, PII/құпиясыз синтетикалық идентификаторлар және ar үшін RTL тексерісі қажет.

Жақсы тәжірибелер

• Интеграцияларды арна мен мақсаты бойынша атаңыз, сонда команда хабар көзін бірден түсінеді.
• Арна параметрлерін интеграцияны қоспас бұрын дайындап, тексеріңіз.
• Әр сыртқы арнаға жауапты адам тағайындаңыз, әйтпесе өтініштер «бәріне көрінеді», бірақ ешкім оларды жаппайды.
• Клиент сөйлесулерін тапсырмалармен немесе мәмілелермен байланыстырыңыз, сонда өтініш тек хат-хабар болып қалмайды.
• Белсенді арналар бойынша жеткізу консолін мезгіл-мезгіл тексеріп тұрыңыз.
• Арна токендері немесе қатынауы өзгергенде интеграция параметрлерін бірден жаңартыңыз.

Жиі кездесетін қателер

• Қосылым параметрлеріндегі қате — хабарлар келмейді немесе жіберілмейді, ал себебі хат-хабардың өзінде көрінбейді.
• Арнаға жауапты адам жоқ — клиент өтініштері жалпы ағында жоғалады.
• Сыртқы арнадан келген сөйлесу тапсырмамен немесе мәмілемен байланыстырылмаған — келісім тек чатта қалады.
• Жеткізу консолін ешкім қарамайды — жіберу қателері байқаусыз жиналады, клиент жауап алмайды.

Байланысты бөлімдер

• Чаттар және пікірлер
• CRM
• Формалар және кіріс ағыны
• Кіріс хаттарды өңдеу ережелері