Негізгі мазмұнға өту
DocumentationAPI ReferenceVideo Tutorials

Кері қоңырау виджеті

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

Бұл бесінші виджет түрі, Floating, Pill, Pill Floating және Inline виджеттерімен қатар — бірақ ол өте басқаша жұмыс істейді. Басқа виджеттер браузерде дауыстық әңгімені бастайды. Кері қоңырау виджеті агентіңіз шығыс нөміріңіз арқылы орналастыратын нақты телефон қоңырауын кезекке қояды.

Оны қашан пайдалану керек​

СценарийНеліктен Кері қоңырау виджеті қолайлы
Лидтер жинайтын landing беттерКелуші телефон нөмірімен міндеттенеді, агент оны келесі минут ішінде біліктілейді
Жоғары ниетті өнім беттеріКелушіні теруге мәжбүрлемей "Talk to a specialist"
Мобильді-бірінші сайттарPill-ге бір рет түрту, рұқсат сұрау жоқ, құлаққап қажет емес
Жұмыс уақытынан тыс қамтуКелуші жұмыстан кейін нөмір қалдырады, кезек ашылғанда агент тереді
Формалармен салыстырғанда қарсылықты азайтуКелушілер бір өрісті жіберіп, лезде жауап алады

Жарамдылық​

Кері қоңырау виджеті оны қосуға дейін есептік жазбаңызда үш нәрсені талап етеді:

ТалапСебебі
Ақылы тариф (Starter немесе одан жоғары)Кері қоңырау кезінде жұмсалатын шығыс минуттары минут есебінде тіркеледі
Агентке тағайындалған расталған шығыс телефон нөміріАгентке тере алатын нақты нөмір қажет
Сіздің жұмыс кеңістігіңізде расталған электрондық поштаШығыс қоңыраулар ашылғанға дейін иеленуді растайды

Егер осылардың кез келгені жетіспесе, агенттің Widgets қойындысындағы Кері қоңырау виджеті бөлімі сізге не түзету керектігін дәл айтатын ескерту көрсетеді. Виджет үшеуі де орнында болғанға дейін өшірілген күйінде қалады.

Free тариф

Кері қоңырау виджеті Free тарифінде қолжетімді емес, өйткені ол шығыс телефон қоңырауларын жасайды. Барлық басқа виджет түрлері (Floating, Pill, Inline) тегін болып қалады.

Оны баптау​

1. Агентте кері қоңырауды қосу​

  1. Агентіңізді ашып, Widgets қойындысына өтіңіз.
  2. Callback widget бөліміне төмен айналдырыңыз.
  3. "Enable callback widget" ауыстырғышын қосыңыз.
  4. Конфигурациялаңыз:
    • Retry attempts — келуші телефонды алмаса, агент қанша рет қайталайды (1–5, әдепкі 3).
    • Retry interval — әрекеттер арасындағы минуттар (1–30, әдепкі 5).
    • Widget language — форма, күй хабарламалары және ел таңдағышы келушіңізбен сөйлесетін тіл (14 тіл қолжетімді — төменде қараңыз).
    • Theme — қалқымалы pill мен диалогтың түс схемасы (басқа виджеттермен бірдей тема палитрасын қолданады).
  5. Сақтаңыз.

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

2. Ендіру фрагментін көшіру​

Сол бөлімде HTML фрагментін көшіріңіз:

<hanc-ai-callback agent-id="YOUR_AGENT_ID"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async type="text/javascript"></script>

Оны сайтыңызға бір рет, әдетте </body> алдында қойыңыз. Виджет беттің бұрышында қалқымалы pill ретінде пайда болады.

кеңес

@latest тегі сіздің сайтыңыз жаңа виджет нұсқалары шыққанда оларды автоматты түрде қабылдайтынын білдіреді. Жаңартуларды толық бақылағыңыз келсе, нақты нұсқаға (мысалы, hanc-webrtc-widgets@1.4.0) бекітіңіз.

Келуші не көреді​

Виджет келушілерді төрт күй арқылы өткізеді:

КүйКелуші не көреді
FormБұрыштағы қалқымалы pill. Ашу үшін басыңыз. Сол жақта ел таңдағышы, оң жақта телефон енгізу, жіберу батырмасы.
Queued"You're in the queue — about N seconds until we call you." Тікелей жаңарады.
Dialing"We're calling you now." Қоңырау қосылғанша немесе сәтсіз болғанша қалады.
Completed / FailedҚысқа растау немесе "reload the page to make another callback" нұсқауымен сыпайы қате.

Форма телефон нөмірін таңдалған елдің ұлттық форматына қарсы автоматты түрде тексереді және нөмір ақылға қонымды болмаса, жіберуден бас тартады.

Елдерді қамту​

Ел таңдағышы Еуропаны (EU + DACH + UK), Солтүстік Американы (US + Canada) және кеңінен қолдау көрсетілетін қосымша елдердің таңдамалы жиынтығын қамтиды. Әр ел өз туын, атауын және келуші не теру керектігін білуі үшін өз форматындағы үлгі толтырғышты көрсетеді.

Егер келушілеріңіз пайдаланатын ел тізімде жоқ болса, support@hanc.ai мекенжайына хабарласыңыз — қамту үнемі кеңейтіліп отырады.

HTML атрибуттары​

Виджет <hanc-ai-callback> тегінде мына атрибуттарды қабылдайды:

