Тышкы каналдарды чатка туташтыруу

Канал интеграциялары ар кайсы жерден кардарлар менен болгон байланышты бир иш контуруна чогултат. Кардар өзүнө ыңгайлуу жерге жазат — 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
• Формалар жана кирүүчү агым
• Кирүүчү каттарды иштетүү эрежелери