Telegram Support BotDeleteDisableTest connectionSave
Telegram Support Bot••••••••••••••••••••••••From @BotFather; only a mask is shown after saving, the value can't be revealed
Reception settings
Telegram bot setup guide
Minimal setup
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.
Telegram Support BotDeleteDisableTest connectionSave
Channel needs attention
The channel credential has expired. Please reauthorize and try again.
Connection failed
Telegram Support Bot
123456:ABC-DEF...From @BotFather; only a mask is shown after saving, the value can't be revealed
Reception settings
Telegram bot setup guide
Minimal setup
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
Order system Custom APIProDeleteDisableTest connectionSave
Sent via fixed secure egress
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 IPs
Order system Custom APIhttps://example.com/yundadesk/callbackAfter an agent or AI replies, YundaDesk pushes the message to this address.ydck_demo_0000••••••••••••••••••••Auto-generated as ydsec_… after saving; shown masked only, never echoed in plain text203.0.113.1, 203.0.113.2Restrict which sources may send requests to YundaDesk; comma-separated, leave blank for no limit
Custom API setup guide
Customer message: your system → YundaDeskAgent reply: YundaDesk → your system callback URL
https://api.yundadesk.com/v1/custom-api/inbound1. 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.
Delivery log
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
App StoreDemo data
Search apps / vendors / capabilitiesDemo data
Self-Service2 apps
Help CenterBy YundaDesk
ProW
WordPressBy YundaDesk
Installed
Install one YundaDesk plugin to add live chat, AI support, and a secure Widget binding to a WordPress site.
CRM2 apps
Woo
WooCommerceBy YundaDesk
Installed
Use the same YundaDesk WordPress plugin; after WooCommerce is detected and authorized read-only, sync store, customer, order, product, and current cart context.
BC
BigCommerceBy BigCommerce
Installed
Connect a BigCommerce store, sync customer order context, and show recent orders in the workspace sidebar.
Connect a WordPress site
Confirm this site connection
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.
×WordPress sites
One YundaDesk plugin provides site chat and adds read-only store capabilities when WooCommerce is detected. Each site keeps its own connection status.
CustomersSearch by name, social handle, or emailDemo data
Customer
Contact
Channel / source
Location
Last interaction
MMaria Garcia
maria@example.com
Web Widget
🇪🇸 ES
05/18
LLukas Schneider
Telegram+49 30 123456
🇩🇪 DE
05/20
AAna Silva
WhatsApp
🇧🇷 BR
05/22
OverviewBuilt-in AI is handling reception
Check whether AI is safe to serve, what it answers from, and what needs you.
AI capabilities & learningManage knowledge & skills →
12Data sourcesReindexed in the last 2 hours64Skills5 skill matches in the last 7 days174Learning suggestions22 adopted · 7 used2Customer memory1 low-confidence memory to watch
Last 7 daysView reports →
35Conversations
35Closed
0Queued
35Assigned
Daily AI-handled conversationsConversations where AI actually repliedUnit: conversations
6/146/156/166/176/186/196/20
Proactive outreach weekly reportReview weekly trigger decisions, cooldown blocks, and delivery failures.2 cooling down
5Sent8Eligible4Blocked1Delivery failed
3 outreach tasks open
Needs your attentionReview suggestions →
How should we reply when sizing runs small?A staff answer has been turned into a skill draft and needs confirmation.Handle
What if DHL takes more than 72 hours?A staff answer has been turned into a skill draft and needs confirmation.Handle
Learning result delivery failedA Telegram learning result matched once but did not reach the customer. Review the failed replay or retry from Learning review.View
What AI recently learnedView all learning →
UsedHow do I track a shipment?
Look it up using the order number.
Last 3 real matches: Web Widget · Custom API — 1 externally delivered, 2 pending verification, 0 failed.
Capability centerReady · 1Draft only · 1Needs integration · 1Blocked · 1Back to AI Hub
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.
AI learning
Do you ship to Brazil?
↳Yes, Brazil shipping usually takes 7-12 business days.
Human answered·1
×Save to learning
How should we handle customers who say they are VIP?
↳Auto-detect VIP customers · Detect VIP status and prompt agents to follow up first.
Human answered·1·L2 risk
×Enable as AI skill
Can I return opened items?
↳Opened items can be returned within 30 days if the package is complete.
Human answered·1
Manage learned content
DHL tracking has not moved for 72 hours. What can you do?
↳If DHL has not updated for over 72 hours, check the order first, then hand off for compensation review.
You corrected·1·L2 risk
Reactivate
AI skills2 items
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
›
Order tracking lookupActiveBack to AI skills
Query
When a customer asks where an order is, look it up first, then reply in brand voice.
Required3 / 3Passed3CapabilitiesReady
Simulate customer scenarios
Choose a customer scenario and run a side-effect-free simulation with the production executor.
Look up an order in transitHappy pathPassedRun scenarioCustomer did not provide an order numberMissing informationPassedRun scenarioShipping lookup is temporarily unavailableCapability failurePassedRun scenario
Simulation never messages customers or performs real external actions.
Live usage logs
Shows real customer-conversation calls only; scenario simulations are excluded.
Where is my order?Your order is in transit and should arrive within two days.SucceededOpen customer conversation
ReportsLast 7 daysLast 30 daysLast 90 daysExport reportDemo data
Conversations1,284Previous period -
Avg. first response1m 05sStable
Avg. resolution time7m 24sPrevious period -
AI participation78%Previous period -
Conversation volumeConversationsAvg. first responseResolved this periodAI participation
6/156/166/176/186/196/206/21
Hourly new conversationsLast 7 days
LowHigh7-day total 5,670
Dimension detailsChannelsAgents
Dimension
Conversations
Messages
Avg. first response
Resolved
Share
Web Widget
712
4,128
38s
496
60%
Telegram
284
1,620
45s
219
24%
Email
198
980
3m 12s
146
17%
Profile & project
Agent identity
ACAnna Chenanna@yundadesk.test
Basic information
Save
Project identity
Save
Team members
Login activityRoles & permissionsInvite agent
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
Browser notificationsStay notified about new messages even when you are not viewing the workspace.
Notification settings
Sound alertsPlay an alert sound when a new message arrives
Notification scenes
Background notificationsSend a notification when the page isn't visible (tab switched or minimized)
Other conversation messagesSend a notification for messages in conversations you aren't currently viewing
New visitor notificationsSend a notification when a new visitor enters the queue
Assignment & transfer notificationsSend a notification when a conversation is assigned or transferred to you
Test notification
Send test
Send a test notification to verify everything works.
Send key
Enter to send · Shift+Enter for a new line
Send-key preference for the conversation input, saved per agent.
Proactive outreach
Save
Current mode: Send after staff confirmationCooldown is 24 hours per customer; at most 1 touches in 7 days.
Outreach policy
Outreach modeObserve, require staff confirmation, or auto-send. Auto-send can send real customer messages.Send after staff confirmation
Enable live proactive sendsAvailable only in auto-send mode. Sends still pass cooldown, quiet hours, per-customer limits and memory checks.
Quiet hoursAvoid sending during time windows that may disturb customers.
Start time / End timeUses the workspace timezone; overnight windows such as 22:00 to 08:00 are supported.22:0008:00
Require reachable consentOnly trigger when the customer is eligible for proactive contact.
Anti-spam and confidence
Cooldown (hours)The same customer and action will not repeat during the cooldown window.24hours
7-day customer limitMaximum proactive touches for one customer in 7 days; 0 disables proactive sends.1times
Minimum confidenceOnly decisions at or above this confidence enter confirmation or auto-send.86%
Human review
High risk / Sensitive actionThese risk levels still require staff confirmation to avoid sending high-commitment, refund or compliance-sensitive messages directly.
Subscription & usage
Upgrade planBuy AI CreditPurchase historyContact ops
GrowthSubscription activeRenewal date not set.Subscription active
Usage quotas
Agent seats7 / 12Seats used
Channels4 / 30Channels connected
AI creditView records →17,000 / 50,000This month's usage
Monthly conversations12.3K / 20KNew conversations this month
Monthly messages67.9K / 200KMessages this month
Data source docs128 / 2,000Documents indexed
Entitlement gate
Quotas and features controlled by planWhen a quota is exhausted or a feature isn't enabled, the system pauses the related action; upgrade your plan or contact ops to continue.
Write actions are allowed based on workspace status, feature flags and quota usage.
34%
Invite agentSend a join email; they can enter the workspace after setting up their account.
Roles & permissionsConfigure permissions across members. Administrator permissions are fixed.1 member has unsaved changes (added 2 · removed 0)Why are these permissions changing?Save changes
Search members or permissionsAll groupsAll presetsInclude disabledOnly unsaved differences
agent confirmationCart recovery is ready to reach 1 customer — confirm the flow.
HandleIgnore
Learning suggestion to review
agent confirmationNew FAQ: track packages from the order page after dispatch.
HandleIgnore
Needs attention: 4shadow modeHistoryCollapse
Yuna found 1 learning suggestion
A customer asked about product materials. Review whether it belongs in the learning base.
HandleIgnore
Yuna found 1 delivery failure
A Telegram reply was not delivered. Check channel delivery.
HandleIgnore
Yuna found 1 failed AI answer
An AI reception run failed. You can inspect the answer trail.
HandleIgnore
1 more, view all
How can I help you today?
Current pageEmma Lin
Ask Yuna…Base
Which channel had the most customers in the past week?How much AI Credit was used this month?Upload a data sourceCreate a Telegram channel
Which channel had the most customers in the past week?
The website channel had the most customers in the past week: 42.
Send a Telegram message to Sam about the new product.
Confirm before sending
Sam Will · TelegramA new product is now available.SendCancel
VIP customers can get expedited shipping
This looks like a rule you may want to teach me.
Enter the learning flow?Only explicit confirmation creates a structured draft; declining continues the normal conversation.Continue learningContinue chatting
VIP customers can get expedited shipping
This looks like a rule you may want to teach me.
1 pending learning suggestionPrepared with scope, information to collect, handling steps, and test scenarios.
Can VIP customers get expedited shipping?Will learn: VIP customers receive priority same-day dispatch.Customer scenarios: happy path · missing input · capability failure · handoffSave to learningReviewIgnore
Your choice is needed
Choose how to send
Continue
Yuna is continuing
Continuing the task with your selection. Please wait.
Selected: Create a draft only
Execution log3 itemsCompletedPrivate message “A new product is now available.” sent to Sam Will · Telegram; accepted, waiting for the channel receipt.View execution trail
If a customer stops replying for 30 minutes after asking about a product, prepare a follow-up draft, at most once per customer every 24 hours.
Saved as a pending learning suggestion. Review it in AI improvements.
1 pending learning suggestionApprove it to add it to AI customer service; ignore it to leave behavior unchanged.
Proactive skillWhat should happen when a product shopper stops replying for 30 minutes?
Trigger
Trigger after 30m
AI action
Prepare a follow-up draft
Cooldown
Do not repeat for the same customer within 1d
After approval this becomes a proactive skill; real delivery still passes switches, cooldowns, approval, and channel gates.ApproveReviewIgnore
Ask Yuna…Base
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.
Ask Yuna…Base
×
Yuna memoryForget all
Type
Content
Updated
Actions
preference
Use weekly view by default for future reports
07/11/2026, 08:00
×
Connect PhoneNot connectedConnection owner: Alice
Bring the same Yuna conversation to the creator or admin's phone. Feishu, Telegram Bot, and WeChat messages stay in the original Yuna thread.
FFeishuSend and receive Yuna messages with a Feishu bot.Not connected
Good for teams that already work in Feishu.
ConnectTTelegram BotSend and receive Yuna messages with a Telegram Bot.Not connected
Good for cross-border teams that work in Telegram.
ConnectWWeChatSend and receive Yuna messages with an official WeChat account.Not connected
Good for teams that handle work from WeChat.
ConnectFFeishuSend and receive Yuna messages with a Feishu bot.Connected
Yuna FeishuAccount: cli_yunaRunningConnection owner: Alice
Last received—
Last sent—
TTelegram BotSend and receive Yuna messages with a Telegram Bot.Not connected
Good for cross-border teams that work in Telegram.
ConnectWWeChatSend and receive Yuna messages with an official WeChat account.Not connected
Good for teams that handle work from WeChat.
Connect
Connect FeishuScan and confirm on your phone to connect this account to Yuna.
Waiting for confirmationValid until 07/04/2026, 12:10
Agent setupTest receptionDemo data
GeneralHandoffReception channels
AI service
Choose whether built-in or external AI handles automatic replies.
Built-in AI receptionChange
MYAI agent nameBuilt-in
Maya Sales Advisor
Both visitors and agents will see this name
AI settingsAutosave
Reception focusConsultation & conversionAnswers service, product, plan, or partnership questions and guides the next step.
Your instructionsAdd your brand preferences. Platform safety rules, tool approvals, and injection protection are managed by the system.You are a pre-sales agent for cross-border storefront visitors. Prefer actionable answers.
ToneFriendlyProfessional
Use emoji
Reception settingsAutosave
Online queue messageShown while an online teammate is waiting to join.I'll bring in a human teammate to continue helping with this.
No agents online messageShown when no support agents are online.No agents are online right now. We saved your message and will reply as soon as possible.
Agent joined noticeShows a system notice when an agent joins; turning it off does not change assignment.
Reception channels
Selected channels are handled by the current AI. Channels not selected here will not use AI replies.
Select
WebsiteTelegram
Change AI service
Choose the AI service that replies across all assigned channels.
MY
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.
Built-in
AI reception source
Built-in and external AI are mutually exclusive. The selected source replies for the channels assigned below.
Built-in AI receptionIn use
Use YundaDesk managed growth with YundaDesk AI learning, skill generation, and review.
External AI receptionNot in use
External AI only handles auto-replies. It does not participate in YundaDesk AI learning or skill generation.
Step 1 / 7
Find the incomplete answer
Start from the AI message that was wrong or incomplete, then decide whether the rule belongs in knowledge or in an AI skill.
This example uses a temporary rule: “During the holiday period, in-stock orders are expected to ship within three business days.” Replace its dates, scope, and commitment with your real policy.
Confirm who the rule applies to, its start and end dates, exceptions, and whether it requires live order or inventory data. Stable policy belongs in knowledge. A rule with triggers, time limits, or handling steps is usually better suited to an AI skill.
You can tell Yuna the durable rule directly. Yuna first asks whether it should continue organizing the instruction and creates a reviewable proposal only after confirmation. If the rule comes from an incorrect answer, select Correct AI in the Inbox and explain what was wrong, the correct handling, and its scope. Correct AI carries the customer question and original answer, but both entry points use the same suggestion, review, and testing flow.
Check the referenced question, proposed answer, scope, expiry, and required capabilities. Narrow the scope and preserve human confirmation for higher-risk content such as refunds, prices, external commitments, or automatic sending.
Merge duplicate or equivalent suggestions into existing knowledge or skills to avoid conflicting versions.
Test at least the original question, a rephrased version with the same intent, and an unrelated question that should not trigger the rule. Confirm that the answer does not broaden the commitment and that the rule is not used after expiry, without evidence, or when its conditions do not apply.
Activate only after review and Playground testing pass. Then spot-check the final answer received through a real channel.
Pause the skill when the policy changes or an error is found so it is no longer used automatically. If a new version performs worse, roll back and rerun the key tests. Pause and rollback preserve history; deletion is not the first choice for correcting a rule.
Didn't find your answer?
Start free and try the real product, or reach out — humans are as online as the AI.