Skip to content

Latest commit

 

History

History
54 lines (38 loc) · 2.44 KB

README.md

File metadata and controls

54 lines (38 loc) · 2.44 KB
Raw

Intergram

Free live chat widget linked to your Telegram messenger.

Embed Intergram in your website with these 2 simple steps

  1. Open Telegram, search for @Intergram and hit /start to get your unique chat ID.

  1. Paste this snippet right before the closing body tag of every page where you want the chat to appear (Don't forget to add your actual chat ID).
<script> window.intergramId = <Your unique chat ID> </script>
<script id="intergram" type="text/javascript" src="https://www.intergram.xyz/js/widget.js"></script>

Note: replying to a specific message should be used to respond to that specific visitor. Sending a standard message will broadcast to all connected chat clients (You might find it easier to use if you have only one active conversation)

I have tried to keep the footprint as small as possible.

  • Preact
  • The widget injection script is about 5KB gziped and executes only after the host page finished loading ('onload' event).
  • The chat iframe will only be loaded if the user interacts with the chat widget (currently about 40KB gziped).

Since the hosting cost are quite minimal (server, domain, cdn), I plan to keep this service 100% free (no ads also!). The only thing I might use it for, is testing new technologies from other projects I work on.

Deploy your own Intergram instance (The hard way)

  1. Talk to Telegram @BotFather, create a new bot and get its API Token.

  2. Deploy this repo to your own chat server.

  • Clone it locally and install or if you use Heroku, fork this repository and point the new app to it.
  • Set an .env varible named TELEGRAM_TOKEN with the value you got from @BotFather

  1. Point the bot webhook to your bot server by making a GET request to the following url https://api.telegram.org/bot<TOKEN>/setWebhook?url=<Server url>/hook (Don't forget to replace with your token and server url)

  2. Open a chat with your bot and hit /start to get your unique chat ID

  3. Embed this sinpet in your website

<script> 
  window.intergramId = <Your unique chat ID>
  window.intergramIFrameSrc = <Server url> + '/chat.html'
</script>
<script id="intergram" type="text/javascript" src="<Server url>/js/widget.js"></script>
  1. 🎉