ArgorantDocs

캠페인 처음부터 끝까지

캠페인을 만들고, 이메일을 쓰고, 리스트를 추가하고, 메일함을 고른 뒤 시작합니다. 각 단계는 호출 한 번이며, 시작하기 전에는 아무것도 발송되지 않습니다.

launch를 호출하기 전에는 아무것도 발송되지 않습니다. 같은 단계가 명령줄 명령과 MCP 도구로도 있으므로, 에이전트가 전체 흐름을 실행하고 시작 전에 사용자에게 물어볼 수 있습니다. 호출할 때마다 Idempotency-Key 헤더를 보내면 재시도해도 같은 작업이 두 번 실행되지 않습니다.

메일함이 연결되어 있는지 확인하기

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

아직 메일함이 없나요? Google Workspace는 한 단계로(가이드), Microsoft 365는 앱에서, 다른 서비스 제공업체의 메일함은 서버 설정으로(가이드) 연결하세요.

설정과 함께 캠페인 만들기

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "name": "Q4 CFO outreach",
    "daily_limit": 40, "per_mailbox_daily_limit": 20,
    "timezone": "Europe/Berlin", "timezone_mode": "fixed",
    "window_start": "08:00", "window_end": "17:00", "skip_weekends": true,
    "gap_minutes_min": 60, "gap_minutes_max": 120,
    "planned_start_date": "2026-10-01", "tags": ["q4"]
  }'

필수 항목은 name뿐이며, 모든 설정은 나중에 PATCH /api/v1/campaigns/{id}로 바꿀 수 있습니다. timezone_mode: "lead"는 각 인물의 현지 시간에 맞춰 발송합니다. 캠페인은 받은편지함에 가장 잘 도달하는 일반 텍스트로 발송됩니다. include_unsubscribe를 true로 설정하지 않는 한 수신 거부 문구는 없습니다.

시퀀스 쓰기

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/emails" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"emails":[
    {"subject":"Quick question, {{first_name}}","body":"Hi {{first_name}},\n\nsaw {{company}} is hiring in finance. Worth a 10 minute call?\n\nBest"},
    {"body":"Bumping this up in case it got buried.","delay_days":3,"same_thread":true}
  ]}'

첫 이메일에는 제목이 필요합니다. 후속 메일은 기본적으로 같은 스레드에 이어지며, 이전 메일 후 delay_days만큼 기다립니다. {{first_name}}, {{last_name}}, {{company}}, {{company_normalized}}(사람들이 실제로 부르는 이름), {{title}}, 그리고 {{plan}}처럼 인물과 함께 보낸 모든 열을 쓸 수 있습니다. {a|b}라고 쓰면 인물마다 표현이 달라집니다. 다른 버전을 쓰려면 이메일에 variants를 추가하세요. 버전은 번갈아 발송됩니다. 인물마다 들어가는 맞춤 문장은 PUT /api/v1/campaigns/{id}/personalization으로 설정합니다. 자세한 내용은 200명을 찾아 이메일 보내기를 참고하세요.

리스트 등록하기

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/leads" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"list_id": 1240}'
# {"input_rows": 1240, "inserted": 1188, "duplicates_skipped": 12, "skipped_not_valid": 40, "queued_for_verification": 0}

또는 email, first_name, last_name, company, title과 원하는 열을 담은 직접 만든 rows를 보내세요. 모든 주소는 추가되기 전에 검증됩니다. 리스트에 확인할 수 없는 주소가 있으면 첫 응답에서 어느 주소를 넣을지 묻습니다(needs_choice). "grades": ["valid"](권장) 또는 ["valid", "catch_all"]로 다시 호출하세요. Argorant 데이터의 인물은 처음 추가할 때 1명당 1크레딧이 들고, 직접 보낸 행은 무료입니다. 개인 주소(무료 메일, 가정용 인터넷)도 다른 주소처럼 추가됩니다. 업무용 이메일만 넣으려면 "exclude_private_emails": true를 보내세요.

발신자 연결하기

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/senders" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"all_connected": true}'

또는 특정 emails를 지정하세요. 이메일은 메일함들에 나뉘어 발송되며, 각 메일함은 자기 일일 한도 안에서 보냅니다.

시작하기

Shell
curl "https://app.argorant.com/api/v1/campaigns/$ID" -H "Authorization: Bearer $ARGORANT_API_KEY" | jq .launch_blockers
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/launch" -H "Authorization: Bearer $ARGORANT_API_KEY"

