التوثيق

المساعدة

استكشاف الأخطاء

Find the cause and the fix by symptom: the widget does not appear, the AI does not answer, a channel stops delivering, billing or credits problems, and access errors.

آخر تحديث: 2026-10-05

Use this page when something does not work. Find the area that matches your problem, read the row that matches what you see, and follow the fix. Each section links to the detailed page.

Before you start, two checks solve many problems: confirm you are signed in to the right workspace, and confirm the workspace is not read-only (for example after a lapsed subscription).

Dashboard navigation#

When you change screens, the sidebar stays available and the destination shows a loading placeholder until it is ready. You can navigate with the keyboard as well as the pointer. In the inbox, Account and Work details load when you open their Context tab.

Opening the website#

The public website shows Sign in while it checks your session. If you are already signed in, the navigation changes to Open workspace. You can select Sign in during this check to continue with your existing session, choosing a workspace if needed.

The language switch keeps the page's query parameters. Public pages use Sela's branding. Your saved dashboard appearance is used when you return to your workspace.

The web chat widget#

SymptomLikely causeFix
No chat button and no errorThe script uses data-org-idThe attribute must be data-organization-id. Change it in your snippet.
No chat buttonWrong or missing Organization IDCopy the ID again from Integrations, in the Website Widget section.
No chat buttonScript is not on the page, or your site builder stripped itView the page source and search for widget.js. Publish the site after pasting.
No chat buttonScript tag is type="module"Use a normal script tag with the attributes written on it.
Button missing only on phonesdata-hide-on-mobile="true" is setRemove it, or set it to false. It hides the widget on screens 768 px wide or narrower.
Button missing, site has a Content Security PolicyThe policy blocks SelaAllow https://usesela.com for scripts and https://widget.usesela.com for frames.
Button missing only for some visitorsAd blocker or privacy extensionTest in a private window with extensions off.
Button shows, chat is blank or shows an errorOrganization ID does not match a workspace, or the page blocks framesCheck the ID and your policy.
Chat asks for login and rejects visitorsStrict mode (Disable Manual Login) is onSend identity-verified sessions or turn strict mode off. See Identity verification (HMAC).
Color, size or position did not changeButton look comes from the snippet attributesEdit the attributes in the snippet on your site. See Widget JavaScript API.
A returning visitor lost their historyHistory belongs to the browser sessionExpected on another device, in a private window, or after clearing browser data.
Customer cannot attach filesThe attach button appears after a chat is escalated to a humanExpected while the AI handles the chat.

Full checklist: Web chat widget.

The AI does not answer#

When the AI stays silent, the customer sees nothing and the conversation waits in the inbox for your team. Work through the reasons in this order. They are the checks the assistant must pass on every message.

SymptomLikely causeFix
No AI reply on any channel, AI pages show a locked stateThe AI Assist add-on is not on your plan, or the subscription is not activeCheck Settings, Data & plan, Plan & usage. See Plans and billing.
No AI reply, everything else looks finePlan credits and the wallet are both emptyTop up the wallet or add credit blocks. See Credits and usage.
No AI reply on any channel, even after setupNo saved assistant profileOpen AI assistant, then the Identity tab, and save a profile. See Assistant identity and scope.
No AI reply anywhereAI in this workspace or Automatic replies is offTurn them on from the AI assistant page. See Turning AI on and off.
An AI button says AI is turned off for this workspaceSomeone turned off AI in this workspaceSelect Turn on AI, or ask someone who manages settings.
The assistant stays quiet in one conversation after a reply from the WhatsApp Business app or InstagramReplies from a channel's own app switch that conversation to AI offSelect AI off in the conversation header to hand it back.
No reply on one conversationThe conversation is closedReopen it.
No reply on one conversationIt is Escalated, or an operator is assignedClear the escalation and the assignee.
No reply after you pressed Hand back to assistantHanding back only changes handlingReopen the conversation (status Open) and remove the assignee. See AI control and takeover.
No reply on one conversationHandling is paused, human requested or human activeUse Hand back to assistant in the conversation header.
No reply for a short timeA cooldown after misuse, or a guided WhatsApp Flow is runningWait. Your team can still reply.
No reply on WhatsApp onlyThe channel's AI automation switch is off, or the connection path does not support itTurn it on for the WhatsApp card in Integrations. See WhatsApp.
Replies stopped for everyone brieflyA protective stop on answer quality closedIt closes by itself. Check answer quality in Improving answer quality.
Replies are hedged ("I could not verify this")The fact is missing or conflicts across sourcesAdd the fact to the knowledge base or catalog.
Answers about prices or stock are wrongLive data lives in the catalog, not in documentsFix the catalog. See Catalog and products.
Wrong language or dialectNo language rule, or Arabic product and area names are not aliasedAdd a language rule to the identity and aliases to your content.
The AI answered after hoursBusiness hours do not switch the AI offSet the option to keep the AI quiet outside hours in Business hours if you want that.
A voice note or image got no understandingMedia Understanding is off, or credits are emptyTurn it on in the widget behavior settings and check credits.
A file is stuck or failed in the knowledge baseIndexing failed, often from empty creditsPress Retry after topping up. Wait for ready before testing.

