Ақаулықтарды жою

Бұл нұсқаулық Hanc.AI платформасында жалпы мәселелерді шешуге көмектеседі. Төменнен мәселеңізді табыңыз және шешім қадамдарын орындаңыз.

Жылдам диагностика

Симптом	Ықтимал себеп	Шешім бөлімі
Кіре алмаймын	Тіркелгі/құпиясөз мәселесі	Тіркелгі мәселелері
Агент жауап бермейді	Конфигурация мәселесі	Агент мәселелері
Қате жауаптар	Білім базасы мәселесі	Білім базасы мәселелері
Қоңыраулар қосылмайды	Телефонды баптау мәселесі	Телефон мәселелері
Аудио сапасы нашар	Желі/параметр мәселесі	Аудио мәселелері
Виджет жүктелмейді	Домен/браузер мәселесі	Виджет мәселелері
«Кредит жоқ» деп қоңырау ажырайды	Кредит таусылды	Кредит мәселелері
Функция жұмыс істемейді	Жоспар шектеуі	Есеп айырысу мәселелері

---

Тіркелгі мәселелері

Кіре алмаймын

Симптомдар:

• Кіру беті қате көрсетеді
• Құпиясөз қабылданбайды
• Тіркелгі құлыпталған сияқты

Шешімдер:

1. Email/құпиясөзді тексеру

   • Дұрыс email мекенжайын қамтамасыз етіңіз
   • Caps Lock-ты тексеріңіз
   • Құпиясөзді көшіріп-қою арқылы көріңіз

2. Құпиясөзді қалпына келтіру

   • «Forgot Password» батырмасын басыңыз
   • Email-ді тексеріңіз (спамды қоса)
   • 1 сағат ішінде қалпына келтіру сілтемесін басыңыз
   • Жаңа құпиясөз жасаңыз

3. Браузер деректерін тазалау

   • hanc.ai үшін cookie-ні тазалаңыз
   • Кэшті тазалаңыз
   • Инкогнито/жеке режимін қолданып көріңіз

4. Басқа браузерді қолданып көру

   • Chrome, Firefox, Safari немесе Edge
   • Браузер кеңейтімдерін өшіріңіз

Әлі шеше алмадыңыз ба? support@hanc.ai хабарласыңыз

Тіркелгі жасай алмаймын

Симптомдар:

• Тіркелу сәтсіз
• «Email бұрыннан бар» қатесі
• Растау коды алынбады

Шешімдер:

1. Email бұрыннан тіркелген

   • Бар тіркелгіні қалпына келтіру үшін «Forgot Password» қолданып көріңіз
   • Басқа email қолданыңыз

2. Телефонды растау сәтсіз

   • Дұрыс ел кодын қамтамасыз етіңіз
   • Алдыңғы нөлсіз нөмірді енгізіңіз
   • Жаңа кодты сұрамас бұрын 60 секунд күтіңіз
   • Басқа телефон нөмірін қолданып көріңіз

3. Бет қателері

   • Жаңартып қайта көріңіз
   • Браузер кэшін тазалаңыз
   • Басқа браузерді қолданып көріңіз

---

Агент мәселелері

Агент жауап бермейді

Симптомдар:

• Сынақ қоңырауы қосылады, бірақ агент үнсіз
• Агент сәлемдесуді айтпайды
• Шексіз жүктеу

Диагностикалық қадамдар:

1. Агент күйі ACTIVE екенін тексеру (INACTIVE немесе DELETED емес)
2. Алғашқы хабарлама (сәлемдесу) орнатылғанын тексеру
3. Промпт бос емес екенін тексеру
4. Білім базасы қосылғанын тексеру (қолданылатын болса)
5. Қолжетімді кредиттер бар екенін тексеру

Шешімдер:

1. Агент күйін тексеру

   • Voice Agents бөліміне өтіңіз
   • Агент күйі ACTIVE екенін қамтамасыз етіңіз
   • Күй INACTIVE болса, агент параметрлерінен оны белсендіріңіз

2. Алғашқы хабарламаны тексеру

   • Агент параметрлері → First Message
   • Мәтін бар екенін қамтамасыз етіңіз
   • Өзгерістерден кейін сақтаңыз

3. Промпт пен білім базасын тексеру

   • Промпт бос емес екенін қамтамасыз етіңіз
   • Білім базасын пайдалансаңыз, оның қосылғанын және мазмұны бар екенін тексеріңіз

4. Браузерде сынау

   • «Talk to agent» батырмасын басыңыз
   • Микрофонға рұқсат беріңіз
   • Сәлемдесуді күтіңіз

