Levinumad vead

See juhend käsitleb kõige sagedasemaid vigu, mis võivad Conviro kasutamisel ette tulla, ja nende lahendamist.

HTTP 401 -- Unauthorized

Tähendus: Teie API-võti või seansi token on kehtetu või aegunud.

Põhjused ja lahendused:

• API-võti on vale -- kontrollige võtit asukohas Dashboard -> Settings -> API Keys
• API-võti on tühistatud -- looge uus võti ja uuendage oma integratsiooni
• Seanss on aegunud -- logige juhtpaneelilt välja ja seejärel uuesti sisse
• Authorization päis puudub -- veenduge, et teie API päring sisaldab Authorization: Bearer sk_your_key

HTTP 403 -- Forbidden

Tähendus: Teil pole õigust sellele ressursile ligi pääseda.

Põhjused ja lahendused:

• Domeen pole lubatud -- lisage oma veebisaidi domeen asukohas Dashboard -> Assistants -> Your Bot -> Channels -> Allowed Domains
• Paketi limiit on täis -- proovite kasutada funktsiooni, mis pole teie praeguses paketis saadaval (nt WhatsApp Starter paketis)
• Rollipiirang -- teie meeskonnaroll (Agent) ei pruugi selleks toiminguks õigusi omada; pöörduge Admin või Owner rolliga kasutaja poole
• Bot on passiivne -- aktiveerige bot asukohas Dashboard -> Assistants

HTTP 404 -- Not Found

Tähendus: Soovitud ressurssi pole olemas.

Põhjused ja lahendused:

• Vale lõpp-punkt -- kontrollige õigeid URL-e API dokumentatsioonis aadressil /developers
• Kustutatud ressurss -- vestlusrobot, seanss või kontakt on kustutatud
• Kirjaviga ID-s -- kontrollige päringu URL-is olevat ressursi ID-d

HTTP 429 -- Too Many Requests (Päringupiirang)

Tähendus: Olete ületanud oma paketi API päringupiirangu.

Põhjused ja lahendused:

• Kontrollige vastuses olevaid päringupiirangu päiseid:

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

• Vähendage päringute sagedust -- lisage viivitusi või koondage toimingud kokku
• Uuendage oma paketti -- kõrgematel pakettidel on suuremad päringupiirangud
• Puhverdage vastuseid -- vältige sama päringu korduvat saatmist

Päringupiirangud paketi järgi:

CORS vead

Tähendus: Brauser blokeerib eri päritoluga (cross-origin) päringu.

Sümptom: Brauseri konsoolis kuvatakse viga nagu Access to XMLHttpRequest has been blocked by CORS policy.

Põhjused ja lahendused:

• Vidina domeen pole lubatud -- lisage oma domeen Allowed Domains loendisse
• Segasisu -- kui vidin laaditakse HTTPS-i kaudu, veenduge, et teie sait kasutab HTTPS-i (mitte HTTP-d)
• Puhverserveri või CDN-i sekkumine -- kontrollige, kas teie CDN eemaldab CORS päiseid

Webhookide edastamise tõrked

Tähendus: Conviro saatis webhooki, kuid teie server ei vastanud 2xx olekukoodiga.

Põhjused ja lahendused:

• Server ei tööta -- kontrollige, kas teie webhooki lõpp-punkt töötab ja on ligipääsetav
• Ajalõpp -- Conviro ootab vastust 10 sekundit. Veenduge, et teie lõpp-punkt vastab kiiresti
• SSL-sertifikaadi probleem -- teie lõpp-punktil peab olema kehtiv SSL-sertifikaat (ise allkirjastatud sertifikaate ei aktsepteerita)
• Tulemüür blokeerib -- lisage Conviro IP-vahemik oma tulemüüri lubatud loendisse
• Vale URL -- kontrollige webhooki URL-i asukohas Dashboard -> Settings -> Webhooks

Kordamise reeglid: Conviro proovib ebaõnnestunud webhooke uuesti 3 korda eksponentsiaalselt kasvava viitega (1 min, 5 min, 30 min). Pärast 3 ebaõnnestumist märgitakse webhook tõrkuvaks ja te saate e-kirjaga teavituse.

Kontrollige webhookide edastuslogisid asukohas Dashboard -> Settings -> Webhooks -> Delivery Log.

Sõnumilimiit on täis

Tähendus: Olete ära kasutanud kõik oma kuu sõnumid.

Põhjused ja lahendused:

• Free/Starter -- vestlused peatatakse kuni järgmise arveldusperioodini. Suurema sõnumimahu saamiseks minge üle kõrgemale paketile.
• Pro/Growth -- lubage ülekasutuse arveldamine asukohas Dashboard -> Settings -> Billing, et lisasõnumipakke automaatselt osta.
• Kontrollige kasutust -- jälgige oma tarbimist asukohas Dashboard -> AI Usage.

Üldised näpunäited

• Kliendipoolsete vigade puhul kontrollige alati brauseri konsooli (F12).
• API vigade korral vaadake vastuse sisu -- see sisaldab tavaliselt selgitavat veateadet.
• Vaadake Conviro olekulehte, et näha käimasolevaid tõrkeid või hooldustöid.
• Kui te ei suuda probleemi lahendada, kirjutage aadressile [email protected], lisades vea üksikasjad, päringu ID (kui see on olemas) ja sammud vea taasesitamiseks.