Список агентів спільної скриньки — це GET на /inbox/v1/agents у MakeHybrid Inbox API, тобто в спільній скриньці для WhatsApp, Instagram, Facebook, TikTok, Telegram, LINE, пошти, SMS і чату на вашому сайті. Кожен запит несе ваш власний ключ у заголовку X-API-KEY — той самий, що й у LinkedIn API — і дістає лише до власного акаунта скриньки вашої організації.
Одна скринька тримає всі канали, які ви до неї додали, тож відповідь іде в той канал, у якому написав клієнт, — WhatsApp, Instagram, пошта чи будь-який інший, — тим самим викликом.
Запит
curl -X GET "https://makehybrid.com/inbox/v1/agents" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Що приходить, коли не працює
- 401 — ключа немає, він хибний або відкликаний.
- 402 — тариф не оплачено. Тариф MakeHybrid API відповідає так, коли пробний період скінчився.
- 404 — або цього немає, або це не вашої організації. Обидва випадки навмисне дають однакову відповідь, щоб id не можна було перебрати.
- 429 — забагато запитів або платформа просить нас пригальмувати. Зачекайте трохи, перш ніж пробувати знову.
- 502 або 503 — платформа щойно не відповіла. Спробуйте ще раз за хвилину.
Кожна помилка — це JSON однієї форми: {"type":"errors/<code>","status":<n>,"detail":"..."} — тож один обробник покриває всі, а detail написано так, щоб його можна було показати людині.
Попросити асистента
Ця операція — ще й інструмент MCP. Вставте https://makehybrid.com/inbox/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-денний пробний період покриває одне місце.