Агент қате ақпарат береді

Симптомдар:

• Қате бағалар келтіріледі
• Қате жұмыс уақыты айтылады
• Ойдан шығарылған ақпарат

Себеп: Әдетте білім базасы немесе промпт мәселесі.

Шешімдер:

1. Білім базасының мазмұнын тексеру

   • Дұрыс ақпарат бар ма?
   • Анық пішімделген бе?
   • Қандай да бір қайшы ақпарат бар ма?

2. KB қосылғанын тексеру

   • Агент параметрлері → Knowledge Base
   • Дұрыс KB таңдалған ба?

3. Промпт шектеулерін күшейту Промптқа қосыңыз:

   МАҢЫЗДЫ: Тек білім базасынан ақпаратты қолданыңыз.
   Білім базасында ақпарат болмаса, «Менде ол ақпарат жоқ» деңіз.
   Бағаларды, сағаттарды немесе басқа нақты мәліметтерді ЕШҚАШАН ойдан шығармаңыз.

4. Temperature төмендету

   • Temperature-ді 0.3-0.5-ке дейін азайтыңыз
   • Детерминистикалық жауаптар

Агент білім базасын қолданбайды

Симптомдар:

• Бар ақпарат туралы «Білмеймін» дейді
• Нақтының орнына жалпы жауаптар

Шешімдер:

1. KB қосылғанын растау

   • Агент параметрлері → Knowledge Base бөлімі
   • KB таңдалғаны көрсетілуі керек

2. KB мазмұнының пішімін тексеру

   • Анық тақырыптар
   • Қарапайым құрылым
   • ЖСС үшін сұрақ/жауап жұптары

3. ЖСС пішімін қосу

   С: Сіздердің жұмыс сағаттарыңыз қандай?
   Ж: Біз дүйсенбі-жұма 9:00-18:00, сенбі 10:00-14:00 ашықпыз.

4. Файл дұрыс жүктелгенін тексеру

   • Knowledge Base бөліміне өтіңіз
   • Файлдың тізімде пайда болғанын тексеріңіз
   • Файл өлшемі нөл емес екенін тексеріңіз

Агент сөйлеуді тоқтатпайды

Симптомдар:

• Өте ұзақ жауаптар
• Пайдаланушыны күтпейді
• Шамадан тыс ақпарат

Шешімдер:

1. Промптқа қосыңыз:

   - Жауаптарды 1-2 сөйлемге дейін ұстаңыз
   - Бір рет бір сұрақ қойыңыз
   - Клиенттің жауап беруін күтіңіз
   - Қысқа және тікелей болыңыз

2. Max tokens-ті төмендету

   • Параметрлерде қолжетімді болса
   • Жауап ұзындығын шектейді

---

Білім базасы мәселелері

Файл жүктеу сәтсіз

Симптомдар:

• Жүктеу кезінде қате
• Файл қабылданбады
• Өңдеу тұрып қалды

Шешімдер:

1. Файл пішімін тексеру

   • Қолдау көрсетіледі: .pdf, .docx, .doc, .xlsx, .xls, .txt, .md, .csv, .rtf, .json
   • Қолдау көрсетілмейді: суреттер, аудио, бейне файлдар

2. Файл өлшемін тексеру

   • Әр файлға максималды 10 МБ
   • Білім базасына максималды 10 файл
   • Үлкен құжаттарды бөлуге тырысыңыз

3. Файл мазмұнын тексеру

   • Құпиясөзбен қорғалмаған
   • Бүлінбеген
   • Нақты мәтінді қамтиды (сканерленген суреттер емес)

4. Басқа пішімді қолданып көру

   • PDF-ті .txt немесе .docx-қа түрлендіріңіз
   • Мәтінді жаңа құжатқа көшіріңіз

Ақпарат табылмады

Симптомдар:

• Агент «Білмеймін» дейді
• Ақпарат KB-да бар, бірақ қолданылмайды

Шешімдер:

1. Құрылымды жақсарту

   • Тақырыптар үшін анық тақырыптар
   • Жалпы сұрақтар үшін ЖСС пішімі
   • Ұзақ абзацтардан аулақ болыңыз

2. Дәл фразаларды қолдану

   • Клиенттер қалай сұрайтынына сәйкестендіріңіз
   • Сұрақтардың вариацияларын қосыңыз

3. Көбірек контекст қосу

   • Тек бағаларды тізбеңіз
   • Қызмет атаулары мен сипаттамаларын қосыңыз

Жақсарту мысалы:

