Читання повідомлень відвідувача сайту — це 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-денний пробний період покриває одне місце.