ArgorantDocs

모든 메일함 연결하기(SMTP와 IMAP)

Zoho, Fastmail, Yahoo, iCloud, IONOS, 웹 호스팅 등 어떤 서비스 제공업체의 메일함이든 서버 설정으로 연결합니다. 먼저 로그인을 테스트하고, 하나씩 연결하거나 CSV 파일로 여러 개를 연결하세요.

Google과 Microsoft 메일함은 각자의 로그인으로 연결합니다(Google Workspace 연결하기를 참고하고, Microsoft 365는 앱의 메일함에서 연결하세요). 그 밖의 모든 서비스 제공업체는 두 가지 서버 설정으로 연결합니다. 발송 서버(SMTP)는 캠페인이 그 메일함에서 발송하게 합니다. 답장을 읽는 서버(IMAP)는 답장을 Argorant의 받은편지함으로 가져오므로, 답장이 오면 그 사람에게 가는 시퀀스가 멈춥니다.

Argorant는 아무것도 저장하기 전에 두 서버에 모두 로그인합니다. 발송과 답장 읽기가 모두 작동할 때만 메일함이 연결됩니다. 비밀번호는 암호화되어 저장되며, 앱, API, CLI, 커넥터 어디에서도 다시 표시되지 않습니다.

앱에서

메일함을 열고 계정 추가를 클릭한 다음 기존 항목 연결과 기타 서비스 제공업체를 클릭하세요.

  1. 리스트에서 서비스 제공업체를 고르세요. 서버 이름, 포트, 보안 설정이 자동으로 채워집니다. 사용하는 업체가 리스트에 없으면 기타 서비스 제공업체를 고르고 업체의 도움말 페이지에서 설정을 복사하세요.
  2. 이메일 주소, 받는 사람에게 보이는 발신자 이름, 비밀번호를 입력하세요.
  3. 연결 테스트를 클릭하세요. 발송과 답장 읽기에 대해 각각 한 줄씩, 무엇이 작동했고 무엇을 고쳐야 하는지 표시됩니다.
  4. 메일함 연결을 클릭하세요. 메일함이 일일 한도와 상태와 함께 바로 리스트에 나타납니다.

여러 메일함을 한 번에 연결하려면 CSV 파일로 여러 개로 전환하고 파일을 업로드한 뒤 각 행의 결과를 확인하세요.

앱 비밀번호

많은 서비스 제공업체는 2단계 로그인이 켜져 있으면 다른 앱에서 쓰는 일반 비밀번호를 받지 않습니다. 업체에서 앱 비밀번호를 만들어 대신 쓰세요.

서비스 제공업체앱 비밀번호를 만드는 곳
Zoho MailMy Account, Security, App Passwords. Zoho Mail 설정에서 IMAP 액세스도 켜세요.
FastmailSettings, Privacy and Security, Manage app passwords. 항상 필요합니다.
Yahoo MailAccount Info, Account Security, Generate app password. 항상 필요합니다.
iCloud Mailaccount.apple.com, Sign-In and Security, App-Specific Passwords. 항상 필요합니다. 사용자 이름은 전체 iCloud 주소입니다.
Outlook.com과 HotmailMicrosoft는 이 서비스들에서 다른 앱의 비밀번호를 자주 거부합니다. 앱 비밀번호를 시도해 보고, 테스트에서 비밀번호가 틀렸다고 나오면 대신 Microsoft 로그인으로 연결하세요.

서비스 제공업체 설정

서비스 제공업체를 고르면 다음 값이 채워집니다. 앱의 리스트와 GET /api/v1/inboxes/smtp/presets가 항상 최신입니다.