❌ Нашар:

25, 35, 55

✅ Жақсы:

## Шаш қию бағалары
- Ер шаш қию: €25
- Әйел шаш қию: €35
- Бала шаш қию (12 жасқа дейін): €20

---

Телефон мәселелері

Қоңыраулар қосылмайды

Симптомдар:

• Қоңыраулар дауыстық поштаға немесе қатеге кетеді
• Шылдырлайды, бірақ жауап жоқ
• Қоңырау бірден үзіледі

Шешімдер:

1. Телефон нөмірі қосылымын тексеру

   • Integration → Phone Numbers
   • Күй «Connected» болуы керек
   • Болмаса, баптауыңызды тексеріңіз

2. Нөмір тағайындалуын тексеру

   • Phone Numbers бөлімі
   • Нөмірге агент тағайындалған ба?
   • Агент белсенді ме?

3. Телефон нөмірі күйін тексеру

   • Нөмір белсенді ме?
   • Тіркелгіде кредит балансы бар ма?

4. Браузермен сынау

   • Бақылау тақтасында «Talk to agent» қолданыңыз
   • Бұл жұмыс істесе, мәселе телефон жағында

Қате агент жауап береді

Симптомдар:

• A агентін күтті, B агенті алынды
• Қате сәлемдесу

Шешімдер:

1. Нөмір тағайындалуын тексеру

   • Phone Numbers → Нөмірді басыңыз
   • Дұрыс кіріс агенті таңдалғанын тексеріңіз

2. Веб-құжат қайшылықтарын тексеру

   • Веб-құжат Hanc.AI-ға бағытталғанын тексеріңіз
   • Басқа қызметтер ұстап қалмайды

---

Аудио мәселелері

Қоңырау сапасы нашар

Симптомдар:

• Роботтық дауыс
• Үзіндіге толы аудио
• Сөйлесудегі кідірістер

Шешімдер:

1. Интернет байланысын тексеру

   • Минимум 5 Mbps ұсынылады
   • Сымды қосылым WiFi-дан жақсырақ

2. Желі жағдайларын тексеру

   • Жоғары кідіріс немесе пакет жоғалуы қоңырау сапасын төмендетеді
   • Мүмкін болса, басқа желіні қолданып көріңіз
   • Өткізу қабілеті ауыр қосымшаларды жабыңыз

3. Браузер үйлесімділігін тексеру

   • Заманауи браузерді қолданыңыз (Chrome, Firefox, Safari, Edge)
   • WebRTC және Web Audio API қолдау көрсетілгенін қамтамасыз етіңіз
   • Браузерді соңғы нұсқаға жаңартыңыз

4. Басқа дауысты қолданып көру

   • Кейбір дауыстар әртүрлі қосылымдарда жақсырақ жұмыс істейді
   • Агент параметрлерінде баламаларды сынаңыз

5. Браузер сынақ қоңыраулары үшін

   • Басқа қойындыларды/қосымшаларды жабыңыз
   • Мүмкін болса, сымды гарнитураны қолданыңыз
   • Микрофон үнсіз қалмағанын тексеріңіз

Агент қоңырау шалушыны түсіне алмайды

Симптомдар:

• Агент қайталауды сұрайды
• Сөздерді қате түсінеді
• Қате транскрипция

Шешімдер:

1. Тіл параметрлері

   • Дұрыс тіл таңдалғанын тексеріңіз
   • Қоңырау шалушының күтілетін тіліне сәйкестендіріңіз

2. Анықтық үшін промпт Промптқа қосыңыз:

   Түсінбесеңіз, қоңырау шалушыдан қайталауын сыпайылықпен сұраңыз.

3. Сөйлеуді тануды дербес сынау

   • Сынақ қоңырау функциясын қолданыңыз
   • Анық сөйлеп, мәселелерді белгілеңіз
   • Акцент немесе аудио сапасы болуы мүмкін

---

Есеп айырысу мәселелері

Функция қолжетімді емес

Симптомдар:

• Батырма сұр түсте
• «Upgrade required» хабарламасы
• Көбірек агент жасай алмаймын

Шешімдер:

1. Ағымдағы жоспарды тексеру

   • Settings → Billing
   • Жоспар шектеулері мен функцияларын қарап шығыңыз

2. Агент жасай алмаймын

   • Free жоспары 1 агентпен шектелген
   • Шексіз агенттер үшін Starter немесе одан жоғары нұсқаға жаңартыңыз

3. Пайдалануды тексеру

   • Шектерге жақын немесе шектерде ме?
   • Келесі есеп айырысу циклін күтіңіз немесе жаңартыңыз

