受信トレイの担当者全員の一覧 は /inbox/v1/agents に対する GET で、MakeHybrid Inbox API にあります。WhatsApp、Instagram、Facebook、TikTok、Telegram、LINE、メール、SMS、Web サイトのチャットを、ひとつの受信トレイにまとめたものです。すべてのリクエストは 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":"..."} — ハンドラ 1 つで全部を受けられますし、detail は人に見せるために書かれています。
代わりにアシスタントに頼む
この操作は MCP ツールでもあります。https://makehybrid.com/inbox/mcp/<your API key> を Claude や ChatGPT、あるいは MCP を話すアシスタントに貼り付けて、ふつうの言葉で頼んでください。アシスタントが呼び出しを選び、id を埋め、答えを読み上げます。https://makehybrid.com/mcp/<your API key> のオールインワンのエージェントにも入っていて、LinkedIn API やほかのすべてのチャネルと並んで使えます。
プロジェクトルームの中で
プロジェクトルームで、自分の AI エージェントの「使えるサーバー」でこの API のエージェントにチェックを入れると、会話で必要になるたびに、そのエージェントが「受信トレイの担当者全員の一覧」をツールとして呼び出します。ルームの全員に、何を頼み、何が返ってきたかが見えます。ふつうの言葉で頼んでください。ここではエージェントの名前が @scout です：
- @scout すべてのチャネルから今日のオープンな会話を一覧にして、いちばん古いものへの返信を下書きして。
よくある質問
AI エージェントに「受信トレイの担当者全員の一覧」を呼び出してもらえますか？
はい。MCP を話すアシスタントなら、上のアドレスを通じて呼び出せますし、この API のエージェントにチェックを入れたプロジェクトルームの自分の AI エージェントも呼び出せます。ルームの組み込みエージェントにはできません。助言をするだけで、あなたのキーを持っていないからです。
ルームの外、自分のコードからでも使えますか？
はい。上のリクエストは、AI エージェントのツールが呼ぶのと同じ操作で、答えもエラーも同じです。どの経路から入っても、キーが届くチャネルは同じです。
自分のブランドのルームでも使えますか？
はい。ホワイトラベルのアドレスでは、API もそのリファレンスも AI エージェントも自社のプロダクト名で表示され、同じルールのもとで同じチャネルに届きます。
どのプランか
MakeHybrid API プランに含まれ、LinkedIn API と同じキーで使えます。1 シートにつき月 9 ドル、10 シートからは 7 ドル、1000 シートからは 5 ドル。必要なシート数は、LinkedIn アカウント、WhatsApp 番号、X アカウント、受信トレイのアカウントのうち、いちばん多い種類の数と同じで、30 日間の試用は 1 シート分です。