Сеть ботов: один ключ на все боты

curl -X POST https://hiviews.net/api/partner/ad \
  -H "Authorization: YOUR_NETWORK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"UserId": 123456789, "UserFirstName": "Ivan", "Language": "ru", "StartPlace": true, "Bot": "my_first_bot"}'

# HiViews, сеть ботов: один ключ на все боты. Бот сам отправляет рекламу.
# pip install aiogram aiohttp
import asyncio, aiohttp
from aiogram import Bot
from aiogram.types import InlineKeyboardMarkup

HIVIEWS_KEY = "YOUR_NETWORK_KEY"

async def show_ad(bot: Bot, user, start: bool = False) -> None:
    """При /start вызывайте с start=True, после выдачи результата — с start=False."""
    me = await bot.me()  # имя бота, который сейчас отвечает пользователю
    payload = {"UserId": user.id, "UserFirstName": user.first_name, "Username": user.username,
               "Language": user.language_code, "StartPlace": start, "Bot": me.username}
    try:
        async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=5)) as s:
            async with s.post("https://hiviews.net/api/partner/ad", json=payload,
                              headers={"Authorization": HIVIEWS_KEY}) as r:
                ad = (await r.json()).get("ad")
        if not ad:
            return  # сейчас рекламы для этого человека нет
        kw = {"parse_mode": "HTML", "reply_markup": InlineKeyboardMarkup.model_validate(ad["reply_markup"])}
        if ad.get("photo"):
            msg = await bot.send_photo(user.id, ad["photo"], caption=ad["text"], **kw)
        elif ad.get("video"):
            msg = await bot.send_video(user.id, ad["video"], caption=ad["text"], **kw)
        elif ad.get("animation"):
            msg = await bot.send_animation(user.id, ad["animation"], caption=ad["text"], **kw)
        else:
            msg = await bot.send_message(user.id, ad["text"], **kw)  # превью ссылок не отключайте
        if ad.get("delete_after"):  # такой пост убираем через минуту, если по нему не перешли
            asyncio.get_running_loop().call_later(
                ad["delete_after"], lambda: asyncio.ensure_future(_quiet_delete(bot, user.id, msg.message_id)))
    except Exception:
        pass  # реклама никогда не должна ломать бота

async def _quiet_delete(bot: Bot, chat_id: int, message_id: int) -> None:
    try:
        await bot.delete_message(chat_id, message_id)
    except Exception:
        pass

# Пример:  await show_ad(bot, message.from_user, start=True)   # /start
#         await show_ad(bot, message.from_user)               # после выдачи результата

// HiViews, сеть ботов: один ключ на все боты. Node.js 18+, Telegraf.
const HIVIEWS_KEY = process.env.HIVIEWS_KEY; // YOUR_NETWORK_KEY

async function showAd(ctx, start = false) {
  // При /start вызывайте showAd(ctx, true), после выдачи результата — showAd(ctx, false).
  try {
    const u = ctx.from;
    const res = await fetch("https://hiviews.net/api/partner/ad", {
      method: "POST",
      headers: { Authorization: HIVIEWS_KEY, "Content-Type": "application/json" },
      body: JSON.stringify({ UserId: u.id, UserFirstName: u.first_name, Username: u.username,
                             Language: u.language_code, StartPlace: start,
                             Bot: ctx.botInfo.username }), // имя бота, который сейчас отвечает пользователю
      signal: AbortSignal.timeout(5000),
    });
    const { ad } = await res.json();
    if (!ad) return; // сейчас рекламы для этого человека нет
    const extra = { parse_mode: "HTML", reply_markup: ad.reply_markup };
    let msg;
    if (ad.photo) msg = await ctx.telegram.sendPhoto(u.id, ad.photo, { caption: ad.text, ...extra });
    else if (ad.video) msg = await ctx.telegram.sendVideo(u.id, ad.video, { caption: ad.text, ...extra });
    else if (ad.animation) msg = await ctx.telegram.sendAnimation(u.id, ad.animation, { caption: ad.text, ...extra });
    else msg = await ctx.telegram.sendMessage(u.id, ad.text, extra); // превью ссылок не отключайте
    if (ad.delete_after) { // такой пост убираем через минуту, если по нему не перешли
      setTimeout(() => ctx.telegram.deleteMessage(u.id, msg.message_id).catch(() => {}), ad.delete_after * 1000);
    }
  } catch (e) { /* реклама никогда не должна ломать бота */ }
}

// Пример:  bot.start(async (ctx) => { await showAd(ctx, true); /* ... */ });

<?php
// HiViews, сеть ботов: один ключ на все боты.
const HIVIEWS_KEY = 'YOUR_NETWORK_KEY';

/** $user — массив from из апдейта Telegram, $botUsername — имя бота без @. При /start: $start = true, после выдачи результата: false.
 *  Возвращает [message_id, delete_after] — если delete_after не null, удалите сообщение через столько секунд. */
function hiviews_show_ad(string $botToken, string $botUsername, array $user, bool $start = false): ?array
{
    $ch = curl_init('https://hiviews.net/api/partner/ad');
    curl_setopt_array($ch, [
        CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 5,
        CURLOPT_HTTPHEADER => ['Authorization: ' . HIVIEWS_KEY, 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode([
            'UserId' => $user['id'], 'UserFirstName' => $user['first_name'] ?? '',
            'Username' => $user['username'] ?? null, 'Language' => $user['language_code'] ?? null,
            'StartPlace' => $start, 'Bot' => $botUsername, // имя бота, который сейчас отвечает пользователю
        ]),
    ]);
    $ad = json_decode((string) curl_exec($ch), true)['ad'] ?? null;
    curl_close($ch);
    if (!$ad) {
        return null; // сейчас рекламы для этого человека нет
    }
    $params = ['chat_id' => $user['id'], 'parse_mode' => 'HTML', 'reply_markup' => json_encode($ad['reply_markup'])];
    if (!empty($ad['photo'])) {
        $method = 'sendPhoto'; $params += ['photo' => $ad['photo'], 'caption' => $ad['text']];
    } elseif (!empty($ad['video'])) {
        $method = 'sendVideo'; $params += ['video' => $ad['video'], 'caption' => $ad['text']];
    } elseif (!empty($ad['animation'])) {
        $method = 'sendAnimation'; $params += ['animation' => $ad['animation'], 'caption' => $ad['text']];
    } else {
        $method = 'sendMessage'; $params += ['text' => $ad['text']]; // превью ссылок не отключайте
    }
    $ch = curl_init('https://api.telegram.org/bot' . $botToken . '/' . $method);
    curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10,
                            CURLOPT_POSTFIELDS => $params]);
    $sent = json_decode((string) curl_exec($ch), true);
    curl_close($ch);
    return [$sent['result']['message_id'] ?? null, $ad['delete_after'] ?? null];
}

// Пример:  hiviews_show_ad($botToken, 'my_first_bot', $update['message']['from'], true);   // /start