Install guide · Shopify

Live chat for your Shopify store, straight to Telegram

Shoppers who can ask a quick question buy more and bounce less. chatrelay adds a chat bubble to your Shopify store with one script tag in your theme — no app to install, no monthly app-store markup — and relays every question to your own Telegram so you can answer from your phone between orders.

Install chatrelay on Shopify

  1. Create your free chatrelay account

    Sign up (free plan, no credit card) and copy your embed snippet from the dashboard — it comes pre-filled with your real project id. The snippet below shows the shape; your-project is replaced by your id.

  2. Open your theme's code editor

    In Shopify admin go to Online Store → Themes, click the button on your current theme and choose Edit code.

  3. Paste the snippet into theme.liquid

    Open layout/theme.liquid, find the closing </body> tag near the bottom, and paste the embed right before it. Click Save.

    layout/theme.liquid
    <script src="https://www.chatwithdev.com/widget.js"
      data-chatrelay-project="your-project"
      data-chatrelay-convex="https://impressive-quail-820.convex.cloud"
      data-chatrelay-title="Chat with us" defer></script>
  4. Visit your storefront

    The chat bubble is live on every page of the store. Test it — your message lands in your Telegram and the chatrelay dashboard.

Tip: duplicate your theme first (Themes → … → Duplicate) so you have a rollback. If you later switch themes, paste the snippet into the new theme's theme.liquid too.

How replies reach your visitors

Every message relays to a Telegram bot you own — created at @BotFather in a minute and connected once in the chatrelay setup. In group mode each visitor gets their own topic; in direct mode chats arrive in your DM with the bot. Your reply appears in the visitor's chat bubble live, and the web dashboard (with AI drafting) is always there as a second screen. How the Telegram relay works →

FAQ

Do I need a Shopify app for live chat?

No. chatrelay is added with one script tag in theme.liquid, so it does not appear in your app list, does not add app-embed overhead, and is not billed through the Shopify app store.

Will it show on checkout pages?

The widget shows on all storefront pages rendered by your theme. Shopify's checkout is locked down to script tags on most plans, so the bubble appears up to the cart and again on the thank-you page on Plus.

Can I answer order questions from my phone?

Yes — that is the point. Each customer chat relays to your own Telegram bot; in group mode every customer gets their own thread, and your reply appears back in their browser instantly.

Does it work with Online Store 2.0 themes?

Yes. Any theme with a layout/theme.liquid file works, which is every Shopify theme — Dawn included.

Will it slow my store down?

No. It is one deferred script under 30 kb that loads after the page is interactive, so Core Web Vitals are unaffected.

Related guides

Live on your Shopify site in two minutes.

Free plan, no credit card — live in under two minutes.

Add live chat to Shopify without an app · chatrelay