Ask, act, and teach with Yuna
Use natural language to query data, complete actions, and teach AI customer service.
Updated 2026-08-30
A white-label chat bubble for your site
Send and receive through your own system
Bring customer email into one inbox
Connect WhatsApp Business to serve customers
Connect Facebook Pages and handle messages
Receive and reply to Instagram DMs
Connect a LINE Official Account
Connect a Telegram bot for customer messages
Pending — subject to TikTok review and authorization
Connect a Zalo Official Account
Receive and reply to comments
Connect official enterprise customer service accounts
Customer contacts, group chats, and agent collaboration
Authorize securely with Facebook
No App Secret, verify token, or Page token to copy. YundaDesk lists manageable Pages and checks the connection automatically.
Authorize myself
The current staff member manages the Facebook Page.
Connect with FacebookSelect a Facebook Page
Complete authorization in the new tab. It closes automatically and returns the result to this workspace.
YundaDesk subscribes messages, postbacks, delivery, and read events, then runs a live connection check.
Finish connectionChoose your email provider
Connect an existing mailbox. Gmail and Outlook use official authorization; other mailboxes use a password or app password.
Enter your email address
We will prefill common mail settings from the email domain. You can still enter them manually when the provider is unknown.
No preset matched. You can enter the mail settings manually in the next step.
Advanced settings
imap.yourbrand.com · 993smtp.yourbrand.com · 465Save disabled first, test IMAP and SMTP, and enable the channel only after both pass.
Connect & enableSelect customer service accounts
Each selected account becomes an independent channel that is enabled immediately, with AI replies off by default.
Applies only to this Website Widget channel. The channel name and theme color are channel-specific too.
Enter the title, description, and welcome message in one language. They are translated automatically for each visitor and reused afterward.
Copy the code below and paste it into your website to load the chat widget.
Copy it into your website, bot profile, or integration docs.
Copy<script src="https://cdn.yundadesk.com/widget.js" data-yd-key="yd_widget_main" async></script>- Widget Key
- yd_widget_main
- Script URL
- https://cdn.yundadesk.com/widget.js
- Direct link
- https://cdn.yundadesk.com/?widget_key=yd_widget_main
Telegram bot setup guide
Three steps: ① find @BotFather to create a bot and get the token → ② paste the token on the left → ③ save and enable; the system receives new messages automatically.
1. Create a Telegram bot
- In Telegram, search for @BotFather and open the chat.
- Send /newbot to create a new bot.
- Follow the prompts to set a display name and username (ending in _bot).
- Copy the bot token returned by BotFather.
2. Enter the token on the left and enable
- Paste the token into “Bot Token” on the left.
- Click “Save” at the top, then “Enable”.
- Click “Test connection” to verify the bot token works.
3. Test the bot
- Search for the bot username in Telegram and start a chat.
- Send any message and AI / an agent will reply automatically.
- See Telegram Bot API docs.
The channel credential has expired. Please reauthorize and try again.
Connection failedTelegram bot setup guide
Three steps: ① find @BotFather to create a bot and get the token → ② paste the token on the left → ③ save and enable; the system receives new messages automatically.
1. Create a Telegram bot
- In Telegram, search for @BotFather and open the chat.
- Send /newbot to create a new bot.
- Follow the prompts to set a display name and username (ending in _bot).
- Copy the bot token returned by BotFather.
2. Enter the token on the left and enable
- Paste the token into “Bot Token” on the left.
- Click “Save” at the top, then “Enable”.
- Click “Test connection” to verify the bot token works.
3. Test the bot
Callbacks go through YundaDesk fixed secure egress. If your receiver restricts sources, add the egress IPs to its allowlist.
Callbacks go through YundaDesk fixed secure egress. Allowlist these IPs: 203.0.113.10, 203.0.113.11
View allowlist IPsCustom API setup guide
1. Create a Custom API channel
- Enter the channel name and “your system callback URL” on the left.
- After saving, the system generates a connection key and signing key to confirm message ownership and request authenticity.
- (Optional) Add an IP allowlist to restrict sources.
2. Forward customer messages to YundaDesk
- POST messages as JSON to the webhook URL above.
- Include the connection key, timestamp, signature, and idempotency key in the headers.
- A 200 response means received; other statuses are treated as failures and retried.
3. Receive reply pushes
- Once enabled, YundaDesk pushes agent / AI replies to the “your system callback URL” you entered on the left.
- Deduplicate by external message ID for idempotency.
| Event | Time | Status |
|---|---|---|
| message.created | 2026/07/28 14:20 | Delivered |
| message.created | 2026/07/28 14:06 | Timeout · retrying |
| conversation.assigned | 2026/07/28 13:41 | Signature rejected |
Install one YundaDesk plugin to add live chat, AI support, and a secure Widget binding to a WordPress site.
Use the same YundaDesk WordPress plugin; after WooCommerce is detected and authorized read-only, sync store, customer, order, product, and current cart context.
Connect a BigCommerce store, sync customer order context, and show recent orders in the workspace sidebar.
This WordPress site will be linked to the current workspace, then returned to WordPress Admin to complete the PKCE exchange.
- Site
- https://wp-review.yundadesk.com
- Workspace
- YundaDesk Review
- Versions
- YundaDesk 1.0.0 · WordPress 7.0.2
- WooCommerce
- 10.9.4 detected; read-only store access still requires a separate approval after site connection
This confirmation creates only the site binding and public Widget configuration. It does not read WooCommerce store data. Read-only WooCommerce access must be approved separately in WordPress Admin.
| Customer | Contact | Channel / source | Location | Last interaction |
|---|---|---|---|---|
| MMaria Garcia | Web Widget | 05/18 | ||
| LLukas Schneider | Telegram+49 30 123456 | 05/20 | ||
| AAna Silva | 05/22 |
Check whether AI is safe to serve, what it answers from, and what needs you.
3 outreach tasks open
Look it up using the order number.
Last 3 real matches: Web Widget · Custom API — 1 externally delivered, 2 pending verification, 0 failed.| Category | Capability | Status | Current state | Integration path |
|---|---|---|---|---|
| Proactive outreach | Broadcast noticeCreate a broadcast draft for a channel or all reachable customers. | Draft only | Batch delivery is missing, so AI cannot send directly to every customer. | Connect batch delivery; until then, only confirmed drafts are allowed. |
| Proactive outreach | Private customer messagePrepare or send a follow-up to one specific customer. | Not available yet | This plan does not include the capability yet. | This capability is not available yet and requires no setup now. |
| Proactive outreach | Segment outreachFind customers by conditions and draft outreach for that segment. | Needs setup | Customer segment search is missing, so the target audience cannot be located. | Connect customer segment search to enable this capability. |
| Customer data | Customer profile readRead customer profiles to enrich answers, memory, and outreach decisions. | Available | Read customer profiles to enrich answers, memory, and outreach decisions. | Yuna can use this in learning, answering, and outreach decisions. |
↳Yes, Brazil shipping usually takes 7-12 business days.
Human answered·1↳Auto-detect VIP customers · Detect VIP status and prompt agents to follow up first.
Human answered·1·L2 risk↳Opened items can be returned within 30 days if the package is complete.
Human answered·1↳If DHL has not updated for over 72 hours, check the order first, then hand off for compensation review.
You corrected·1·L2 risk| Skill | Status | Use case | Last 7 days | Actions |
|---|---|---|---|---|
| Order tracking lookupWhen a customer asks where an order is, look it up first, then reply in brand voice. | Active | Lookup | Used 12 times92% success | › |
| Auto-detect VIP customersDetect VIP status and prompt agents to follow up first. | Testing | Triage | Not used yet | › |
When a customer asks where an order is, look it up first, then reply in brand voice.
Choose a customer scenario and run a side-effect-free simulation with the production executor.
Simulation never messages customers or performs real external actions.
Shows real customer-conversation calls only; scenario simulations are excluded.
| Dimension | Conversations | Messages | Avg. first response | Resolved | Share |
|---|---|---|---|---|---|
| Web Widget | 712 | 4,128 | 38s | 496 | 60% |
| Telegram | 284 | 1,620 | 45s | 219 | 24% |
| 198 | 980 | 3m 12s | 146 | 17% |
Profile & project
Agent identity
Basic information
Project identity
Team members
| Member | Role | Status & skills | Last sign-in | Last used | Actions |
|---|---|---|---|---|---|
| ACAnna ChenMeanna@yundadesk.testOnline | Admin | ActiveEnglishRefundsMax 12 concurrent | Today, 09:42 | 2 min ago | |
| LWLeo Wangleo@yundadesk.testOnline | Agent | ActiveEnglishAfter-salesMax 6 concurrent | Yesterday, 18:20 | Today, 10:06 | |
| MGMaria Garciamaria@yundadesk.testOffline | Agent | PendingSpanishPre-salesMax 8 concurrent | — | — |
Notifications
Notification permission
Notification settings
Notification scenes
Test notification
Send testSend a test notification to verify everything works.
Send key
Send-key preference for the conversation input, saved per agent.
Proactive outreach
SaveOutreach policy
Anti-spam and confidence
Human review
Subscription & usage
Upgrade planBuy AI CreditPurchase historyContact opsUsage quotas
Entitlement gate
Write actions are allowed based on workspace status, feature flags and quota usage.
Could not establish a secure connection. If the site is HTTP-only, crawl it again with an http:// URL
| Document | Size | Tags | Updated | Status | Actions |
|---|---|---|---|---|---|
| Support knowledge · Notion · 128 docsSource folder · expand to view synced documents | — | — | Last synced 2026/07/29 03:10 | Retrievable | ⋯ |
| Brazil shipping timelinesCompiled 12 FAQ pairs | — | Updated Jun 3, 2026, 4:00 PM | Searchable | ⋯ | |
| EU customs & duties | — | Updated Jun 4, 2026, 2:30 PM | Indexing | ⋯ | |
| 30-day refund policyCompiled 9 FAQ pairs | — | Updated Jun 2, 2026, 8:00 PM | Searchable | ⋯ |
| Document | Size | Tags | Updated | Status | Actions |
|---|---|---|---|---|---|
| Brazil shipping policy | — | Updated Jun 3, 2026, 4:05 PM | Waiting to index | ⋯ | |
| EU customs & duties | — | Updated Jun 4, 2026, 2:30 PM | Indexing | ⋯ | |
| Brazil shipping timelines | — | Updated Jun 3, 2026, 4:00 PM | Searchable | ⋯ | |
| Import restrictions PDFError: The PDF contains no readable text | — | Updated Jun 7, 2026, 4:30 PM | Indexing failed | ⋯ |
| Document | Size | Tags | Updated | Status | Actions |
|---|---|---|---|---|---|
| tgo.ai · 0 pagesProcessed 3 / Discovered 50 pages | — | — | Crawl job running | Crawling | ⋯ |
| tgo.ai · 47 pagesLast sync succeeded · 47 pages | — | — | Last synced Jun 20, 2026, 4:00 PM | Searchable | ⋯ |
| Customer question | Standard answer | Source | Tags | Status | Actions |
|---|---|---|---|---|---|
| Do you ship to Brazil? | Shipping to Brazil usually takes 7-12 business days. | Compiled · Brazil shipping policy | Enabled | ⋯ |
Connect Notion, choose the pages to sync, and import documents automatically.
Connect NotionNotion is not connected yet
agent confirmationCart recovery is ready to reach 1 customer — confirm the flow.
agent confirmationNew FAQ: track packages from the order page after dispatch.
A customer asked about product materials. Review whether it belongs in the learning base.
A Telegram reply was not delivered. Check channel delivery.
An AI reception run failed. You can inspect the answer trail.
What needs my attention today?
Three things: 2 learning suggestions to review and 1 outreach waiting for your confirmation. Yesterday's auto-resolution hit 84%, up 3 points.
Choose whether built-in or external AI handles automatic replies.
Both visitors and agents will see this name
Selected channels are handled by the current AI. Channels not selected here will not use AI replies.
SelectChoose the AI service that replies across all assigned channels.
Maya Sales Advisor
This is the name of the same default AI agent. Visitors and agents see it; switching built-in or external source does not create a second AI.
AI reception source
Built-in and external AI are mutually exclusive. The selected source replies for the channels assigned below.
Use YundaDesk managed growth with YundaDesk AI learning, skill generation, and review.
External AI only handles auto-replies. It does not participate in YundaDesk AI learning or skill generation.
Ask about data or causes; Yuna calls read-only tools and returns the real result.
You do not need to remember feature locations or customer numbers. Describe the goal, target, and constraints. Yuna will decide the next step from the features available in the current workspace.
Use composer shortcuts#
The + menu at the bottom of Yuna's composer provides shortcuts for translation, polishing, conversation review, teaching AI customer service, customer insight, and business briefs. After you select one, the input prompt changes to match the task, such as Enter text to translate. Select the active shortcut again to exit it. Translation also provides a submenu for choosing the target language.
After you send, the user message keeps the original text and shows a blue task label at the beginning, such as Translate to English. Yuna's next message contains only the result. A task label describes what Yuna should do this time. A page, conversation, or customer context label identifies which information Yuna may use.
| Shortcut | Example | Requirements and result |
|---|---|---|
| Translate | Enter “Please confirm your delivery address” and select Chinese | Returns the text in the target language without changing the source or adding facts |
| Polish | Enter a draft reply that you plan to send to a customer | Improves tone and clarity while preserving meaning, numbers, and commitments |
| Review conversation | From the target conversation, enter “Find out why this conversation was handed to a person” | Requires the relevant conversation; returns key facts, handling issues, and suggested next steps |
| Teach AI customer service | Enter “When customers ask about cash on delivery, check the country and product first” | Prepares a learning draft; it does not affect customer replies until it is reviewed, tested, and enabled |
| Customer insight | From the target customer page, enter “Summarize this customer's needs and risks” | Requires access to that customer and uses only information the current member can view |
| Business brief | Enter “Summarize conversation volume, AI participation, and human handoffs for the last seven days” | Requires the relevant data and report permission; Yuna explains missing data instead of inventing numbers |
Translate a passage#
- Select + at the bottom of the Yuna composer, then select Translate.
- Choose the target language, such as Chinese.
- Enter the source text and send it.
Example: “Please confirm your delivery address. We will ship within two business days after payment.”
Yuna returns only the translated result. The meaning, numbers, and commitments should remain unchanged. Use Polish instead when you want to change the tone.
Polish a reply draft#
- Select Polish.
- Paste the reply you plan to send and describe the desired tone, such as “Friendlier, but do not add any commitments.”
- Send it, review the result, and then decide whether to use it.
Example: “Make this professional and concise: This color is out of stock. Choose another one.”
Yuna improves the wording without changing inventory facts, prices, timing, or refund commitments.
Review a customer conversation#
- Open the customer conversation you want to analyze.
- Under Current page above the Yuna composer, select the conversation label so that it moves into the composer.
- Select Review conversation, describe what you want to examine, and send it.
Example: “Find out why this conversation was handed to a person. List what the AI knew, what was missing, and the next improvements to make.”
Yuna organizes key facts, handling steps, risks, and suggestions from that conversation. If no conversation is selected, Yuna asks you to choose a target instead of guessing.
Teach AI customer service a handling method#
- Select Teach AI customer service.
- Describe when the method applies, the handling steps, constraints, and when a person should take over.
- Send it, review the learning draft prepared by Yuna, and then follow the prompts to test and enable it.
Example: “When customers ask about cash on delivery, check the destination country and product first. If it is not supported, explain why and offer another payment method. Do not promise an exception.”
This step creates content for review only. It does not change customer-facing replies until the draft is reviewed, tested, and enabled.
Get insight about a customer#
- Open the target customer's detail page.
- Under Current page above the Yuna composer, select the customer label so that it moves into the composer.
- Select Customer insight, ask a specific question, and send it.
Example: “Summarize the products this customer has recently asked about, recurring issues, churn risks, and a recommended follow-up.”
Yuna uses only customer details, conversations, and connected business data that the current member can access. It identifies missing information when the available record is incomplete.
Create a business brief#
- Open Reports and select the time range you need.
- Under Current page above the Yuna composer, select the report label so that the current range moves into the composer.
- Select Business brief, specify the metrics and output format, and send it.
Example: “In five bullet points, summarize conversation volume, AI participation, human handoffs, and unusual changes for the last seven days.”
Yuna queries data within the current report range and the member's permissions. It identifies unavailable metrics instead of replacing them with estimates.
A shortcut gives Yuna a task-specific starting point. It does not expand the current member's data access or bypass action confirmation. Conversation review, customer insight, and business briefs still require the relevant current page, available data, and permission. Yuna asks for the missing target or context when needed.
Ask questions#
Examples include “How many conversations did each channel receive yesterday?” and “Which issues are handed to people most often?” Yuna answers from data you are allowed to view. When data is unavailable, it should say so rather than fill the gap with a guess.
Perform an action#
For example: “Send a Telegram message to a selected customer about the new product.” Yuna can help you choose the customer and then show a confirmation containing the recipient, channel, and exact message. The message is sent only after confirmation, followed by a real delivery result or failure reason.
When a request has an important choice, Yuna can ask with a selection card, such as Create a draft only or Send after confirmation. After selection, progress should remain visible until the next draft or confirmation card appears.
For setup changes such as connecting a channel, creating knowledge, configuring AI reception, updating branding, or inviting members, Yuna first shows a draft or validation result. It performs the change only after you confirm. Read-only questions still follow your workspace permissions.
Teach the AI#
Examples include a standard cash-on-delivery answer or a temporary holiday shipping policy. When Yuna detects that you may be teaching it, it first asks whether to enter the learning flow. Only an explicit confirmation allows Yuna to prepare a structured draft and create a learning card. Declining continues the normal conversation and creates no learning content.
For a multi-step skill, the draft includes when it applies, information to collect, handling steps, and test scenarios. After confirmation, open the skill detail to review the flow and branches and run customer scenarios.
The system creates multiple customer scenarios for normal handling, missing information, conditional branches, external capability failures, declined confirmation, and human handoff where applicable. You can run one scenario or all scenarios. Simulation does not perform real external actions. Editing a field or asking Yuna to revise the skill makes earlier results stale, so the new revision must be tested again. The skill can be enabled only when every required scenario for the current revision passes, required capabilities are available, and risk checks succeed.
Yuna does not claim that it has learned something before the learning card actually exists. After enablement, AI customer service follows the reviewed flow. If a required capability or permission later becomes unavailable, the system does not bypass the check and continue.
Correct an existing knowledge fact#
If an existing contact detail, address, policy, or similar fact is wrong, tell Yuna the correct information. Yuna first locates the current knowledge source and asks you to choose when several targets are possible. Review the current answer → corrected answer preview, then confirm it. Yuna submits that knowledge change directly instead of creating another learning proposal for review.
After confirmation, the completion receipt lists the updated question and answer. Correcting knowledge created from an uploaded file or website does not rewrite the original file or external site; edit and resync the source when that content must also change. Then ask the customer's original question and one paraphrase in a real Widget or with Test conversation on the AI Agents page to confirm that the new knowledge is used.
If the source file, website, or connector content changes later, the system does not silently overwrite the confirmed answer. When the new source conflicts with that answer, Yuna shows a Knowledge correction needs review task and opens the exact FAQ entry so you can compare the current answer with the new source suggestion. You can keep the current answer, edit it, or adopt the suggestion. The review is complete only after you save, and it is not a new learning proposal.
Capability boundaries#
Order, inventory, logistics, customer records, broadcast, and similar actions require a connected app or channel. A knowledge article cannot replace live business information.