Telegram

The Telegram integration sends each new survey response to Telegram through the SurveyNinja bot. Responses can go to your personal chat, to a group or to a topic in a group.

Before you start

• You need a Telegram account. To get responses in a group, you must be able to add the bot to that group.
• In someone else's workspace, your role must allow integrations.

Connecting your Telegram account

1. Open the survey and go to the Integrations tab.
2. Click Telegram in the list.
3. Click Connect to account (1). A window opens with a link to the SurveyNinja bot in Telegram.
4. In Telegram, click Start. The bot replies that the survey is connected.
5. Go back to SurveyNinja and click Continue.
   

Connecting a group

1. On the same screen, click Connect to group (2).
2. In Telegram, choose the group and add the bot to it.
3. Go back to SurveyNinja and click Continue.

If the group has topics, choose where the bot should post in Notification topic: General chat or a specific topic. If the topic you need is not in the list, post a message in that topic mentioning the bot and click the refresh icon (Refresh list). You can also open the list, click Enter ID manually, enter the topic ID from a message link and click Save.

Setting up messages

After connecting, the integration page shows its settings.

• Connected accounts: the chats and groups that receive responses. To add another one, click Connect account or Connect group. To stop sending to a chat, click the trash icon (Remove) next to it.
• Choose questions: the questions whose answers go to Telegram. By default, all questions are selected. Click the edit icon (1), select or clear questions and click Apply.
• Survey Name (2): the heading of each message, up to 70 characters. By default, it is the survey name.
• Buttons on "Report" and "Responses" (3): adds the Reports and All Responses buttons under the message. They open the survey report and the list of responses.
• Hidden Variables: shown if the survey has hidden variables. Select the ones you want to receive.

To check the setup, click Send the test message (4) in Sending Logs. The bot sends a test message to every connected chat.

What a message contains

Each message contains:

• the heading from Survey Name;
• the numbered answers to the selected questions;
• the promo code, if the survey gives promo codes;
• the selected hidden variables;
• User info: the respondent's IP address, country and browser. This block is not sent if the survey is anonymous (Anonymous survey in survey settings).

Viewing sending logs

In Sending Logs, click View to see the messages the bot has sent and the ones it couldn't deliver, with the error reason. To send a failed message again, click Retry next to it. Test messages are not shown in the log.

Removing the integration

At the bottom of the integration page, in Deletion, click Remove and confirm. The integration is deleted together with all its settings.

Limits

• Only completed responses are sent. Incomplete responses don't go to Telegram.
• A message longer than 4,096 characters is split into several messages. The buttons are added to the last one.
• If Telegram is temporarily unavailable, SurveyNinja sends the message again later. Other errors, for example a blocked bot, are not retried automatically.
• If the workspace moves to a plan without Telegram, responses stop going to Telegram.

If something doesn't work

• "Unable to connect. Try again." You didn't click Start in the bot chat, or the bot wasn't added to the group. Do it in Telegram, then click Continue again.
• Messages stopped arriving and the chat disappeared from Connected accounts. The bot was removed from the group or blocked in the personal chat, so SurveyNinja removed this chat. Open Sending Logs → View to see the reason, then connect the chat or group again.
• "The topic was not found or has been deleted." The group topic was deleted. Choose another topic or General chat in Notification topic.
• The topic you need isn't in the list. The bot sees a topic only after a message mentions it there. Post such a message in the topic and click Refresh list, or enter the topic ID manually.