


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.
- New subscribers by subscription date for any period.
- Breakdown by UTM source, medium and campaign.
- Telegram, VK, Viber and other messengers shown separately.


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.
What goes into the BotHelp report
These are the metrics that the BotHelp integration already brings into Reportkey reports.
BotHelp reporting: plans and free trial
14 days free, no card required. Prices and plan limits are on the pricing page.
Why teams connect BotHelp to Reportkey
Real reporting jobs, typical pain points, and the outcomes teams get from BotHelp in client reports.
- 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.
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.
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.
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.
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.

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.
Three steps to the first report
Connect the account once, choose the reporting scope, and save the setup for recurring client reports.
Frequently asked questions
Short answers about how the integration works in Reportkey today.
What do I need to connect BotHelp?
Where does the campaign breakdown come from?
Does the report include message opens or step conversions?
Why does the audience size start at the connection date?
Will subscriber counts match the ad platform?
Often connected together
Working sources that teams usually add to the same report.
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.