4. Жоспарды жаңарту

   • Қажет болса, Billing бетінен жаңартыңыз

Төлем сәтсіз

Симптомдар:

• «Payment failed» қатесі
• Қызмет үзілді
• Жазылымды жаңарта алмаймын

Шешімдер:

1. Карта мәліметтерін тексеру

   • Картаның мерзімі бітпеген бе?
   • Жеткілікті қаражат бар ма?
   • Дұрыс есеп айырысу мекенжайы?

2. Банкке хабарласу

   • Халықаралық төлемдер бөгелген бе?
   • Күдікті әрекет белгісі?

3. Төлем әдісін жаңарту

   • Settings → Billing → Update Payment
   • Басқа картаны қолданып көріңіз

4. Қолдау қызметіне хабарласу

   • Мәселе сақталса
   • support@hanc.ai

---

Виджет мәселелері

Виджет жүктелмейді

Симптомдар:

• Виджет батырмасы веб-сайтта пайда болмайды
• Виджет қатені немесе бос орынды көрсетеді
• Виджет жүктеледі, бірақ қоңырау қосылмайды

Шешімдер:

1. Домен ақ тізімін тексеру

   • Агентіңіздің виджет параметрлеріне өтіңіз
   • Веб-сайт доменіңіз рұқсат етілген домендер тізіміне қосылғанын қамтамасыз етіңіз
   • Барлық вариацияларды қосыңыз (www-мен/www-сыз)

2. Браузер талаптарын тексеру Hanc.AI виджеті келесі браузер мүмкіндіктерін талап етеді:

   • WebGL 2.0 — виджет интерфейсін рендерлеу үшін
   • Web Audio API — аудио өңдеу үшін
   • WebRTC — нақты уақыттағы дауыстық байланыс үшін

   Көптеген заманауи браузерлер (Chrome, Firefox, Safari, Edge) бұларды қолдайды. Пайдаланушылар мәселелерді хабарласа, олардан браузерін жаңартуын сұраңыз.

3. Виджет embed кодын тексеру

   • Embed скрипті HTML-де дұрыс орналастырылғанын тексеріңіз
   • JavaScript қателерін браузер консолінде тексеріңіз
   • Жарнама блоктаушылары немесе скрипт блоктаушылары кедергі жасамайтынын қамтамасыз етіңіз

4. Инкогнито режимінде сынау

   • Веб-сайтыңызды инкогнито/жеке терезеде ашыңыз
   • Бұл кеңейтім қайшылықтарын болдырмайды

Callback виджеті мәселелері

Келуші нөмір жіберді, бірақ кері қоңырау келмеді

1. Агент кері қоңыраулар үшін қосылғанын тексеріңіз — Агентті ашыңыз → Widgets қойындысы → «Enable callback widget» қосулы екенін қамтамасыз етіңіз және сақтаңыз.
2. Шығыс телефон нөмірі тағайындалғанын тексеріңіз — Агенттің нөмірлер тізімінде расталған шығыс нөмір болуы керек. Онсыз кері қоңырау жіберулері сәтсіз болады.
3. Жарамдылық ескертуін тексеріңіз — (ақылы жоспар / шығыс нөмір / расталған email) қайсысы жетіспесе, Widgets қойындысы баннерді көрсетеді.
4. Агенттің қоңырау журналын қараңыз — Сәтсіз кері қоңыраулар журналда анық қате себебімен пайда болады (мысалы, «destination number unreachable», «no outbound number available»).
5. Келуші нөмірінің пішімі дұрыс болғанын тексеріңіз — Виджет таңдалған елдің пішіміне қарсы тексереді, бірақ ел сәйкессіздігі оператор кейін қабылдамайтын нөмірді өткізіп жіберуі мүмкін.

«Queue full» хабарламасы

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

Келуші елі таңдағышта жоқ

Қамту таңдамалы. Тізімде жоқ ел қажет болса, support@hanc.ai хабарласыңыз — қамту сұранысқа қарай қосылады.

Виджет интерфейсі агенттің конфигурацияланған тілінен басқа ағылшын тілінде көрсетіледі

Виджет тілді үш дереккөзден приоритет ретімен оқиды: embed-тегі locale="…" HTML атрибуты, бақылау тақтасындағы агенттің Widget language, содан кейін ағылшын тілі резервтік ретінде. Неміс бетінде ағылшын тілін көрсеңіз, агент параметрі әлі en болуы мүмкін — оны агенттің Widgets қойындысында өзгертіңіз және сақтаңыз.

