Optigram

Install & connect

You will install Optigram on a GHL sub-account, grant OAuth access, paste a Telegram bot token, and confirm the provider is active. Plan on one bot per location — do not share a BotFather token across sub-accounts.

1. Install from the Marketplace

  1. Open the GoHighLevel Marketplace and install Optigram for Telegram on the sub-account (location) that should own the channel.
  2. Approve the OAuth prompt. Optigram requests conversation and contact scopes only: conversations/message.write, conversations/message.readonly, conversations.readonly, conversations.write, contacts.readonly, contacts.write.
  3. Open the Optigram page from GHL (Custom Page). The dashboard embeds inside GHL; you should not need a separate login.

2. Create a Telegram bot

  1. In Telegram, talk to @BotFather and send /newbot.
  2. Copy the bot token. Treat it like a password — anyone with it can send as your bot.
  3. In Optigram, paste the token and connect. The app calls Telegram getMe, stores the token encrypted, and sets the webhook.

If the token is already connected to another Optigram location, connect is rejected. Create a new bot for this sub-account.

3. Confirm health and the provider

  1. Use Webhook health in the dashboard. It should report ok, with the webhook URL on Optigram’s API host.
  2. In GHL go to Settings → Conversation Providers and confirm Optigram (custom provider) is listed and active.

Phantom phone numbers (read this once)

GHL custom conversation providers can show a placeholder phone number on the contact. Optigram writes the Telegram username to a visible custom field named Telegram Handle so you can still identify the person. This is expected, not a misconfiguration.

Next: generate an opt-in link.