프리셋서비스 제공업체발송 서버답장을 읽는 서버
zohoZoho Mail(비즈니스 도메인)smtppro.zoho.com, 587, STARTTLSimappro.zoho.com, 993, SSL
zoho_euZoho Mail(EU 데이터 센터)smtppro.zoho.eu, 587, STARTTLSimappro.zoho.eu, 993, SSL
zoho_personalZoho Mail(개인 또는 무료 플랜)smtp.zoho.com, 587, STARTTLSimap.zoho.com, 993, SSL
fastmailFastmailsmtp.fastmail.com, 587, STARTTLSimap.fastmail.com, 993, SSL
godaddyGoDaddy Professional Emailsmtpout.secureserver.net, 587, STARTTLSimap.secureserver.net, 993, SSL
titanTitan Emailsmtp.titan.email, 587, STARTTLSimap.titan.email, 993, SSL
hostingerHostinger Emailsmtp.hostinger.com, 587, STARTTLSimap.hostinger.com, 993, SSL
ionosIONOS(미국)smtp.ionos.com, 587, STARTTLSimap.ionos.com, 993, SSL
ionos_deIONOS(독일)smtp.ionos.de, 587, STARTTLSimap.ionos.de, 993, SSL
ionos_ukIONOS(영국)smtp.ionos.co.uk, 587, STARTTLSimap.ionos.co.uk, 993, SSL
namecheapNamecheap Private Emailmail.privateemail.com, 587, STARTTLSmail.privateemail.com, 993, SSL
yahooYahoo Mailsmtp.mail.yahoo.com, 587, STARTTLSimap.mail.yahoo.com, 993, SSL
icloudiCloud Mailsmtp.mail.me.com, 587, STARTTLSimap.mail.me.com, 993, SSL
outlookOutlook.com 또는 Hotmailsmtp-mail.outlook.com, 587, STARTTLSoutlook.office365.com, 993, SSL
other기타 서비스 제공업체직접 입력직접 입력

발송에는 587 포트를 쓰세요. 465를 입력하면 Argorant가 대신 587을 시도하고, 작동하면 587로 저장합니다. 이때 테스트 결과에는 발송용으로 587 포트와 STARTTLS가 표시됩니다. 두 서버의 사용자 이름은 따로 설정하지 않는 한 이메일 주소입니다. 답장 읽기는 따로 설정하지 않는 한 발송과 같은 사용자 이름과 비밀번호를 씁니다. 프리셋이 없으면 보안 설정은 포트를 따릅니다. 즉 587과 143은 STARTTLS, 993은 SSL입니다.

테스트 결과의 의미

결과의미할 일
signed_in서버가 로그인을 받아들였습니다.할 일은 없습니다.
wrong_password서버가 사용자 이름이나 비밀번호를 거부했습니다.둘 다 확인하세요. 업체가 앱 비밀번호를 요구하면 앱 비밀번호를 쓰고, 업체에서 IMAP 액세스가 켜져 있는지 확인하세요.
not_reachable서버가 응답하지 않았거나, 그 이름의 서버가 없습니다.서버 이름과 포트를 확인하세요.
security_mismatch보안 연결이 작동하지 않았습니다.다른 보안 설정을 시도하세요. 발송에는 587 포트와 STARTTLS를 쓰세요.
not_allowed서버 이름이 사설 네트워크를 가리킵니다.업체의 공개 서버 이름을 쓰세요.
failed그 밖의 문제가 생겼습니다.설정을 확인하고 다시 시도하거나 지원팀에 문의하세요.

CSV 파일로 여러 메일함 연결하기

메일함 하나당 한 행입니다. 각 행에는 email, smtp_password(또는 password), 그리고 preset 또는 smtp_host, smtp_port, imap_host가 필요합니다. 빈 열에는 위의 기본값과 하루 25통이 적용됩니다.

열예시
emailanna@yourcompany.com
sender_nameAnna Weber
presetzoho
smtp_host, smtp_port, smtp_securitymail.yourcompany.com, 587, starttls
smtp_username, smtp_passwordanna@yourcompany.com, 앱 비밀번호
imap_host, imap_port, imap_securitymail.yourcompany.com, 993, ssl
imap_username, imap_password발송과 다를 때만
daily_limit30
CSV
email,sender_name,preset,smtp_password
anna@yourcompany.com,Anna Weber,zoho,app-password-1
ben@yourcompany.com,Ben Hill,zoho,app-password-2
cara@othercompany.com,Cara Lane,,app-password-3

