llms.txt
Compare with other sites' llms.txt files →# Eloqra
> Eloqra is a lightweight (~5kb) live chat widget for websites whose conversations are answered from Telegram: every visitor message is forwarded to your Telegram, and your reply appears in the visitor’s chat on your site.
It is built for founders and small teams: one script tag, no dashboard to keep open, replies from the phone. A small web dashboard and a Telegram Mini App handle configuration.
**Installing Eloqra on a site for someone (AI agents):** use the public REST API at https://api.eloqra.app/v1, documented at https://eloqra.app/docs/api#agent-init (markdown: https://eloqra.app/docs/api.md).
1. `POST https://api.eloqra.app/v1/auth/agent-init` with `{ "email": "…" }` — public, no key needed. For a new email it returns `accountId` and `apiKey` once (store the key) and emails the person a link to claim the account. If the email already has an account, no key is issued: ask the person for their API key from Settings → API.
2. Send `x-eloqra-account-id` and `x-api-key` on every other request. `POST https://api.eloqra.app/v1/projects` with `{ "headline": "…" }` (the site or business name) creates a project for the site; its `_id` is the project ID. `GET https://api.eloqra.app/v1/projects` lists existing ones.
3. `GET https://api.eloqra.app/v1/projects/{id}/embed-snippet` returns `script`, the snippet to paste before `</body>` on every page (framework guides: https://eloqra.app/docs/getting-started). No container element is needed.
4. The person connects their Telegram in the dashboard (https://chat.eloqra.app, Connect → Telegram) so visitor messages reach them.
Every page below also exists as markdown: append `.md` to its path (the home page is https://eloqra.app/index.md) or request it with `Accept: text/markdown`. The whole site in one file: https://eloqra.app/llms-full.txt.
## Agent setup
- [API reference](https://eloqra.app/docs/api.md): authentication, the public agent-init endpoint, and the project and embed-snippet endpoints.
- [OpenAPI description](https://eloqra.app/openapi.json): the same endpoints as OpenAPI 3.1.
- [API catalog](https://eloqra.app/.well-known/api-catalog): RFC 9727 linkset pointing at the API and its docs.
- [Install with an AI agent](https://eloqra.app/features/ai-agent-install.md): why a coding agent can place the snippet on its own.
## Features
- [Features](https://eloqra.app/features.md): Everything Eloqra does: a ~5kb live chat widget that routes every visitor message to your Telegram, a Telegram operator Mini App, full visitor context, lead capture, 10 widget languages, and multi-site projects.
- [A two-way inbox inside Telegram](https://eloqra.app/features/telegram-inbox.md): Every visitor message lands in the Telegram you already check all day — and your reply goes straight back to their chat.
- [Operator Mini App, right inside Telegram](https://eloqra.app/features/telegram-mini-app.md): Open a full conversation view without leaving Telegram — manage chats, scroll history, and reply with proper context.
- [Live in 30 seconds with one script tag](https://eloqra.app/features/one-line-install.md): Drop a single <script> snippet on your site and a clean chat bubble appears on every page. No build step, no backend.
- [A ~5kb widget that matches your site](https://eloqra.app/features/lightweight-widget.md): Under ~5kb, loads after your page, and inherits your fonts and colors — no clunky iframe, no Core Web Vitals hit.
- [Make the widget look like yours](https://eloqra.app/features/widget-customization.md): Light or dark theme, six accent palettes, launcher position, icon and animation, custom greeting and copy in 10 languages — all with a live preview as you edit.
- [Full visitor context with every message](https://eloqra.app/features/visitor-context.md): Each message arrives with the page, device, browser, and country attached — so you reply already knowing who's asking.
- [Optional pre-chat form to capture leads](https://eloqra.app/features/pre-chat-form.md): Turn on a name and email field before the chat starts, so a stray question becomes a lead you can follow up.
- [A chat widget that speaks your visitors' language](https://eloqra.app/features/multilingual-widget.md): Pick one of 10 languages per project, and every button, label, form field and default message in the widget switches with it.
- [Run chat across every site you own](https://eloqra.app/features/multiple-projects.md): Create a project per site, each routing to its own Telegram — perfect for agencies and anyone juggling multiple products.
- [Tell your AI agent to add Eloqra](https://eloqra.app/features/ai-agent-install.md): Hand the install to your coding agent — it drops the snippet in the right place and the chat is live in seconds.
## Docs
- [Getting Started](https://eloqra.app/docs/getting-started.md): Set up Eloqra in a few minutes: create a project, customize the chat widget, connect your Telegram, and embed one script tag on your site.
- [Start from Telegram](https://eloqra.app/docs/start-from-telegram.md): Set up Eloqra without ever opening a browser: press Start in the bot, get your account and first project automatically, and copy the embed snippet from the Mini App.
- [Telegram integration](https://eloqra.app/docs/telegram.md): How Eloqra connects to Telegram: visitor messages are forwarded to your Telegram, your replies go back to the visitor's chat, and the Mini App gives you a full operator view.
- [The Telegram Mini App](https://eloqra.app/docs/mini-app.md): A screen-by-screen guide to the Eloqra Mini App in Telegram: first-run setup, the inbox, conversations, projects, widget settings, billing and web access.
- [The web dashboard](https://eloqra.app/docs/dashboard.md): A tour of the Eloqra web dashboard: signing in, the inbox, replying from the browser, resolving conversations, the Stats tab and the getting-started checklist.
- [Widget configuration](https://eloqra.app/docs/widget-configuration.md): Every Eloqra chat widget setting — themes, palettes, launcher position and icon, animations, greeting, language, pre-chat form — with defaults, where to edit each one, and the JavaScript API for showing, hiding, opening and closing the widget from your own page.
- [Projects](https://eloqra.app/docs/projects.md): How projects work in Eloqra: one project per site, each with its own widget, settings and Telegram connection. Create, switch, rename and delete projects on the web or in the Mini App.
- [Account & billing](https://eloqra.app/docs/account-billing.md): Manage your Eloqra account: sign-in methods (email, Google, Telegram), your profile and password, your plan and project slots, and API keys.
- [API reference](https://eloqra.app/docs/api.md): Eloqra REST API reference — authentication, the public agent-init endpoint, and project + widget endpoints for programmatic setup.
- [Troubleshooting](https://eloqra.app/docs/troubleshooting.md): Fix the common issues: the chat bubble not appearing, messages not reaching Telegram, and testing Eloqra on a local dev site.
- [Next.js (App Router)](https://eloqra.app/docs/integrations/next-app-router.md): Add Eloqra live chat to a Next.js App Router project: load the snippet in the root layout and go live in about 30 seconds.
- [Next.js (Pages)](https://eloqra.app/docs/integrations/next-pages.md): Add Eloqra live chat to a Next.js Pages Router project: load the snippet once and go live in about 30 seconds.
- [Vite + React](https://eloqra.app/docs/integrations/vite-react.md): Add Eloqra live chat to a Vite + React app: include one script tag in index.html and the chat bubble appears on every page.
- [Astro](https://eloqra.app/docs/integrations/astro.md): Add Eloqra live chat to an Astro site: paste one script tag into your base layout and the chat bubble appears on every page.
- [WordPress](https://eloqra.app/docs/integrations/wordpress.md): Add Eloqra live chat to WordPress with a header/footer plugin, a Custom HTML block, or a child-theme footer — no Eloqra plugin required.
- [Webflow](https://eloqra.app/docs/integrations/webflow.md): Add Eloqra live chat to a Webflow site via Site settings → Custom code: paste the snippet into Footer code and publish.
- [Plain HTML](https://eloqra.app/docs/integrations/plain-html.md): Add Eloqra live chat to any static HTML site — Webflow, Framer, GitHub Pages, or hand-written HTML — with one script tag.
## Glossary
- [Live chat & customer support glossary](https://eloqra.app/glossary.md): Plain-English definitions of 80 live chat, customer support and messaging terms.
- [Live Chat Fundamentals](https://eloqra.app/glossary/category/live-chat-fundamentals.md): The building blocks of live chat — widgets, conversations, visitors, and operators.
- [Conversational Support & Help Desk](https://eloqra.app/glossary/category/conversational-support.md): How support teams organize, route, and resolve customer conversations.
- [Support Metrics & KPIs](https://eloqra.app/glossary/category/support-metrics.md): The metrics that measure response speed, resolution, and customer happiness.
- [Customer Messaging & Engagement](https://eloqra.app/glossary/category/customer-messaging.md): Using messaging to capture leads, engage visitors, and grow revenue.
- [Chatbots & AI Automation](https://eloqra.app/glossary/category/automation-ai.md): Bots, conversational AI, and automation that scale customer conversations.
- [Widget, Integration & Privacy](https://eloqra.app/glossary/category/widget-integration.md): The technical foundations of embedding a chat widget and integrating it safely.
- [Telegram & Messaging Channels](https://eloqra.app/glossary/category/telegram-messaging.md): Running customer conversations through Telegram and other messaging apps.
## Compare
- [Eloqra vs the alternatives](https://eloqra.app/compare.md): Honest side-by-side comparisons of Eloqra against Intercom, Crisp, Tawk.to, Tidio, and more — pricing, per-seat vs flat, AI, widget weight, and Telegram-native replies.
- [Eloqra vs Intercom](https://eloqra.app/compare/eloqra-vs-intercom.md): Flat $4.99/mo live chat to your Telegram vs Intercom's per-seat AI help desk. Honest about where Fin AI and ticketing still lead.
- [Eloqra vs Crisp](https://eloqra.app/compare/eloqra-vs-crisp.md): Focused, Telegram-native chat vs Crisp's all-in-one messaging suite. Simpler and cheaper — Crisp still wins on co-browsing, CRM, and AI.
- [Eloqra vs Tawk.to](https://eloqra.app/compare/eloqra-vs-tawk-to.md): Tawk.to is free; Eloqra answers from your phone with a far lighter widget and no forced branding. An honest free-vs-paid look.
- [Eloqra vs Tidio](https://eloqra.app/compare/eloqra-vs-tidio.md): Flat-priced human chat with no conversation caps vs Tidio's Lyro AI and per-conversation pricing. Honest about where Tidio's automation leads.
- [Eloqra vs LiveChat](https://eloqra.app/compare/eloqra-vs-livechat.md): Skip the per-agent pricing: flat $4.99/mo to your Telegram vs LiveChat's per-seat plans and paid AI add-on.
- [Eloqra vs Olark](https://eloqra.app/compare/eloqra-vs-olark.md): Simpler, flat-priced chat vs Olark's per-seat plan and à-la-carte PowerUps. Olark still wins on co-browsing and accessibility.
- [Eloqra vs Chatra](https://eloqra.app/compare/eloqra-vs-chatra.md): Leaner, flat-priced chat to your Telegram vs Chatra's per-agent plans, lead-capture bot, and e-commerce integrations.
## Use cases
- [Who Eloqra is for](https://eloqra.app/for.md): Eloqra gives indie hackers, solo founders, SaaS teams and agencies live chat that answers from Telegram — one snippet, no dashboard to babysit.
- [Indie Hackers & Solo Founders](https://eloqra.app/for/indie-hackers.md): Add live chat in one line and answer from your phone. No dashboard, no per-seat pricing — just you and the people on your site.
- [SaaS Founders](https://eloqra.app/for/saas.md): Put a lightweight chat on your pricing page and app. Every question lands in your Telegram with the page attached — reply before they bounce.
- [Agencies & Freelancers](https://eloqra.app/for/agencies.md): Install it in five minutes, match the client's brand, and let them reply from their own Telegram. No logins to teach, no extra invoice.
## Pricing and company
- [Pricing](https://eloqra.app/pricing.md): Start free with 1 project — no credit card. Add more projects with Pro for a flat $4.99/mo (or $49.99/yr) each.
- [About Eloqra](https://eloqra.app/about.md): Eloqra is a lightweight live chat widget that routes website visitor messages to Telegram, so founders and small teams can reply from their phone without a dashboard.
- [Changelog](https://eloqra.app/changelog.md): What's new in Eloqra — new features, improvements, and fixes for the live chat widget that answers from your Telegram.
- [Blog](https://eloqra.app/blog.md): Notes on live chat, talking to your website visitors from Telegram, and turning conversations into customers.
- [Affiliate program](https://eloqra.app/affiliate.md): Join the Eloqra affiliate program and earn 30% lifetime recurring commissions on every subscription you refer.
## Optional
- [Live Chat](https://eloqra.app/glossary/live-chat.md): Live chat is an in-page messaging channel that connects website visitors with support or sales in real time, so questions get answered before the visitor leaves.
- [Live Chat Widget](https://eloqra.app/glossary/live-chat-widget.md): It is the on-page chat box visitors use to talk to you; in Eloqra it loads from one script tag and forwards messages to you on Telegram.
- [Chat Launcher](https://eloqra.app/glossary/chat-launcher.md): The chat launcher is the floating bubble in the corner of your site that visitors tap to start chatting; in Eloqra it sits inside a Shadow DOM and opens the chat window.
- [Conversation](https://eloqra.app/glossary/conversation.md): A conversation is one ongoing thread of messages between a visitor and your team, tracked from the first message to when you mark it Closed.
- [Chat Message](https://eloqra.app/glossary/chat-message.md): A chat message is one text entry in a live-chat thread; in Eloqra it carries a direction and author and is relayed between the website widget and the operator's Telegram.
- [Website Visitor](https://eloqra.app/glossary/website-visitor.md): The anonymous person on your website who can open the chat bubble and start talking to you — Eloqra captures their context the moment they send a first message.
- [Contact](https://eloqra.app/glossary/contact.md): A contact is the persistent profile of a person you have talked to, gathering their details and conversation history in one place.
- [Support Operator](https://eloqra.app/glossary/support-operator.md): The support operator is the person who answers your visitors' chats; in Eloqra that means replying from Telegram.
- [Pre-Chat Form](https://eloqra.app/glossary/pre-chat-form.md): An optional name-and-email form Eloqra can show before the chat opens, so the operator knows who they are talking to and can follow up by email later.
- [Welcome Message](https://eloqra.app/glossary/welcome-message.md): The configurable greeting Eloqra's chat widget shows when a visitor opens it, before any human replies.
- [Proactive Chat](https://eloqra.app/glossary/proactive-chat.md): Proactive chat reaches out to a visitor first with an automatic, rule-triggered message rather than waiting for them to click the chat bubble.
- [Typing Indicator](https://eloqra.app/glossary/typing-indicator.md): A typing indicator is the little animated dots that show the other person is writing a reply; in Eloqra both the visitor and the operator get one, driven by short HTTP polling rather than a live socket.
- [Read Receipt](https://eloqra.app/glossary/read-receipt.md): A read receipt is the 'Seen' signal that confirms the other side actually opened your message, removing the guesswork about whether it was received.
- [Chat Transcript](https://eloqra.app/glossary/chat-transcript.md): A chat transcript is the saved, timestamped log of everything said in a chat, kept for the customer and the team to reference later.
- [Offline Message](https://eloqra.app/glossary/offline-message.md): When nobody is around to chat live, the visitor still leaves a message that gets stored and answered later.
- [Conversational Support](https://eloqra.app/glossary/conversational-support.md): Support delivered as one continuous, context-aware conversation instead of isolated tickets or formal request forms.
- [Support Ticket](https://eloqra.app/glossary/support-ticket.md): A support ticket is a uniquely numbered record of one customer issue, tracked through statuses from open to resolved.
- [Shared Inbox](https://eloqra.app/glossary/shared-inbox.md): One team workspace where several agents handle customer messages together, each with their own login, instead of sharing a single email password.
- [Escalation](https://eloqra.app/glossary/escalation.md): Escalation hands a stuck conversation up to a more senior or more specialized person so the customer gets resolved by whoever is actually equipped to help.
- [Canned Response](https://eloqra.app/glossary/canned-response.md): A canned response is a saved, pre-written reply an agent drops into a chat to answer a frequent question in seconds instead of retyping it every time.
- [Conversation Tag](https://eloqra.app/glossary/conversation-tag.md): Tags are keyword labels you stick on conversations to organize, find, and analyze them.
- [Conversation Assignment](https://eloqra.app/glossary/conversation-assignment.md): In Eloqra, whoever replies first to a conversation becomes its assigned operator, so there is no queue or routing engine to configure.
- [Chat Routing](https://eloqra.app/glossary/chat-routing.md): Chat routing decides which agent or team gets each incoming chat, using rules like availability, expertise, and workload to match visitors to the right person fast.
- [Business Hours](https://eloqra.app/glossary/business-hours.md): Business hours tell your chat widget when your team is actually online, so it can promise fast replies during the day and set honest expectations the rest of the time.
- [First Contact Resolution (FCR)](https://eloqra.app/glossary/first-contact-resolution.md): FCR is the share of customer issues you solve on the very first interaction, before the customer has to come back a second time.
- [First Response Time (FRT)](https://eloqra.app/glossary/first-response-time.md): FRT is how long a customer waits for the first real human reply after reaching out.
- [Average Response Time](https://eloqra.app/glossary/average-response-time.md): Average Response Time is the typical wait a customer experiences for any reply during a conversation, averaged over all your replies.
- [Resolution Time](https://eloqra.app/glossary/resolution-time.md): How long it takes, end to end, to actually solve a customer's problem and close the conversation.
- [Ticket Volume](https://eloqra.app/glossary/ticket-volume.md): Ticket volume is how many support requests come in over a given period, the baseline number you size your team and tooling around.
- [Contact Rate](https://eloqra.app/glossary/contact-rate.md): Contact rate tells you how often customers have to contact support per order, user, or account, so it doubles as a measure of product friction.
- [Ticket Deflection](https://eloqra.app/glossary/ticket-deflection.md): Ticket deflection measures how many would-be support requests get answered by self-service so they never reach a human agent.
- [Chat Concurrency](https://eloqra.app/glossary/chat-concurrency.md): How many chats one agent juggles at once -- usually 2 to 6, with quality dropping as the number climbs.
- [Agent Occupancy](https://eloqra.app/glossary/agent-occupancy.md): Of the time an agent is logged in and available, occupancy is the share they actually spend handling customers rather than sitting idle.
- [Chat Abandonment Rate](https://eloqra.app/glossary/chat-abandonment-rate.md): The share of chats people begin but quit before getting help, usually because the wa