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
- Left menu → Help: see the relevant guide on that page (the source of these guides).
- Write to merhaba@yanitlabs.com with a screenshot and the message you see.
- 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.