Skip to content
Reportkey
BotHelp
BotHelp chatbots

BotHelp chatbot subscriber report with an ad campaign breakdown

Reportkey pulls BotHelp bot subscribers and breaks them down by day, messenger and UTM tags, so next to ad spend you can see which campaigns actually grow the bot's audience.

14 days free · no card required · all integrations
Sign up, add your BotHelp keys and pick the account in a project. Your first report in 5 minutes.
  • New subscribers by subscription date for any period.
  • Breakdown by UTM source, medium and campaign.
  • Telegram, VK, Viber and other messengers shown separately.
Sample Reportkey client report
Sample Reportkey client report
BotHelpBot subscribers by messenger, UTM source, and tag
30+
integrations
5 min
setup
14 days
trial
TL;DR

BotHelp integration: enter the client_id and client_secret from the Integrations section of BotHelp once and pick the account in a project. New subscribers by messenger, channel, UTM source and tag, plus the size of the base, reach the client as a link or PDF on schedule.

Which campaigns bring subscribers to the bot

A messenger chatbot has become a common ad destination: instead of a website form, people press Start and enter an automated funnel. That is convenient for marketers but harder to report on, because the ad platform sees clicks while real subscriptions live in BotHelp. Reportkey connects the two: it reads subscribers from BotHelp through the API, groups them by UTM tags and places them next to ad spend in one recurring report.

Connecting BotHelp: client_id and client_secret

BotHelp grants API access with a key pair created in your account under Settings, then Integrations. Enter the pair once on the Reportkey integrations page. The working BotHelp token lasts an hour and Reportkey renews it on its own, so nobody has to sign in again. In the project you pick the connected account, report blocks and a delivery schedule.

New subscribers by day and messenger

The core block counts how many people subscribed to the bots in the period. Counting uses the BotHelp subscription date, with breakdowns:

  • by day, week or month;
  • by messenger, such as Telegram, VK, Viber and other channels connected to the account;
  • by specific channel, when a client runs several bots in one messenger.

For an online school it shows where the audience lives; for an agency it confirms that a new funnel delivered growth.

Chatbot subscribers by UTM tags

When someone reaches the bot through a tagged link, BotHelp stores five UTM fields on the subscriber: source, medium, campaign, content and term. Reportkey groups new subscribers by source, medium and campaign and shows each row’s share. Next to campaign spend, that gives cost per subscriber without manual math.

It only works with tagging discipline. Links in ads, posts and influencer placements need tags; otherwise subscribers fall into the no-UTM row and campaigns cannot be compared.

Audience size and active subscriptions

The third block is a snapshot at the report date: total subscribers, how many have an active subscription, and the split by messenger and by tags the bot assigns in its flows. Because BotHelp does not return the history of its base, Reportkey stores these snapshots daily from the moment of connection. After a few months they form a growth curve nobody tracked before.

What BotHelp does not expose through its API

Message opens, revenue, payments and funnel step conversions are not part of the BotHelp API, so the report does not include them. Bot and funnel structure is available, without per-step statistics. If the client cares about payments after the bot, take them from the CRM or payment service and add them to the same report.

BotHelp next to ads and CRM

Bot subscribers make the most sense next to whoever paid for them: VK Ads campaigns and website goals in Yandex Metrica. Deals that follow the bot can come from amoCRM. If some funnels run on other builders, use Salebot or Senler, and for a Telegram channel, TGStat. Branding and AI insights are available, though not on every plan. See an example in the SMM agency demo report, find more messenger sources under social media and messengers, and check pricing.

Metrics

What goes into the BotHelp report

These are the metrics that the BotHelp integration already brings into Reportkey reports.

New subscribers
Total subscribers
Active subscriptions
By messenger
By UTM source
What this integration adds to the report
Bot subscribers by messenger, UTM source, and tag
Pricing

BotHelp reporting: plans and free trial

14 days free, no card required. Prices and plan limits are on the pricing page.

Use cases

Why teams connect BotHelp to Reportkey

Real reporting jobs, typical pain points, and the outcomes teams get from BotHelp in client reports.

Pain points
  • A targeting specialist drives traffic to a bot from three campaigns and has to filter BotHelp by hand to see what each one delivered.
  • The client pays for ads optimised for bot subscriptions but sees clicks in the campaign report instead of people who subscribed.
  • Nobody records the bot's audience size at month start and end, so six months later its growth cannot be shown.
BotHelp
A targeting specialist sending traffic to a bot

VK Ads spend and BotHelp subscribers by UTM campaign sit in one report. Cost per subscriber for each campaign needs no exports, and weak ads stand out in the first week.

BotHelp
An online school with a messenger funnel

The bot collects webinar sign-ups in Telegram and VK. Each week the producer sees which messenger brings more subscribers and from which traffic channel they came.

BotHelp
An agency building bots for clients

After launch the client receives a monthly growth report: new subscribers by day, active subscriptions at the report date and a breakdown by the tags the bot assigns in its flows.

Report preview

How BotHelp appears inside the report

The report keeps the familiar Reportkey layout: source sections and period comparison.

  • Daily audience snapshots: total subscribers and active subscriptions.
Sample Reportkey client report
Sample Reportkey client report
Monthly bot subscriber block

Daily new subscriber bars coloured by messenger, a UTM campaign table with subscriber counts and shares, and a tile with the audience size at month end.

How to connect

Three steps to the first report

Connect the account once, choose the reporting scope, and save the setup for recurring client reports.

01
Connect the account
Save the BotHelp connection once so the same datasource can be reused across recurring client reports.
02
Choose the reporting scope
Choose the BotHelp channel, community, or bot that should supply audience and engagement data to the report.
03
Save the setup and generate the report
Keep the selected scope in the project and reuse the same report setup next time instead of connecting the source again.
FAQ

Frequently asked questions

Short answers about how the integration works in Reportkey today.

What do I need to connect BotHelp?
A client_id and client_secret pair created in your BotHelp account under Settings, then Integrations. Enter it once on the Reportkey integrations page; access is renewed automatically without signing in again.
Where does the campaign breakdown come from?
From the UTM tags BotHelp stores on a subscriber who arrives through a link to the bot. When ad links are tagged, subscribers split by source, medium and campaign. Untagged arrivals land in a separate no-UTM row.
Does the report include message opens or step conversions?
No. The BotHelp API returns subscribers and the structure of bots and funnels, but not message opens, revenue or step conversions. Those stay in the BotHelp interface.
Why does the audience size start at the connection date?
BotHelp does not provide a daily history of the base. Reportkey counts new subscribers by subscription date for any period, while total size and active subscriptions are recorded in daily snapshots starting from the connection.
Will subscriber counts match the ad platform?
Rarely. An ad platform counts clicks or conversion events, while BotHelp counts people who actually became subscribers. Some clickers never press Start, and one person may subscribe in two messengers.

BotHelp chatbot subscriber report with an ad campaign breakdown

Sign up, add your BotHelp keys and pick the account in a project. Your first report in 5 minutes.

Start free