Отправка сообщения в X по имени пользователя или id — это POST по /x/v1/messages в MakeHybrid X API: это собственный аккаунт X вашей организации, работающий через ключи вашего собственного приложения X. Каждый запрос несёт ваш собственный ключ в заголовке X-API-KEY — тот же, что и у LinkedIn API — и достаёт только до аккаунта, который подключила ваша организация.
Вызовы уходят с ключами вашего собственного приложения X, поэтому действуют лимиты вашего приложения — так, как X считает их для своего тарифа.
Запрос
curl -X POST "https://makehybrid.com/x/v1/messages" \
-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 по имени пользователя или id» как инструмент всякий раз, когда это нужно разговору. Все в комнате видят, о чём он спросил и что вернулось. Просите обычными словами; здесь агент называется @scout:
- @scout покажи сегодняшние личные сообщения в X и набросай ответ на каждое.
Частые вопросы
Может ли ИИ-агент вызвать «Отправка сообщения в X по имени пользователя или id» за меня?
Да. Может любой ассистент, говорящий на MCP, — по адресу выше, — и ваш собственный ИИ-агент в проектной комнате с отмеченным агентом этого API. Встроенные агенты комнаты не могут: они советуют, а вашего ключа у них нет.
Работает ли это вне комнаты, из моего собственного кода?
Да. Запрос выше — это та же операция, которую вызывает инструмент ИИ-агента, с тем же ответом и теми же ошибками, а ваш ключ достаёт до тех же каналов, каким бы путём вы ни пришли.
Работает ли это в комнате под моим собственным брендом?
Да. На адресе white-label API, его справочник и его ИИ-агент несут название вашего продукта и достают до тех же каналов по тем же правилам.
Может ли человек одобрить, прежде чем ИИ-агент это сделает?
Впишите это в инструкции ИИ-агента: пусть скажет, что собирается отправить, и дождётся, пока человек в комнате скажет «давай». Комната показывает каждый ответ всем, кто в ней, поэтому слова видны раньше, чем попадут к кому-либо снаружи.
В каком тарифе
Входит в тариф MakeHybrid API, с тем же ключом, что и LinkedIn API: 9 $ за место в месяц, 7 $ от десяти мест и 5 $ от тысячи. Мест нужно столько, сколько у вас того, чего больше всего, — аккаунтов LinkedIn, номеров WhatsApp, аккаунтов X или аккаунтов ящика, — а 30-дневный пробный период охватывает одно место.