캠페인을 시작할 수 있으면 launch_blockers가 비어 있습니다. 시작하기 전에 POST /api/v1/campaigns/{id}/test-email을 호출하면 샘플 연락처로 채운 테스트 이메일 한 통이 나에게 발송됩니다. 사용자가 승인한 뒤에만 시작하세요. pause는 캠페인을 멈춰 두고, stop은 끝내며, DELETE는 실행 중이 아닌 캠페인을 삭제합니다.

실행 상황 보기

GET /api/v1/campaigns/{id}/analytics?days=30은 일별 수치(발송, 답장, 긍정 답장, 반송, 수신 거부)를 합계와 비율과 함께 보여 줍니다. GET /api/v1/campaigns/{id}에는 실시간 집계가 있습니다. GET /api/v1/campaigns/{id}/leads?status=replied는 답한 사람을 보여 주고, GET /api/v1/campaigns/{id}/replies는 그들의 메시지를 보여 줍니다. 모든 캠페인의 답장은 받은편지함을 쓰세요. GET /api/v1/campaigns/{id}/senders는 캠페인을 발송하는 메일함과 그 상태를 보여 줍니다.

실행 중인 캠페인의 인물 바꾸기

POST /api/v1/campaigns/{id}/leads/remove는 상태, 답장 여부, 반송 여부, 이메일 도메인, 태그, 주소, 저장된 리스트로 고른 많은 인물을 한 번에 빼냅니다. 먼저 "preview": true를 보내 몇 명이 빠지는지 확인하세요. 이미 이메일을 받은 인물은 "include_contacted": true를 보내지 않는 한 남습니다. 대량 추가나 삭제는 백그라운드에서 실행됩니다. 응답은 작업과 함께 202로 오며, GET /api/v1/campaigns/{id}/lead-jobs/{job_id}에서 진행 상황을 확인할 수 있습니다.

많은 인물의 맞춤 문장은 파일 하나로 넣습니다. POST /api/v1/campaigns/{id}/leads/custom-fields/import는 최대 200,000행(50 MB)의 CSV, JSON, NDJSON 파일을 받습니다. 이미 문장이 있는 인물의 문장은 유지되며, 해당 행과 함께 표시됩니다. 고치려면 ?overwrite=true로 업로드하세요. clear 열(JSON에서는 null)은 문장을 지우고, 그 인물은 다시 대체 문장을 받습니다. 바뀐 문장은 모두 이전 문장과 새 문장이 함께 응답에 돌아옵니다.

폴더

GET /api/v1/folders는 폴더를 보여 주고, POST /api/v1/folders는 폴더를 만들며, PATCH /api/v1/folders/{id}는 이름을 바꿉니다. POST /api/v1/campaigns/{id}/folder에 folder_id를 보내면 캠페인이 폴더에 들어가고, null을 보내면 다시 빠집니다. 폴더는 캠페인을 정리할 뿐이며 발송에는 영향을 주지 않습니다.

메일함과 차단 리스트

GET /api/v1/inboxes는 도메인, 상태, 태그, 서비스 제공업체로 필터링해 메일함을 보여 줍니다. PATCH /api/v1/inboxes/{email}은 메일함의 일일 한도, 워밍업, 발송 허용 여부, 이름, 시간대를 설정하고, DELETE는 연결을 해제합니다. POST /api/v1/inboxes/update는 도메인, 태그, 상태, 주소로 고른 많은 메일함에 같은 변경을 한 번에 적용합니다. 기본적으로 미리보기만 하며, "preview": false를 보내기 전에는 아무것도 바꾸지 않습니다. POST /api/v1/blocklist에 주소나 도메인을 보내면 워크스페이스에서 그곳으로 가는 모든 이메일이 중지되고, DELETE /api/v1/blocklist/{id}는 이를 다시 해제합니다.

터미널에서 같은 단계 실행하기

Shell
argorant campaigns create --name "Q4 CFO outreach" --daily-limit 40 --window 08:00-17:00 --timezone Europe/Berlin
argorant campaigns emails set "Q4 CFO" --step 1 --subject "Quick question, {{first_name}}" --body-file step1.txt
argorant campaigns emails set "Q4 CFO" --step 2 --body "Bumping this up." --delay-days 3
argorant campaigns leads add "Q4 CFO" --list 1240
argorant campaigns senders set "Q4 CFO" --all
argorant campaigns test "Q4 CFO" --step 1
argorant campaigns launch "Q4 CFO"
argorant campaigns leads remove "Q4 CFO" --not-replied --domains competitor.com --preview
argorant campaigns folders create --name "Q4"
argorant campaigns move "Q4 CFO" --folder Q4
argorant inboxes update --domains northgate-advisory.com --daily-limit 30

이 페이지의 내용