FAQ для агентів

Короткі відповіді на питання, які ставить агент, працюючи через Dropslate. Кожна відповідь починається з прямої відповіді, потім причина. Самі правила — у Правилах безпеки; інструменти — у Довіднику інструментів.

Чи можу я створити пост без підтвердження користувача?

Ні. dropslate_create_post і POST /posts відмовляють без confirm: true (confirm_required) і нічого не створюють. Спершу покажіть таблицю з dropslate_plan_post, дочекайтеся «так» від людини, потім викличте створення з confirm: true.

Де взяти id акаунта?

З dropslate_list_accounts (або GET /accounts). Ніколи з памʼяті чи здогадки: id, що не належить цьому workspace, відповідає not_found, а вигаданий id не існує. Список також показує стан токена кожного акаунта; в expired або revoked акаунт публікувати не можна, доки людина його не перепідключить.

Як надіслати файл із компʼютера користувача?

Викличте dropslate_create_upload із filename, mime і size, потім зробіть PUT байтів на повернутий uploadUrl із локальної оболонки — curl -X PUT "<uploadUrl>" -H "Content-Type: video/mp4" --data-binary @file.mp4 — і опитуйте dropslate_get_media, доки status не стане ready. URL одноразовий і живе годину; Content-Length має дорівнювати size. Використовуйте той самий mediaId для кожного поста, якому потрібен файл; ніколи не завантажуйте його двічі.

Файл за URL, а не на компʼютері.

Використайте dropslate_upload_from_url (або POST /media/from-url) із публічним https-URL. Приватні, внутрішні й не-https адреси відхиляються. Потім опитуйте dropslate_get_media до ready, як вище.

Чи план — справжня дія?

Ні. dropslate_plan_post (POST /posts/plan) не має побічних ефектів. Викликайте його скільки завгодно, поки складаєте план; він повертає по рядку на акаунт із перевіркою й текстову таблицю, яку можна показати як є.

Що я можу на Free-тарифі?

Лише читати. tools/list показує 11 інструментів читання: whoami, список акаунтів, груп, медіа й папок, отримати медіа, план, список і отримання постів і два читання аналітики. Публікація потребує платного тарифу; скажіть про це людині замість того, щоб пробувати прихований інструмент — протокол його відхилить.

Мій ключ лише на читання.

Те саме, що Free: 11 інструментів читання. Ключ зі write створюється в застосунку в Налаштування → Ключі API; ви не можете створювати ключі й не маєте просити людину вставити ключ у чат — він належить середовищу клієнта.

Як повідомляти результат?

Лише після того, як інструмент повернув успіх, і з id поста, акаунтом і абсолютним часом у часовому поясі workspace. statusLine інструмента і є цим реченням: Queued. YouTube · What We Made · 28 Sep, 18:00 (Kyiv). dropslate_whoami дає часовий пояс.

Що таке when?

"now", "draft" або обʼєкт {"publishAt": "2026-09-29T18:00", "timezone": "Europe/Kiev"} — локальний час і пояс IANA, у якому він записаний — щонайменше за 2 хвилини наперед і щонайбільше за рік. dropslate_whoami дає пояс workspace; використовуйте його, якщо людина не назвала інший.

Той самий текст не вміщується в кожну мережу.

Покладіть власний текст мережі в overrides — {"overrides": {"threads": {"text": "…"}}} — і специфічні для мережі налаштування в perPlatform (youtube.visibility, instagram.contentType, facebook.link, threads.topicTag). План перевіряє кожен акаунт проти лімітів його мережі й називає поле, що не проходить.

Пост не вдався. Повторювати?

Спершу прочитайте dropslate_get_post: error.message — власні слова мережі. Повідомлення про токен чи дозвіл потребує, щоб людина перепідключила акаунт; повідомлення про ліміт чи квоту повторюється само або пізніше; повідомлення про файл чи поле потребує зміненого поста — повтор того самого запиту впаде так само. dropslate_retry_post потребує confirm: true.

Чи можу я підключити акаунт, змінити оплату чи вилучити учасника?

Ні. Для цього немає інструмента за жодного scope. Ці дії існують лише в дашборді за сесією з входом.

Де правила, яких мені дотримуватись?

В описі кожного інструмента, дослівно, і на Правилах безпеки. Готовий файл skill із тими самими правилами — на skill.md.