ArgorantDocs

返信に答える

すべてのキャンペーンのすべての返信を、1つの受信トレイに。同じスレッドで返信し、転送し、返信に関心あり、商談予約済み、または独自のパイプライン段階を付けられます。

新しい返信を確認する

Shell
curl "https://app.argorant.com/api/v1/inbox?folder=replies&limit=25" -H "Authorization: Bearer $ARGORANT_API_KEY"

folderはall、replies、interested、not_interested、out_of_office、bounces、unsubscribesのいずれかです。さらに絞り込むには、campaign_id、classification、またはqに検索語を指定します。会話は最新のアクティビティが先頭に並び、自分の返信も含まれます。一覧には最新メッセージの最初の300文字が表示されます。has_moreがfalseになるまで、cursorとnext_cursorでページを進めます。すべての会話にたどり着けます。まだ誰もラベルを付けていない会話の分類はunknownです。

変更分だけを読む

Shell
curl "https://app.argorant.com/api/v1/inbox?received_after=2026-11-10T09:00:00Z&limit=100" -H "Authorization: Bearer $ARGORANT_API_KEY"

received_afterを指定すると、相手からの最新メッセージがその時刻より後に届いた会話だけが残ります。updated_afterは自分の返信も対象にします。各会話にはlead_id、updated_at、last_received_atがあります。代わりにスケジュールでAPIを読む場合は、毎回の読み取りを前回の終了時刻の数分前から始め、すでに取得したIDは飛ばしてください。行は、記録されている時刻より少し後に保存されることがあります。そのため、前回の終了時刻ちょうどから始まる範囲では取りこぼすおそれがあります。Webhookなら、こうした対応はいっさい不要です。

会話を読む

Shell
curl "https://app.argorant.com/api/v1/inbox/$THREAD" -H "Authorization: Bearer $ARGORANT_API_KEY"

$THREADは一覧のidです。全文とスレッド全体が古い順に返ります。自分のメール、相手の返信、自分の返信、転送がすべて含まれます。

同じスレッドで返信する

Shell
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/reply" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: reply-jane-1" \
  -H "Content-Type: application/json" \
  -d '{"body":"Thursday 10:00 works. I will send an invite."}'

返信はただちに、同じスレッドで、返信を受け取ったメールボックスから送信されます。エージェントは文面をユーザーに見せ、承認を待つ必要があります。Idempotency-Keyにより、再試行しても二重に送信されることはありません。

同僚に転送する

Shell
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/forward" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: fwd-jane-1" \
  -H "Content-Type: application/json" \
  -d '{"to":["sales-lead@yourcompany.com"],"note":"Hot lead, please call her this week."}'

転送には履歴と添付ファイルが含まれます。3分以内に、配信されたかどうかが会話に表示されます。

ラベルを付けてパイプラインを管理する

どのワークスペースにも5つの標準ラベルがあります。positive(関心ありと表示)、meeting_request、out_of_office、unsubscribe、neutral(その他と表示)です。not_interested、question、referral、wrong_person、meeting_bookedをオンにすることもできます。独自の段階も追加できます。

Shell
curl -X POST "https://app.argorant.com/api/v1/reply-statuses" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"label":"Proposal sent","color":"purple"}'

curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/classify" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"classification":"proposal_sent"}'

interestedはpositiveとして扱われます。段階の名前や色の変更、表示と非表示の切り替えはPATCH /api/v1/reply-statuses/{key}で行います。独自の段階を削除するにはDELETE /api/v1/reply-statuses/{key}を使います。その段階の会話は中立に戻ります。

すぐに通知を受け取る

reply.receivedのWebhookは相手が返信したときに、reply.positiveのWebhookは返信に関心ありまたは商談の依頼のラベルが付いたときに、reply.label_changedのWebhookは誰かがラベルを付けたり変更したりするたびに、サーバーを呼び出します。次の確認を待つ必要はありません。

ターミナルから

Shell
npx argorant inbox list --folder replies
npx argorant inbox read <thread-id>
npx argorant inbox reply <thread-id> --body "Thursday works."
npx argorant inbox classify <thread-id> meeting_booked

このページの内容