Chat op je website plaatsen: troubleshooting

Kort antwoord: verschijnt de chatknop niet, dan staat het exacte adres van je website meestal niet in de lijst toegestane sites — schema (https://), (sub)domein en poort moeten precies kloppen. De widget toont je bezoeker enkel een algemene melding; de echte reden vind je in de netwerk-tab van de browser.

De chatknop verschijnt helemaal niet

Dit is veruit de meest voorkomende klacht, en bijna altijd een kwestie van de allowlist:

• Het websiteadres staat niet (exact) in de lijst Websites waar chat mag verschijnen. Schema, (sub)domein en poort moeten exact overeenkomen.
• De website draait op http:// (alleen https:// is toegestaan, behalve localhost voor tests).
• De koppeling of de site-sleutel is uitgeschakeld.
• Je plan bevat de website-chat niet (het is een betaalde functie).

"Opstarten van chat is mislukt"

De opstart-aanvraag faalde. Meestal:

• Te veel verzoeken kort na elkaar — bijvoorbeeld een pagina die de chat in een lus herlaadt.
• Het abonnement is niet (meer) actief, of je plan bevat de chat niet.

"Verzenden mislukt. Probeer opnieuw."

Het versturen van een bericht faalde:

• Te veel berichten kort na elkaar.
• Het abonnement is gepauzeerd, het plafond is bereikt of het is geannuleerd. Dan zwijgt Sarrai volledig en ziet de bezoeker enkel deze algemene melding — geen "abonnement verlopen".

De bezoeker blijft "anoniem" terwijl je hem herkend wou hebben

Plaatste je de chat achter een login en zou Sarrai de ingelogde bezoeker automatisch moeten herkennen? Dan is de vertrouwde identiteit niet doorgekomen: het token is verlopen of ongeldig, of je hebt het identiteitsgeheim vernieuwd zonder de andere kant bij te werken. De chat blijft werken, maar zonder herkende identiteit.

De snelste manier om de échte reden te vinden

Omdat je bezoeker altijd een algemene melding krijgt, open je het best zelf de netwerk-tab van je browser op de pagina met de chat. De geweigerde aanvraag noemt de echte oorzaak in een X-Sarrai-Embed-Reason-header (bijvoorbeeld dat de origin niet is toegestaan of dat de functie niet in je plan zit).

Ook gezocht als

"waarom zie ik mijn chatbot niet", "chat laadt niet op mijn website", "de widget doet niets", "chatknop ontbreekt"

Zie ook

• De chat-agent op je eigen website plaatsen