세 번째 행에는 프리셋이 없으므로 smtp_host, smtp_port, imap_host도 채워야 하며, 그렇지 않으면 고쳐야 할 행으로 돌아옵니다. 모든 행은 각자의 결과를 받습니다. 다른 행이 실패해도 연결된 행은 연결된 상태로 남으므로, 실패한 행만 고쳐서 다시 업로드하세요.

비밀번호 변경 후 다시 연결하기

서비스 제공업체가 비밀번호를 거부하면 메일함 리스트에서 해당 메일함에 Sign in again이 표시됩니다. 답장 읽기가 세 번 연속 거부되면 메일함은 연결 해제됨으로 표시되며, 다시 연결할 때까지 그 상태로 남습니다.

다시 연결하려면 같은 주소를 새 비밀번호로 다시 연결하세요. 앱에서는 메일함의 다시 연결을 클릭하고 새 비밀번호를 입력한 뒤 연결하세요. 다른 설정은 유지됩니다. API, CLI, AI 어시스턴트에서는 같은 주소를 다시 연결하면 그 메일함에 저장된 설정과 비밀번호가 바뀝니다.

API에서

Shell
# Test first: nothing is saved
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/test" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"email":"anna@yourcompany.com","preset":"zoho","smtp_password":"app-password"}'

# Connect one mailbox
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"email":"anna@yourcompany.com","display_name":"Anna Weber","preset":"zoho","smtp_password":"app-password"}'

# Connect up to 25 at once
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/bulk" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"mailboxes":[{"email":"anna@yourcompany.com","preset":"zoho","smtp_password":"app-password-1"},{"email":"ben@yourcompany.com","preset":"zoho","smtp_password":"app-password-2"}]}'

연결할 때 로그인이 거부되면 422와 코드 sign_in_failed로 응답하며, 테스트 결과는 error.details.test에 들어 있습니다. 대량 연결 경로는 행마다 결과를 담아 200으로 응답합니다. 무료 체험에서는 메일함을 최대 2개까지 연결할 수 있습니다. 테스트와 연결은 각각 시간당 30회까지, 대량 연결 경로로는 시간당 최대 500개 메일함까지 연결할 수 있습니다.

터미널에서

Shell
argorant inboxes presets
argorant inboxes test-smtp --email anna@yourcompany.com --preset zoho
argorant inboxes connect-smtp --email anna@yourcompany.com --preset zoho --name "Anna Weber"
argorant inboxes connect-smtp --csv mailboxes.csv

CLI는 명령줄에서 비밀번호를 받지 않습니다. 비밀번호를 물어보거나, --password-env NAME으로 지정한 환경 변수 또는 ARGORANT_MAILBOX_PASSWORD에서 읽습니다. CLI를 참고하세요.

AI 어시스턴트에서

Argorant 커넥터가 있으면 "anna@yourcompany.com을 연결해 줘, Zoho 메일함이야"처럼 평소 말로 요청하세요. 어시스턴트는 argorant_test_smtp_mailbox로 로그인을 확인하고, argorant_connect_smtp_mailbox로 메일함 하나 또는 최대 25개를 연결합니다. 도구를 참고하세요.

연결한 후

이 메일함도 다른 메일함과 똑같이 발송합니다. 메일함 화면이나 PATCH /api/v1/inboxes/{email}로 일일 한도와 워밍업을 설정하고, 어떤 캠페인에서든 발신자로 고르세요. 후속 메일은 같은 스레드로 발송되고, 답장은 Argorant의 받은편지함으로 들어오며, 거기서 같은 스레드로 답하면 됩니다. 정크 메일이나 스팸 폴더로 들어간 답장도 읽지만, 내가 이메일을 보낸 사람의 답장만 읽으므로 스팸은 무시됩니다.

이 페이지의 내용