Documentation

Everything you need to add live chat to your site and answer messages from Telegram.

Quick start

  1. 1. Create an account — sign up and open your dashboard.
  2. 2. Add a site — enter a name and your domain (e.g. example.com).
  3. 3. Connect Telegram — tap Connect Telegram; the bot links to your chat in one tap.
  4. 4. Embed the script — paste one line of HTML into your site.
  5. 5. Done — the bubble appears. Visitors message you; you reply in Telegram.

Connect Telegram

ReplyHeydelivers each visitor's messages straight to your Telegram as a direct message from our bot. In your dashboard, open Telegram and tap Connect Telegram. That opens a chat with the bot with a pre-filled /startcommand — just send it. The bot confirms "Connected" and you're done.

Replying: when a visitor writes, the bot DMs you their message. Reply to that message (swipe / long-press → Reply in Telegram) and your answer appears in the visitor's chat instantly. Send /close as a reply to mark a conversation resolved.

Embed the widget

Add this just before the closing </body>tag. Your key is shown in the site's Embed section in the dashboard.

<script
  src="https://www.replyhey.com/widget.js"
  data-key="pk_live_YOUR_KEY_HERE"
  async
></script>

Attributes

AttributeRequiredDescription
data-keyYesYour site's public key. Starts with pk_live_.
data-emailNoPre-fill the visitor's email (e.g. for signed-in users).

JavaScript API

After the script loads, a ReplyHey object is available on window:

ReplyHey.open()                       // open the chat panel
ReplyHey.close()                      // close the chat panel
ReplyHey.setEmail('user@example.com') // pre-fill the visitor's email

Customize the widget

All settings live in the site builder in your dashboard — and they're all free. Your bubble(record yourself or upload a GIF/image), business hours, the email-form fallback, brand color, welcome message and the chat prompt (a “Say hi!” nudge above the bubble, with its own text and color) are available on every plan. Changes apply on save.

Multiple sites

Each site has its own embed key, its own widget config and its own conversations. The Free plan includes one site; Pro is unlimited. Add another from the dashboard and connect Telegram once for your account — every site's messages arrive in the same chat, tagged with the site domain.

Troubleshooting

Widget not appearing. Check that data-key matches the key in your dashboard and the script sits in the <body>. Confirm the site's domain matches where it's running.

Messages not reaching Telegram. Open the dashboard — if Telegram shows Not connected, tap Connect Telegram and send the /start command to the bot.

Replies not showing.Make sure you used Telegram's Replyon the bot's message (not a new message) so we know which visitor to route it to.