Чтение сообщений посетителя сайта — это GET по /webchat/v1/conversations/{id}/messages в MakeHybrid Website chat API: это собственный чат вашей организации на её сайтах, на который отвечают ваша команда или ваши ИИ-агенты. Каждый запрос несёт ваш собственный ключ в заголовке X-API-KEY — тот же, что и у LinkedIn API — и достаёт только до ваших собственных чатов.
Чат — ваш собственный, он хранится у нас, а не в другом сервисе входящих: разговор посетителя доступен только по вашему ключу, а ИИ-агент, который отвечает посетителям, делает это без каких-либо инструментов.
Запрос
curl -X GET "https://makehybrid.com/webchat/v1/conversations/$ID/messages" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Что идёт в путь
- id — id, который вернул предыдущий вызов из этого семейства.
Что приходит, когда не работает
- 401 — ключа нет, он неверный или отозван.
- 402 — тариф не оплачен. Тариф MakeHybrid API отвечает так, когда пробный период закончился.
- 404 — либо этого нет, либо это не вашей организации. Оба случая намеренно дают один и тот же ответ, чтобы id нельзя было перебрать.
- 429 — слишком много запросов или платформа просит нас притормозить. Подождите немного, прежде чем пробовать снова.
- 502 или 503 — платформа только что не ответила. Попробуйте ещё раз чуть позже.
Любая ошибка — это JSON одной и той же формы: {"type":"errors/<code>","status":<n>,"detail":"..."} — поэтому один обработчик покрывает все, а detail написан так, чтобы его можно было показать человеку.
Попросить ассистента
Эта операция ещё и инструмент MCP. Вставьте https://makehybrid.com/webchat/mcp/<your API key> в Claude, ChatGPT или любого ассистента, говорящего на MCP, и попросите обычными словами — ассистент сам выберет вызов, подставит id и прочитает вам ответ. У универсального агента по адресу https://makehybrid.com/mcp/<your API key> он тоже есть — рядом с LinkedIn API и всеми остальными каналами.
В проектной комнате
В проектной комнате отметьте агента этого API в поле «Может использовать» у своего ИИ-агента — и он будет вызывать «Чтение сообщений посетителя сайта» как инструмент всякий раз, когда это нужно разговору. Все в комнате видят, о чём он спросил и что вернулось. Просите обычными словами; здесь агент называется @scout:
- @scout перечисли разговоры в чате на сайте, на которые ещё никто не ответил, и набросай ответ на каждый, чтобы я проверил.
Частые вопросы
Может ли ИИ-агент вызвать «Чтение сообщений посетителя сайта» за меня?
Да. Может любой ассистент, говорящий на MCP, — по адресу выше, — и ваш собственный ИИ-агент в проектной комнате с отмеченным агентом этого API. Встроенные агенты комнаты не могут: они советуют, а вашего ключа у них нет.
Работает ли это вне комнаты, из моего собственного кода?
Да. Запрос выше — это та же операция, которую вызывает инструмент ИИ-агента, с тем же ответом и теми же ошибками, а ваш ключ достаёт до тех же каналов, каким бы путём вы ни пришли.
Работает ли это в комнате под моим собственным брендом?
Да. На адресе white-label API, его справочник и его ИИ-агент несут название вашего продукта и достают до тех же каналов по тем же правилам.
В каком тарифе
Входит в тариф MakeHybrid API, с тем же ключом, что и LinkedIn API: 9 $ за место в месяц, 7 $ от десяти мест и 5 $ от тысячи. Мест нужно столько, сколько у вас того, чего больше всего, — аккаунтов LinkedIn, номеров WhatsApp, аккаунтов X или аккаунтов ящика, — а 30-дневный пробный период охватывает одно место.