Початок групової розмови в X — це POST на /x/v1/2/dm_conversations у MakeHybrid X API: це власний акаунт X вашої організації, що працює через ключі вашого власного застосунку X. Кожен запит несе ваш власний ключ у заголовку X-API-KEY — той самий, що й у LinkedIn API — і дістає лише до акаунта, який підключила ваша організація.
Виклики йдуть із ключами вашого власного застосунку X, тож діють ліміти вашого застосунку — так, як X рахує їх для свого тарифу.
Запит
curl -X POST "https://makehybrid.com/x/v1/2/dm_conversations" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
Що приходить, коли не працює
- 401 — ключа немає, він хибний або відкликаний.
- 402 — тариф не оплачено. Тариф MakeHybrid API відповідає так, коли пробний період скінчився.
- 404 — або цього немає, або це не вашої організації. Обидва випадки навмисне дають однакову відповідь, щоб id не можна було перебрати.
- 429 — забагато запитів або платформа просить нас пригальмувати. Зачекайте трохи, перш ніж пробувати знову.
- 502 або 503 — платформа щойно не відповіла. Спробуйте ще раз за хвилину.
Кожна помилка — це JSON однієї форми: {"type":"errors/<code>","status":<n>,"detail":"..."} — тож один обробник покриває всі, а detail написано так, щоб його можна було показати людині.
Попросити асистента
Ця операція — ще й інструмент MCP. Вставте https://makehybrid.com/x/mcp/<your API key> у Claude, ChatGPT або будь-якого асистента, що говорить MCP, і попросіть звичайними словами — асистент сам обере виклик, підставить id і прочитає вам відповідь. В універсального агента за адресою https://makehybrid.com/mcp/<your API key> він теж є — поруч із LinkedIn API та всіма іншими каналами.
У проєктній кімнаті
У проєктній кімнаті позначте агента цього API в полі «Може використовувати» у свого ШІ-агента — і він викликатиме «Початок групової розмови в X» як інструмент щоразу, коли це потрібно розмові. Усі в кімнаті бачать, про що він спитав і що повернулося. Просіть звичайними словами; тут агент зветься @scout:
- @scout покажи сьогоднішні особисті повідомлення в X і накидай відповідь на кожне.
Часті запитання
Чи може ШІ-агент викликати «Початок групової розмови в X» за мене?
Так. Може будь-який асистент, що говорить MCP, — за адресою вище, — і ваш власний ШІ-агент у проєктній кімнаті із позначеним агентом цього API. Вбудовані агенти кімнати не можуть: вони радять, а вашого ключа в них немає.
Чи працює це поза кімнатою, з мого власного коду?
Так. Запит вище — це та сама операція, яку викликає інструмент ШІ-агента, з тією самою відповіддю й тими самими помилками, а ваш ключ дістає до тих самих каналів, яким би шляхом ви не прийшли.
Чи працює це в кімнаті під моїм власним брендом?
Так. На адресі white-label API, його довідник і його ШІ-агент мають назву вашого продукту й дістають до тих самих каналів за тими самими правилами.
Чи може людина схвалити, перш ніж ШІ-агент це зробить?
Впишіть це в інструкції ШІ-агента: хай скаже, що збирається надіслати, і дочекається, поки людина в кімнаті скаже «давай». Кімната показує кожну відповідь усім, хто в ній, тож слова видно раніше, ніж вони дійдуть до будь-кого ззовні.
У якому тарифі
Входить у тариф MakeHybrid API, з тим самим ключем, що й LinkedIn API: 9 $ за місце на місяць, 7 $ від десяти місць і 5 $ від тисячі. Місць потрібно стільки, скільки у вас того, чого найбільше, — акаунтів LinkedIn, номерів WhatsApp, акаунтів X або акаунтів скриньки, — а 30-денний пробний період покриває одне місце.