Telegram

Our Telegram integration allows your users to send you messages through a Telegram bot. You can receive the messages in a business system or with Webhooks, and your replies are sent back as Telegram messages from the bot to the user.

Capabilities

Telegram supports a wide variety of capabilities as seen in the channel capabilities grid. Below is a detailed view of each capabilities.

Content Types

  • Full Support

    API

    Text

    Plain text messages

  • Full Support

    API

    Image

    Display static images

  • Partial Support

    API

    File

    Send and receive any file types

  • Full Support

    API

    Emoji

    Unicode Emojis✨

  • Full Support

    API

    GIF

    Send animated GIFs

  • Partial Support

    API

    Location

    Receive the geolocation of the user

Action Types

  • Full Support

    API

    Link

    Display web links as buttons

  • Partial Support

    API

    Extensions

    Send custom interactive experiences built with Jav...

  • Full Support

    API

    Buy

    Request payments within a conversation

  • Full Support

    API

    Postback

    Send buttons to the user trigger events on your se...

  • Full Support

    API

    Replies

    Suggest a few answers to reply to a message

  • Full Support

    API

    Location Request

    Request the current location of the user

Structured Messages

  • Full Support

    API

    Compound Messages

    Compose messages with multiple actions

  • Full Support

    API

    Carousel

    Send a set of cards that can contain text, image, ...

Indicators

  • Full Support

    API

    Typing

    Display a typing indicator

  • Full Support

    API

    Read

    Display read status

  • Full Support

    API

    Conversation Start

    Recieve a <a href="https://docs.smooch.io/rest/#co...

Creating a Bot

To create a bot, follow the instructions here.

Create a bot with BotFather

After choosing the bot’s username, BotFather will generate an access token for the API, which Smooch will need to integrate with Telegram.

Configuring Telegram

Telegram Integration Page Settings

Once you have created the bot, all you have to do is enter the bot’s access token on the integration page. Smooch will now relay any message it receives to your business systems.

Conversations Through the Bot

To send a user to your bot, you can direct them to https://telegram.me/<your_bot_username>. Telegram users can also search for your bot by its username, which is obtained while creating a bot with BotFather. Once they have added your bot to their contacts, your bot will act as any other Telegram user. Any user will be able to send normal text messages to your bot or any of the supported file formats (documents, images, sound). If the user sends a file, the message will contain a link to the file that was sent.

When you reply from any of the configured backend channels, Telegram users will receive the message as though it was coming from the bot.

Action Buttons

When used with Telegram, message actions work as expected. A button with type link will bring the user to a web page, while postback buttons will trigger any Smooch webhook listening to the postback trigger.

Payment requests with the Stripe integration will turn into link buttons which bring the user to a checkout page where payment information can be entered.