답장에 응답하기
모든 캠페인의 모든 답장을 받은편지함 하나에서 봅니다. 같은 스레드에서 답하고, 전달하고, 답장을 관심 있음, 미팅 예약됨 또는 직접 만든 파이프라인 단계로 표시하세요.
새 답장 보기
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입니다.
바뀐 것만 읽기
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는 건너뛰세요. 행은 거기에 적힌 시각보다 조금 늦게 저장될 수 있어서, 지난번이 끝난 지점에서 정확히 시작하는 구간은 그 행을 놓칠 수 있습니다. 웹훅을 쓰면 이런 처리가 전혀 필요 없습니다.
대화 읽기
curl "https://app.argorant.com/api/v1/inbox/$THREAD" -H "Authorization: Bearer $ARGORANT_API_KEY"$THREAD는 목록에 있는 id입니다. 전체 본문과 스레드 전체가 오래된 순으로 옵니다. 내가 보낸 이메일, 상대의 답장, 내 답장과 전달 내역이 모두 들어 있습니다.
같은 스레드에서 답하기
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가 있으면 재시도해도 두 번 발송되지 않습니다.
동료에게 전달하기
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분 안에 대화에 전달 여부가 표시됩니다.
표시하고 파이프라인 관리하기
모든 워크스페이스에는 기본 라벨 다섯 개가 있습니다. positive(관심 있음으로 표시), meeting_request, out_of_office, unsubscribe, neutral(기타로 표시)입니다. not_interested, question, referral, wrong_person, meeting_booked는 켤 수 있습니다. 직접 단계를 추가하세요.
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}로 삭제할 수 있으며, 그 단계의 대화는 neutral로 돌아갑니다.
바로 알림 받기
reply.received 웹훅은 상대가 답장하면 서버를 호출하고, reply.positive는 답장에 관심 있음 또는 미팅 요청 라벨이 붙으면, reply.label_changed는 누군가 라벨을 붙이거나 바꿀 때마다 호출합니다. 그래서 다음 확인 때까지 기다릴 필요가 없습니다.
터미널에서
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