Отримання сторінки підключення ChatWoot — це POST на /chatwoot/v1/connections/link у MakeHybrid ChatWoot API: це ChatWoot, з якого ваша організація вже відповідає своїм клієнтам, на її власному сервері або в її власному хмарному акаунті. Кожен запит несе ваш власний ключ у заголовку X-API-KEY — той самий, що й у LinkedIn API — і дістає лише до того ChatWoot, який підключила ваша організація.
Це ваш власний ChatWoot, за адресою, яку ввів учасник, а виклики виконуються з токеном, який він вставив, — тож ChatWoot записує все від імені цього користувача, і через це саме підключення говорить проєктна кімната.
Запит
curl -X POST "https://makehybrid.com/chatwoot/v1/connections/link" \
-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/chatwoot/mcp/<your API key> у Claude, ChatGPT або будь-якого асистента, що говорить MCP, і попросіть звичайними словами — асистент сам обере виклик, підставить id і прочитає вам відповідь. В універсального агента за адресою https://makehybrid.com/mcp/<your API key> він теж є — поруч із LinkedIn API та всіма іншими каналами.
У проєктній кімнаті
У проєктній кімнаті позначте агента цього API в полі «Може використовувати» у свого ШІ-агента — і він викликатиме «Отримання сторінки підключення ChatWoot» як інструмент щоразу, коли це потрібно розмові. Усі в кімнаті бачать, про що він спитав і що повернулося. Просіть звичайними словами; тут агент зветься @scout:
- @scout перелічи вчорашні розмови ChatWoot, які досі відкриті, і напиши на кожну чернетку відповіді мені на перевірку.
Часті запитання
Чи може ШІ-агент викликати «Отримання сторінки підключення ChatWoot» за мене?
Так. Може будь-який асистент, що говорить MCP, — за адресою вище, — і ваш власний ШІ-агент у проєктній кімнаті із позначеним агентом цього API. Вбудовані агенти кімнати не можуть: вони радять, а вашого ключа в них немає.
Чи працює це поза кімнатою, з мого власного коду?
Так. Запит вище — це та сама операція, яку викликає інструмент ШІ-агента, з тією самою відповіддю й тими самими помилками, а ваш ключ дістає до тих самих каналів, яким би шляхом ви не прийшли.
Чи працює це в кімнаті під моїм власним брендом?
Так. На адресі white-label API, його довідник і його ШІ-агент мають назву вашого продукту й дістають до тих самих каналів за тими самими правилами.
Чи може людина схвалити, перш ніж ШІ-агент це зробить?
Впишіть це в інструкції ШІ-агента: хай скаже, що збирається надіслати, і дочекається, поки людина в кімнаті скаже «давай». Кімната показує кожну відповідь усім, хто в ній, тож слова видно раніше, ніж вони дійдуть до будь-кого ззовні.
У якому тарифі
Входить у тариф MakeHybrid API, з тим самим ключем, що й LinkedIn API: 9 $ за місце на місяць, 7 $ від десяти місць і 5 $ від тисячі. Місць потрібно стільки, скільки у вас того, чого найбільше, — акаунтів LinkedIn, номерів WhatsApp, акаунтів X або акаунтів скриньки, — а 30-денний пробний період покриває одне місце.