Dažniausios klaidos

Šiame vadove aprašomos dažniausios klaidos, su kuriomis galite susidurti naudodami Conviro, ir kaip jas išspręsti.

HTTP 401 -- Unauthorized

Reikšmė: Jūsų API raktas arba seanso prieigos raktas yra neteisingas arba nebegalioja.

Priežastys ir sprendimai:

• Neteisingas API raktas -- patikrinkite raktą skiltyje Dashboard -> Settings -> API Keys
• API raktas atšauktas -- sugeneruokite naują raktą ir atnaujinkite savo integraciją
• Baigėsi seanso galiojimas -- atsijunkite nuo valdymo skydo ir prisijunkite iš naujo
• Trūksta Authorization antraštės -- įsitikinkite, kad jūsų API užklausoje yra Authorization: Bearer sk_your_key

HTTP 403 -- Forbidden

Reikšmė: Neturite teisių pasiekti šio ištekliaus.

Priežastys ir sprendimai:

• Domenas neleidžiamas -- pridėkite savo svetainės domeną skiltyje Dashboard -> Assistants -> Your Bot -> Channels -> Allowed Domains
• Pasiektas plano limitas -- bandote naudoti funkciją, kurios nėra jūsų dabartiniame plane (pvz., WhatsApp su Starter planu)
• Rolės apribojimas -- jūsų komandos rolė (Agent) gali neturėti teisių šiam veiksmui; kreipkitės į Admin arba Owner
• Botas neaktyvus -- suaktyvinkite botą skiltyje Dashboard -> Assistants

HTTP 404 -- Not Found

Reikšmė: Prašomas išteklius neegzistuoja.

Priežastys ir sprendimai:

• Netinkamas galinis taškas -- teisingų URL ieškokite API dokumentacijoje adresu /developers
• Ištrintas išteklius -- pokalbių robotas, seansas arba kontaktas buvo ištrintas
• Klaida ID -- patikrinkite ištekliaus ID savo užklausos URL

HTTP 429 -- Too Many Requests (Užklausų limitas)

Reikšmė: Viršijote savo plano API užklausų limitą.

Priežastys ir sprendimai:

• Patikrinkite atsakyme esančias užklausų limito antraštes:

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

• Sumažinkite užklausų dažnį -- įtraukite delsą arba apjunkite operacijas
• Pereikite prie aukštesnio plano -- aukštesniuose planuose taikomi didesni užklausų limitai
• Kaupkite atsakymus podėlyje -- venkite kartoti tą pačią užklausą

Užklausų limitai pagal planą:

CORS klaidos

Reikšmė: Naršyklė blokuoja kitos kilmės (cross-origin) užklausą.

Požymis: Naršyklės konsolėje matote klaidą, pavyzdžiui, Access to XMLHttpRequest has been blocked by CORS policy.

Priežastys ir sprendimai:

• Valdiklio domenas neleidžiamas -- pridėkite savo domeną į Allowed Domains sąrašą
• Mišrus turinys -- jei valdiklis įkeliamas per HTTPS, įsitikinkite, kad jūsų svetainė naudoja HTTPS (o ne HTTP)
• Tarpinio serverio ar CDN trikdžiai -- patikrinkite, ar jūsų CDN nepašalina CORS antraščių

Nepavykę webhook pristatymai

Reikšmė: Conviro išsiuntė webhook, bet jūsų serveris neatsakė 2xx būsenos kodu.

Priežastys ir sprendimai:

• Serveris neveikia -- patikrinkite, ar jūsų webhook galinis taškas veikia ir yra pasiekiamas
• Baigėsi laukimo laikas -- Conviro atsakymo laukia 10 sekundžių. Įsitikinkite, kad jūsų galinis taškas atsako greitai
• SSL sertifikato problema -- jūsų galinis taškas turi turėti galiojantį SSL sertifikatą (savarankiškai pasirašyti sertifikatai nepriimami)
• Blokuoja užkarda -- įtraukite Conviro IP adresų intervalą į savo užkardos leidžiamų sąrašą
• Neteisingas URL -- patikrinkite webhook URL skiltyje Dashboard -> Settings -> Webhooks

Kartojimo politika: Conviro nepavykusius webhook kartoja 3 kartus didėjančiais intervalais (1 min., 5 min., 30 min.). Po 3 nesėkmingų bandymų webhook pažymimas kaip nepavykęs ir jūs gaunate pranešimą el. paštu.

Pristatymo žurnalus rasite skiltyje Dashboard -> Settings -> Webhooks -> Delivery Log.

Pasiektas žinučių limitas

Reikšmė: Išnaudojote visas mėnesio žinutes.

Priežastys ir sprendimai:

• Free/Starter -- pokalbiai pristabdomi iki kito atsiskaitymo laikotarpio. Norėdami gauti daugiau žinučių, pereikite prie aukštesnio plano.
• Pro/Growth -- įjunkite viršijimo apmokestinimą skiltyje Dashboard -> Settings -> Billing, kad papildomi žinučių paketai būtų perkami automatiškai.
• Patikrinkite naudojimą -- stebėkite savo suvartojimą skiltyje Dashboard -> AI Usage.

Bendrieji patarimai

• Dėl kliento pusės klaidų visada patikrinkite naršyklės konsolę (F12).
• Kilus API klaidoms, peržiūrėkite atsakymo turinį -- jame paprastai pateikiamas aiškinamasis klaidos pranešimas.
• Patikrinkite Conviro būsenos puslapį, ar nėra vykstančių incidentų arba techninės priežiūros darbų.
• Jei problemos išspręsti nepavyksta, rašykite [email protected] ir nurodykite klaidos informaciją, užklausos ID (jei yra) bei veiksmus klaidai atkartoti.