—SETUP GUIDE

FAQ and troubleshooting

The assistant does not answer, does not use knowledge, or the connection fails: fixes for three problems.

Time 6 min Steps 3 Read 4 min read Setup
01 The assistant does not answer02 The assistant does not use knowledge03 Connection failed

1) "The assistant does not answer"

Possible cause How to check / fix
The assistant is Draft or Paused Assistants → Edit → Status = Active. A draft assistant does not answer customers.
No assistant is assigned to the channel Connections → channel card → Edit → Assistant field. The first option is Not connected; choose your assistant. The card should read "Messages from this channel are answered by AI."
The channel is not connected at all If the channel card says "Channel not connected; messages are not being processed.", connect the channel again.
Marketplace credentials were not entered If the channel card shows the Credentials not entered badge and the text "Credentials have not been entered; this channel does not count as connected.", enter the keys again.
No assistant on the web widget "No assistant is linked to the widget channel — assign one from the Connections screen." → assign an assistant to the website chat channel under Connections.
Prerequisites are missing WhatsApp: a verified WhatsApp Business number + Meta Business. Instagram/Facebook: a Professional account + a Facebook Page. Telegram: a bot token.
Trial channel allowance is full The trial includes 1 paid channel. The website chat widget and Telegram are outside this allowance; a second WhatsApp/Instagram/Trendyol channel cannot be connected before the trial ends.
The assistant says "I don't have that information" and hands over The conversation lands in the Inbox. Reply there with Take over.
The reply was not delivered to the customer If the Inbox says " Reply saved but NOT DELIVERED to the customer (channel not connected).", connect the relevant channel.

2) "The assistant does not use knowledge"

Possible cause How to check / fix
No knowledge base is linked to the assistant Assistants → Edit → the Knowledge base field must not be Not connected; choose your own knowledge base.
The document is not ready yet Knowledge Center → Documents: if the status is Queued or Processing, wait a few minutes; the assistant uses it once it is Ready.
The document is Failed Delete the document and add it again; try pasting the text manually instead of using a PDF.
Scanned PDF If the May be scanned badge and the warning "Document saved but the assistant cannot use this content." are shown, paste the text manually (see the knowledge base guide).
Content is too thin / empty Enrich the document with Edit: write concrete prices, durations and conditions.
Content is stale Press Rescan on the web page / sitemap document.
The test screen is misleading Overview → Test assistant does not use the knowledge base; it only shows the tone. For a real test, ask through the Widget or a connected channel.
Wrong information remains The knowledge source cannot be deleted/updated; correct the document with Edit or Delete.

3) "Connection failed"

Message you see What it means / what to do
Connection could not be established. General error. Check the fields and try again.
Credentials rejected (401) Trendyol: the Seller ID / API Key / API Secret is wrong or contains spaces. Hepsiburada: the Merchant ID may have been entered by mistake in the Developer Username field.
Authorisation denied (403) On the Trendyol order source, choose Environment = Production (Test/Stage requires an IP declaration). On Hepsiburada, the credentials may not have order permission.
Address not found (404) The Seller ID or the environment address is wrong.
Too many requests (429) Try again shortly.
Merchant ID, Secret Key and Developer Username are all required. On Hepsiburada, all three fields must be filled in.
Seller ID, API Key and API Secret are all required. On Trendyol, all three fields must be filled in.
Meta SDK could not load (the browser may be blocking it) Disable the ad blocker and refresh the page.
Meta approval screen timed out. Try again. Restart the WhatsApp/Instagram connection.
No Facebook Page you can manage was found. … Instagram must be Professional and linked to a Facebook Page.
Invalid bot token format. … Copy the Telegram token from BotFather in full.
Telegram connection could not be established. … one token can only be connected to one target at a time … Each organisation should use its own bot; get a new token with /token in BotFather.
Approval expired (WooCommerce) Press Create new connection and restart the approval.
A new tab may not have opened (WooCommerce) The browser is blocking the pop-up; click the Approval link.
The channel card shows Credentials not entered The keys were not saved; open the channel and enter the keys.
Trial: one more channel cannot be connected The trial includes 1 paid channel. The website chat widget and Telegram do not count; upgrade to a plan for a second WhatsApp/Instagram/Trendyol channel.

Still not resolved

  1. Left menu → Help: see the relevant guide on that page (the source of these guides).
  2. Write to merhaba@yanitlabs.com with a screenshot and the message you see.
  3. Do not share your secrets (token, API key, password) by email or message; send only the error message.

Checklist

  • The assistant does not answer
  • The assistant does not use knowledge
  • Connection failed

The source of this guide had 1 screenshots; they were not moved to the new site. The text is preserved; images will be added in a separate step.

+RELATED POSTS

Posts on this topic

Posts from the same topic cluster that complete this page. Blog archive.

Let’s set it up together.

Try free for 14 days, no credit card. Setup support included; cancel anytime.

Call Start 14-day trial