Widget embed
Every Customer Support plan includes the embeddable chat widget. After connecting your bot, copy the snippet from Support → Widget in Creator Studio (/creator/support/[appId]/widget):
<script async src="https://tg.app/embed/support/v1.js" data-app-key="pk_..."></script>
Paste before </body> on any page.
What visitors see
- Floating chat button (default: chat bubble with hover animation; optional custom emoji or image in a round button)
- Drag the button to snap it to any corner (top/bottom, left/right). The visitor's choice is saved in their browser.
- Header with your bot display name and
@username - Welcome message (configurable in Setup)
- Continue in Telegram link with session pairing
- CSAT prompt (1-5 stars) after you resolve a conversation in the inbox
- Offline banner when business hours are enabled and you are outside the schedule
Live preview in Creator Studio
Open Support → Widget to edit appearance and behavior with a live interactive preview (same embed script, preview mode). Changes apply on your site after you click Save.
Widget behavior settings
In Support → Widget → Widget behavior:
| Setting | What it does |
|---|---|
| Business hours | Show offline banner outside your schedule; save messages without AI or agent alerts until you are back |
| Offline message | Custom copy in the banner and auto-reply |
| Widget language | Auto (browser), English, or Polish for button labels, offline text, and CSAT |
Widget analytics
The Widget analytics card on the same page tracks:
- Panel opens
- Messages sent from the widget
- Continue in Telegram clicks (handoff rate)
- Average CSAT and recent star ratings
Daily charts
Below the summary cards, open 7 days or 30 days to see daily trends for panel opens, messages sent, Telegram handoffs, and CSAT submissions. Data rolls up automatically from widget events.
Usage vs plan limits
The workspace shell and Support → Billing show a usage meter: AI replies and ticket messages counted against your monthly plan cap. Upgrade or renew before you hit the limit.
Branding by plan
| Plan | Widget branding |
|---|---|
| Starter | Default chat bubble, @username, "Powered by TG.app" |
| Pro | Custom display name, accent & header colors, chat button icon, behavior settings, analytics |
| Team | Everything in Pro plus white-label (hide "Powered by TG.app") |
Testing
Open your site in a private window, send a test message, then click Continue in Telegram and confirm history appears in the bot DM. Resolve the ticket in the inbox and confirm the CSAT stars appear in the widget on the visitor side.