Aivtomation Crossposter Docs
Повний практичний довідник для адміністратора, нових співробітників та клієнтів. Детальний гайд для кожної з 6 платформ із розбором усіх типових помилок ("граблів"), щоб налаштування зайняло 5-10 хвилин замість годин пошуку.
В адмін-панелі (у модальному вікні «🔑 API-токени клієнта») для кожного клієнта окремо зберігаються наступні параметри:
| Поле в системі | Для якої соцмережі | Що це таке і який формат має | Термін дії |
|---|---|---|---|
| fb_page_id | Числовий ID бізнес-сторінки Facebook (наприклад 104829384729102) |
Постійний | |
| ig_account_id | ID зв'язаного Business/Creator Instagram акаунту (17 цифр, напр. 17841400928374829) |
Постійний | |
| meta_access_token | FB + Instagram | Never-Expiring Page Access Token (починається з EAA...) |
Безстроковий |
| threads_access_token | Threads | Користувацький токен Threads (починається з THQ...) |
60 днів (поновлюється) |
| telegram_bot_token | Telegram | API токен бота від @BotFather (напр. 7616792714:AAGOlQ...) |
Постійний |
| telegram_channel_id | Telegram | Юзернейм публічного каналу (@my_channel) або числовий ID приватного (-1002048991234) |
Постійний |
| youtube_refresh_token | YouTube | OAuth 2.0 Refresh Token (починається з 1//04...) |
Безстроковий |
| tiktok_access_token | TikTok (Відео + Фото) | 1-клік підключення Buffer OAuth (автопілот) або токен G-.... Підтримка відео та фото-каруселей до 35 фото! |
Автопілот (OAuth Auto-Renew) |
| cloudinary_cloud_name | Cloudinary (Відео) | Назва хмари клієнта (вона ж Key Name новоствореного ключа, напр. efgajoah) |
Безстроковий |
| cloudinary_api_key | Cloudinary (Відео) | 15-значний числовий API Key клієнта (напр. 289976383419523) |
Безстроковий |
| cloudinary_api_secret | Cloudinary (Відео) | Секретний ключ (знаходиться у рядку створеного ключа в колонці API Secret) | Безстроковий |
fb_page_id, ig_account_id та безстроковий meta_access_token.
OAuthException: User does not have permission.
Aivtomation SMM - ClientName) та контактний email.id сторінки — це fb_page_id.instagram_business_account.id — це ig_account_id.access_token — це Never-Expiring Page Token (він діє безстроково, доки не змінено пароль від акаунта Facebook!).access_token сторінки в Access Token Debugger. У полі Expires має бути написано: Never (Ніколи)!
threads_access_token (60-денний токен публікації у Threads).
Як поновити токен у системі Aivtomation:
telegram_bot_token та telegram_channel_id.
/newbot.bot (наприклад: chempion_agency_autopost_bot).403 Forbidden: bot is not a member of the channel).
t.me/realty_kyiv):telegram_channel_id вписуйте просто юзернейм з собачкою: @realty_kyiv.
t.me/+AbCd123...):-1002491029384.youtube_refresh_token (вічний ключ для автономного завантаження відео без потреби логінитись щоразу).
Aivtomation YouTube Uploader).1//04...). Скопіюйте його!G-... та вставте у поле «TikTok Token / Buffer Personal Key» в Aivtomation.
Диспетчер кроспостингу Aivtomation підтримує як публікацію відеороликів, так і нативні вірусні фото-каруселі TikTok:
Перейдіть на офіційний сайт для реєстрації: cloudinary.com/users/register_free.
Оберіть реєстрацію в 1 клік через Google-акаунт (наприклад, aivtomation@gmail.com) або введіть email і пароль. Кредитна картка НЕ потрібна.
Для безпеки та ізоляції сервісу ми створюємо окремий новий API-ключ. Щоб ніколи не плутатися, зробіть кілька простих кроків:
https://console.cloudinary.com/app/.../settings/api-keys).
Cloud name: ваш_унікальний_ідентифікатор (наприклад, efgajoah). Це головне ім'я вашої персональної хмари!
efgajoah). Всі інші налаштування залиште за замовчуванням і натисніть кнопку створення.
efgajoah).
289976383419523).
nrSyZkFWLKwO-LQT_oySqbdGvP0).
Перейдіть у Панель Адміністратора Aivtomation (або передайте ці 3 ключі вашому менеджеру):
Cloud Name (напр. efgajoah), API Key та API Secret і натисніть «Зберегти токени».Часто виникає плутанина, коли змішують три різні рівні обмежень: звичайний мобільний додаток (де людина публікує вручну), офіційний API соцмережі (жорсткі програмні ліміти для ботів і серверів) та хмарний сервіс-агрегатор Buffer. Нижче наведено верифіковану технічну таблицю правил для будь-якого розміру файлу — незалежно від того, важить відео 30 МБ, 100 МБ чи 1 ГБ.
| Платформа / Спосіб публікації | Максимальний розмір | Ліміт тривалості | Вимога до стиснення | Технічні умови та правила |
|---|---|---|---|---|
| ✈️ Telegram Bot API (Відео ≤ 45 МБ) Пряме надсилання оригіналу (sendVideo) | До 45 МБ (безпечний ліміт) | Без обмежень | 🟢 НІ (ЗАВЖДИ ОРИГІНАЛ) | Файли до 45 МБ надсилаються як нативне відео без жодного перекодування: 100% якість, чистий звук та ідеальні пропорції 9:16 на iPhone та Android. |
| ✈️ Telegram (Відео > 45 МБ) Авто-публікація з YouTube-посиланням | Будь-який розмір (> 45 МБ) | Довгі відео / випуски | 🟢 НІ (БЕЗ СТИСНЕННЯ) | Браузерне стиснення вимкнено через ризик розсинхрону звуку та сплющення на смартфонах. Бот публікує повноцінний допис із посиланням на YouTube, яке отримується раніше в черзі постингу! |
| ✈️ Telegram (Звичайний клієнт) Людина публікує руками через додаток | До 2 ГБ (до 4 ГБ з Premium) | До кількох годин | 🟢 НІ (ТІЛЬКИ ЯКЩО > 2 ГБ) | Це ліміт інтерфейсу людини в Telegram. Не плутати з лімітами Bot API, через які публікують програми автопостингу! |
| 🎵 TikTok (Buffer Direct API) Пряма інтеграція через api.buffer.com | До 500 МБ (API) / 1 ГБ (Web) | Від 3 сек до 10 хв (600 сек) | 🟢 НІ (БЕЗ СТИСНЕННЯ ДО 500 МБ) | Старий ліміт 90 МБ скасовано разом із виключенням Zapier! Підтримуються MP4 та MOV. Будь-які ролики 50, 100, 200 чи 250 МБ завантажуються без штучного заниження якості. |
| 🎵 TikTok (Content Posting API) Офіційний API TikTok | До 4 ГБ | До 10 хв через API | 🟢 НІ (ТІЛЬКИ ЯКЩО > 4 ГБ) | Файли понад 64 МБ завантажуються частинами (chunked upload, до 1000 частин). |
| 🧵 Threads (через Buffer) Публікація чергою Buffer | До 1 ГБ | До 10 хв у Buffer | 🟢 НІ (ТІЛЬКИ ЯКЩО > 1 ГБ) | MP4, MOV, WEBM. Проходить вільно без стиснення розміру. |
| 🧵 Threads (Офіційний API Meta) Meta Graph Threads Endpoint | До 1 ГБ | СТРОГО до 5 хвилин (300 сек) | 🟡 ОБРІЗКА, ЯКЩО > 5 ХВ | Ключове обмеження — тривалість до 5 хвилин. Threads API НЕ нарізає відео автоматично на слайди! Відео понад 300с поверне INVALID_PARAM, тому потрібна обрізка. |
| ▶️ YouTube (Звичайне відео) Google Data API v3 | До 256 ГБ (або 12 годин) | До 15 хв (без SMS), до 12 год (з SMS) | 🟢 ПРАКТИЧНО НІКОЛИ | Сервери Google приймають гігабайтні файли без примусового попереднього стиснення. |
| ▶️ YouTube Shorts Формат коротких відео (9:16) | До 256 ГБ | До 60 сек (до 3 хв для вертикальних) | 🟢 НІ (ТІЛЬКИ ТРИВАЛІСТЬ) | Якщо вертикальне відео довше ліміту Shorts, YouTube опублікує його як звичайне довге відео на каналі. |
| 📘 Facebook Page (Офіційний API) Meta Graph API (Videos Edge) | До 4 ГБ – 10 ГБ | До 240 хвилин | 🟢 НІ (ТІЛЬКИ ЯКЩО > 4 ГБ) | Повнорозмірні відео з високим бітрейтом проходять без обмежень. |
| 📘 Facebook (через Buffer) Buffer Video Scheduling | До 1 ГБ | До 240 хвилин | 🟢 НІ (ТІЛЬКИ ЯКЩО > 1 ГБ) | Хмарний ліміт Buffer для публікацій у Facebook. |
| 📸 Instagram Reels (через Buffer) Buffer Reels Scheduling | До 300 МБ | Від 3 сек до 15 хв (900 сек) | 🟡 ПОТРІБНО, ЯКЩО > 300 МБ | Buffer обмежує розмір файлу Reels до 300 МБ. Якщо файл важче 300 МБ, потрібна оптимізація до ~290 МБ. |
| 📸 Instagram Reels (Meta Graph API) Прямий API Instagram Business | До 1 ГБ (300 МБ рекомендовано) | Від 3 сек до 15 хв (900 сек) | 🟢 ЗАВЖДИ ОРИГІНАЛ | Сервери Meta самі перекодовують відео. Якщо завантажити вже попередньо стиснене відео, Instagram накладе друге стиснення («подвійне мило»). Подача оригіналу зберігає найвищу якість. |
api.buffer.com) сервери Buffer приймають файли до 500 МБ через API (та до 1 ГБ через Web). Відео 50, 100, 200 чи 250 МБ публікуються в оригінальній бездоганній якості без жодного штучного заниження бітрейту.
INVALID_PARAM. Тому тривалість контролюється авто-обрізкою до 5 хвилин.
sendVideo), приймають файл без жодних змін і без втрати звуку.