Кері қоңырау ортасында жаңарту жаңа форманы көрсетеді, кезектегі күйді емес

Бұл әдеттегі емес — виджет әдетте жаңартуда ұшу барысындағы кері қоңырауға қайта тіркеледі. Embed үзіндісі екі бет жүктеуінде бірдей екенін (бірдей agent-id, бір браузерден жіберілген бірдей нөмір) және қандай да бір құпиялылық кеңейтімі жаңартуда бетті сүртпейтінін қамтамасыз етіңіз.

---

Кредит мәселелері

Қоңырау «Кредит жоқ» дегенмен ажырайды

Симптомдар:

• Қоңырау сөйлесу ортасында кенеттен аяқталады
• Ажырату себебі NO_CREDITS көрсетеді
• Белсенді қоңырау кезінде агент жауап беруді тоқтатады

Себеп: Қоңырау барысында тіркелгіңіздегі кредит таусылды. Платформа пайдалануды жабатын кредиттер қалмаған кезде қоңырауларды ажыратады.

Шешімдер:

1. Кредит балансыңызды тексеру

   • Settings → Billing бөліміне өтіңіз
   • Қалған кредиттерді қарап шығыңыз

2. Көбірек кредит қосу

   • Көбірек айлық кредит үшін жоспарыңызды жаңартыңыз
   • Жазылымыңыздан кредиттер бірден қолжетімді

3. Пайдалануды белсенді бақылау

   • Кредит тұтынуын қадағалау үшін аналитиканы тұрақты қарап шығыңыз
   • Қолжетімді болса, пайдалану ескертулерін орнатыңыз

4. Кредит ауысуын түсіну

   • Қолданылмаған кредиттер келесі айға ауысады
   • Жазылым ақыңыздың 100% кредитке түрленеді

---

Браузер мәселелері

Бет жүктелмейді

Шешімдер:

1. Бетті жаңарту (Ctrl/Cmd + R)
2. Кэшті тазалау (Ctrl/Cmd + Shift + Delete)
3. Инкогнито режимін қолданып көру
4. Басқа браузерді қолданып көру
5. Интернет байланысын тексеру

Батырмалар жұмыс істемейді

Шешімдер:

1. hanc.ai үшін жарнама блоктаушыларды өшіру
2. JavaScript-ті қосу
3. Cookie-ні тазалау
4. Браузерді соңғы нұсқаға жаңарту

---

Интеграция мәселелері

Телефон нөмірлері қосылмайды

Шешімдер:

1. Телефон нөмірі баптауын тексеру

   • Нөмір белсенді ме?
   • Агент тағайындалған ба?

2. Тіркелгі күйін тексеру

   • Тіркелгі белсенді және кредиттері бар ма?

3. Қайта қосуды көру

   • Нөмірді ажыратып қайта қосыңыз
   • Мәселе сақталса, қолдау қызметіне хабарласыңыз

Веб-құжат оқиғаларды алмайды

Шешімдер:

1. URL-ді тексеру

   • URL ашық қолжетімді
   • HTTPS (HTTP емес)
   • Аутентификация талап етілмейді

2. Сервер жауабын тексеру

   • 200 күйін қайтаруы керек
   • 30 секунд ішінде

3. webhook.site-пен сынау

   • Оқиғалар жіберілгенін тексеру үшін сынақ URL-ін қолданыңыз
   • Сол жерден жөндеңіз

---

Көмек алу

Қолдау қызметіне хабарласпас бұрын

Осы ақпаратты жинаңыз:

• Тіркелгі email-і
• Агент аты/ID (қолданылатын болса)
• Қате скриншоты
• Мәселені қайталау қадамдары
• Қолданылған браузер мен құрылғы

Қолдау қызметіне хабарласу

Email: support@hanc.ai

Қосыңыз:

• Мәселенің анық сипаттамасы
• Қашан басталды
• Не қолданып көрдіңіз
• Скриншоттар, пайдалы болса

Жауап беру уақыты:

• Стандартты: 24 сағат ішінде
• Pro/Business: 4 сағат ішінде

---

Күй беті

Үзілістер үшін платформа күйін тексеріңіз:

• Жүйе күйі туралы хабарландырулар
• Жоспарланған техникалық қызмет көрсету терезелері
• Тарихи uptime

---

Қатысты тақырыптар

• Платформаға шолу — Интерфейс нұсқаулығы
• Дауыстық агенттер — Агент конфигурациясы
• Білім базасы — KB үздік тәжірибелері
• Интеграциялар — Интеграцияны баптау