Details for the whole sequence: How the AI works.

Channels and delivery#

SymptomLikely causeFix
Reply banner mentions the 24-hour windowOn WhatsApp, Messenger and Instagram the customer's last message is over 24 hours oldOn WhatsApp send an approved template or broadcast. On Messenger and Instagram wait for the customer to write. See WhatsApp.
Reply refused, conversation is read-onlyThe thread is closed, the channel is disconnected, or it is an imported archiveReopen the conversation or reconnect the channel.
Reply refused, workspace is read-onlyA lapsed or restricted accountRestore the plan. See Plans and billing.
Integration card says Needs attention or DisconnectedExpired or revoked connectionReconnect the channel from Integrations.
No incoming messages on one channelA provider connection or webhook problemCheck the card status, then the provider's delivery log.
Banner shows code SEND_ENQUEUE_FAILEDAn unexpected error inside SelaCopy the 16-character Reference from the banner and send it to support.
Cannot connect WhatsAppThe number is still active in the WhatsApp or Business appUse a coexistence path or migrate the number.
A channel card is missingThat connection path is not enabled for your workspaceAsk support.
Calls connect but have no audioNo relay is configured for callsSee Calls.
Email or SMS setup refusedPlan below Inbox or no permission to manage settingsUpgrade, or ask an admin. See Email and SMS.

Full guide with per-channel causes: Delivery troubleshooting. Other channel pages: Messenger and Instagram, Telegram.

Billing and credits#

SymptomLikely causeFix
Paid, but the plan has not changedThe payment confirmation has not arrived yetWait a minute and reload Plan & usage. The confirmation is retried safely.
Checkout says billing is "not enabled for this workspace yet"The new checkout has not been switched on for youContact support.
Cannot buy or change a planYou are not an admin or owner, or you are inside a branchAsk an admin. Purchases are made in the paying workspace. See Multiple branches.
Checkout refuses fewer branchesYou already have more branches set upArchive branches first.
Credits dropped after uploading filesIndexing uses credits, and PDFs and scans cost moreExpected. See Credits and usage.
One reply used two chargesA reply involves more than one AI stepExpected.
Credits vanished at month endPlan credits reset monthly and do not carry overUse the wallet, which does not expire, or add credit blocks.
Wallet top-up is lockedThe AI Assist add-on ended before the payment finishedThe money is kept and unlocks when AI is active again.
AI features look unavailable after paymentThe add-on is missing (no credit blocks)Check Plan & usage.
Sandbox workspace stopped accepting conversationsSandbox allows 10 conversations in totalUpgrade. See Plans and billing.
Storage upload failsThe storage limit is enforcedBuy a storage pack or delete files.
An automation run failed with no actionsThe run limit is enforcedBuy a run pack. See Automations and proactive messages.
New team member cannot joinAll seats are in useAdd seats from Manage capacity. See Team, roles and permissions.

Access and permissions#

SymptomLikely causeFix
A screen says a feature is "not enabled for this workspace"A feature switch is off for your workspace. It is not a plan problem.Ask support to enable it.
Padlock on a sidebar itemYour plan does not include itChoose the item to go to Plan & usage.
A page is visible but read-onlyYou lack the permission to manage itAsk an owner, admin or manager. See Team, roles and permissions.
Phone numbers and emails are partly hiddenYour role cannot reveal contact detailsOnly owner, admin and manager can reveal them.
Cannot export contactsOnly owner and admin canAsk one of them.
REST API returns 401 unauthorizedWrong key, or the plan lapsedCheck the key and that the plan is Scale or higher. See REST API.
API keys or webhooks are missingThey need Scale or Enterprise, and are enabled per workspaceSee Plans and billing.
Signed in but cannot see a workspaceYou have not accepted the invitationAccept the emailed invitation.
Push notifications do not arrive on the phonePermission denied, wrong workspace, or battery savingSee Mobile app.
"This conversation changed since it was loaded"Someone else updated it while you were lookingReload and retry.

When to contact support#

Contact support if a fix does not work or you see SEND_ENQUEUE_FAILED. Give the workspace name, the channel, the approximate time, what you tried, and the 16-character reference if one is shown. Do not include customer message text or phone numbers. Support is under Settings, then Data & plan, then Support.