АтрибутМіндеттіСипаттама
agent-idYesАгентіңіздің бірегей идентификаторы
localeNoОсы бет үшін виджеттің UI тілін ауыстырыңыз (мысалы, locale="de"). Сайтыңыз көптілді болса және бет локалі агенттің әдепкісіне сәйкес келмесе пайдалы.
themeNoОсы бет үшін түс темасын ауыстырыңыз
positionNoҚалқымалы pill қайда бекітіледі (bottom-right, bottom-left, top-right, top-left)

Қалдырған кез келген нәрсе бақылау тақтасында агентте конфигурациялағаныңызға оралады.

Мысал: көптілді сайттағы неміс беті​

<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>

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

Виджет тілі​

Виджет UI-і 14 кірістірілген тілмен жеткізіледі:

КодТіл
enEnglish
deDeutsch
frFrançais
esEspañol
itItaliano
ptPortuguês
plPolski
csČeština
huMagyar
trTürkçe
kkҚазақша
zh中文
ruРусский
ukУкраїнська

Агент өз тілін үш жерден, басымдық ретімен таңдайды:

  1. Ендірудегі locale="…" атрибуты (ең жоғары басымдық)
  2. Агенттің Widgets қойындысында орнатылған Widget language
  3. English (әдепкі)
Виджет тілі ≠ агенттің сөйлеу тілі

Виджет тілі тек келуші оқитын экрандағы мәтінге әсер етеді — жапсырмалар, ел таңдағышы, күй хабарламалары. Нақты дауыстық әңгіме агентіңіз сөйлеуге конфигурацияланған тілде өтеді.

Қайталау әрекеті​

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

  • Attempts: 1–5 (әдепкі 3)
  • Interval: 1–30 минут (әдепкі 5)

Виджет келушіге әр әрекеттің күйін көрсетеді. Барлық әрекеттер сәтсіз болғаннан кейін, виджет сыпайы хабарламамен "we couldn't reach you" күйіне ауысады.

Дұрыс сандарды таңдаңыз

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

Бет жүктелген сайын бір кері қоңырау​

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

  • Диалогты жабу pill-ды жиырады, бірақ форманы қалпына келтірмейді.
  • Қайта ашу жаңа форманы емес, ағымдағы күйді (queued / dialing / completed / failed) көрсетеді.
  • Екінші кері қоңырау жасау үшін, келуші бетті қайта жүктеуі керек.

Бұл қоңырау жолда болғанда кездейсоқ қайталанатын жіберулердің алдын алады. Егер келуші диалогтан өзінің кезектегі кері қоңырауын анық болдырмаса (queued экранындағы "Cancel" батырмасы), құлып босатылады және олар бірден қайта жібере алады.

Егер олар кері қоңырау ортасында қайта жүктесе не болады?​

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

Параллельдік және өткізу қабілеті​

Бір агент бір уақытта 10 кері қоңырауға дейін орындай алады. Одан асатын жіберулер кезекте күтеді және сыйымдылық босаған сайын теріледі.

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

Спам мен теріс пайдаланудан қорғау​

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

ҚорғанысКелуші не сезінеді
"I'm not a robot" тексеруіПлатформада теріс пайдаланудан қорғау қосылғанда, келуші кері қоңырау кезекке қойылмас бұрын жылдам Google reCAPTCHA-ны орындайды. Шынайы келушілер оны секунд ішінде өтеді; боттар тоқтатылады.
Нөмірді тексеруФорма таңдалған елге ақылға қонымды сәйкес келмейтін нөмірді жіберуден бас тартады, сондықтан қате терулер мен қоқыс нөмірлер ешқашан теріледі.
Премиум-тарифті және қамтудан тыс нөмірлерПремиум-тарифті желілер, кейбір VoIP диапазондары және қолдау көрсетілетін қамтудан тыс нөмірлер телефон арқылы кері шақырылмайды. Егер келушінің браузері оны қолдаса, виджет оның орнына браузер ішіндегі дауыстық қоңырауды ұсынады; әйтпесе олар сыпайы "we can't call this number" хабарламасын көреді. Бұл виджетті қымбат премиум нөмірлерді теру үшін теріс пайдаланудан сақтайды.
Қайта жіберу шегіБір нөмір агент үшін сағатына тек шектеулі рет кезекке қойылады. Оны асырып жіберген келушілер queued экранының орнына сыпайы "we'll be in touch shortly" хабарламасын көреді.
Неліктен бұл маңызды

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

Бақылау тақтасындағы тікелей алдын ала көрініс​

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

Алдын ала көрініс толық ел тізімі мен демо жарамдылығы бар жалған манифестті қолданады, сондықтан виджет шығыс кері қоңыраулар әлі қолжетімсіз тарифтерде де рендерленеді.

Ендірілген бақылау​

Виджет басқа виджеттермен бірдей call-start және call-end оқиғаларын шығарады. Өз аналитикаңызды іске қосқыңыз келсе, оларды JavaScript-те тыңдаңыз:

const widget = document.querySelector('hanc-ai-callback');

widget.addEventListener('call-start', () => {
  // Visitor's callback was just connected — track as conversion
});

widget.addEventListener('call-end', () => {
  // Callback finished — track duration, outcome, etc.
});

Тарифте қолжетімділік​

ТарифКері қоңырау виджеті
FreeҚолжетімді емес (шығыс қоңырауды талап етеді)
Starter / Pro / Business / EnterpriseҚолжетімді

Барлық ақылы тарифтер бірдей виджет мүмкіндіктер жиынтығын алады. Қоңырауға шаққандағы құн сіздің қалыпты шығыс мөлшерлемеңізге сәйкес келеді — Төлемдер қараңыз.

Қатысты​