ArgorantDocs

Conecte qualquer caixa de e-mail (SMTP e IMAP)

Conecte caixas de e-mail da Zoho, Fastmail, Yahoo, iCloud, IONOS, da sua hospedagem ou de qualquer outro provedor com as configurações de servidor deles. Teste o login primeiro, conecte uma por vez ou várias a partir de um arquivo CSV.

Caixas de e-mail do Google e da Microsoft se conectam com o próprio login (veja Conecte um Google Workspace, e o Microsoft 365 no app, em Caixas de e-mail). Qualquer outro provedor se conecta com dois conjuntos de configurações de servidor. O servidor de envio (SMTP) permite que as campanhas enviem a partir da caixa de e-mail. O servidor de leitura de respostas (IMAP) traz as respostas para a sua caixa de entrada no Argorant, assim uma resposta interrompe a sequência para aquela pessoa.

O Argorant faz login nos dois antes de salvar qualquer coisa. Uma caixa de e-mail só é conectada quando o envio e a leitura de respostas funcionam. A senha é guardada criptografada e nunca mais é exibida, nem no app, nem na API, na CLI ou no conector.

No app

Abra Caixas de e-mail, clique em Adicionar contas, depois em Conectar existente e Qualquer outro provedor.

  1. Escolha o seu provedor na lista. Ele preenche para você os nomes dos servidores, as portas e a segurança. Escolha Outro provedor quando o seu não estiver na lista e copie as configurações das páginas de ajuda do seu provedor.
  2. Informe o endereço de e-mail, o nome de remetente que as pessoas veem e a senha.
  3. Clique em Testar conexão. Você vê uma linha para o envio e uma para a leitura de respostas, cada uma com o que funcionou ou o que corrigir.
  4. Clique em Conectar caixa de e-mail. Ela aparece na lista na hora, com o limite diário e a saúde dela.

Para conectar muitas caixas de e-mail de uma vez, mude para Várias a partir de um arquivo CSV, envie o arquivo e confira o resultado de cada linha.

Senhas de app

Muitos provedores não aceitam a sua senha normal vinda de outros apps quando o login em duas etapas está ativado. Crie uma senha de app no provedor e use-a no lugar.

ProvedorOnde criar uma senha de app
Zoho MailMy Account, Security, App Passwords. Ative também o acesso IMAP nas configurações do Zoho Mail.
FastmailSettings, Privacy and Security, Manage app passwords. Sempre necessária.
Yahoo MailAccount Info, Account Security, Generate app password. Sempre necessária.
iCloud Mailaccount.apple.com, Sign-In and Security, App-Specific Passwords. Sempre necessária. O nome de usuário é o seu endereço completo do iCloud.
Outlook.com e HotmailA Microsoft costuma recusar senhas de outros apps para essas contas. Tente uma senha de app; se o teste disser que a senha está errada, conecte com o login da Microsoft.

Configurações dos provedores

Escolha um provedor e estes dados são preenchidos. A lista no app e em GET /api/v1/inboxes/smtp/presets é sempre a atual.

PresetProvedorServidor de envioServidor de leitura de respostas
zohoZoho Mail (domínio da empresa)smtppro.zoho.com, 587, STARTTLSimappro.zoho.com, 993, SSL
zoho_euZoho Mail (data center na UE)smtppro.zoho.eu, 587, STARTTLSimappro.zoho.eu, 993, SSL
zoho_personalZoho Mail (pessoal ou plano grátis)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 (EUA)smtp.ionos.com, 587, STARTTLSimap.ionos.com, 993, SSL
ionos_deIONOS (Alemanha)smtp.ionos.de, 587, STARTTLSimap.ionos.de, 993, SSL
ionos_ukIONOS (Reino Unido)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 ou Hotmailsmtp-mail.outlook.com, 587, STARTTLSoutlook.office365.com, 993, SSL
otherOutro provedorvocê informavocê informa

Use a porta 587 para o envio. Se você informar 465, o Argorant tenta a 587 para você e salva a 587 quando ela funciona, e o resultado do teste passa a mostrar a porta 587 e STARTTLS para o envio. O nome de usuário dos dois servidores é o endereço de e-mail, a menos que você defina outro. A leitura de respostas usa o mesmo nome de usuário e a mesma senha do envio, a menos que você defina outros. Sem preset, a segurança segue a porta: STARTTLS na 587 e na 143, e SSL na 993.

O que significa o resultado do teste

ResultadoO que significaO que fazer
signed_inO servidor aceitou o login.Nada.
wrong_passwordO servidor recusou o nome de usuário ou a senha.Confira os dois. Use uma senha de app se o provedor pedir uma, e confira se o acesso IMAP está ativado no provedor.
not_reachableO servidor não respondeu, ou não existe servidor com esse nome.Confira o nome do servidor e a porta.
security_mismatchA conexão segura não funcionou.Tente a outra opção de segurança. Para o envio, use a porta 587 com STARTTLS.
not_allowedO nome do servidor aponta para uma rede privada.Use o nome de servidor público do seu provedor.
failedOutra coisa deu errado.Confira as configurações e tente de novo, ou fale com o suporte.

Várias caixas de e-mail a partir de um arquivo CSV

Uma linha por caixa de e-mail. Cada linha precisa de email, smtp_password (ou password) e de um preset ou de smtp_host, smtp_port e imap_host. Colunas vazias recebem os valores padrão acima, e 25 e-mails por dia.

ColunaExemplo
emailanna@yourcompany.com
sender_nameAnna Weber
presetzoho
smtp_host, smtp_port, smtp_securitymail.yourcompany.com, 587, starttls
smtp_username, smtp_passwordanna@yourcompany.com, a sua senha de app
imap_host, imap_port, imap_securitymail.yourcompany.com, 993, ssl
imap_username, imap_passwordsó quando forem diferentes dos de envio
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

A terceira linha não tem preset, então também precisa de smtp_host, smtp_port e imap_host preenchidos, senão ela volta como uma linha a corrigir. Cada linha recebe o próprio resultado. As linhas que conectaram continuam conectadas quando outras falham, então corrija as linhas com falha e envie só essas de novo.

Reconecte depois de trocar a senha

Quando o provedor recusa a senha, a caixa de e-mail mostra Entrar novamente na lista de Caixas de e-mail. Se a leitura de respostas for recusada três vezes seguidas, a caixa é marcada como desconectada e continua assim até você reconectá-la.

Para reconectar, conecte o mesmo endereço de novo com a nova senha. No app, clique em Reconectar na caixa de e-mail, informe a nova senha e conecte; as outras configurações são mantidas. Com a API, a CLI ou o seu assistente de IA, conecte o mesmo endereço de novo, e isso substitui as configurações e a senha salvas dessa caixa de e-mail.

Pela 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"}]}'

Um login recusado ao conectar responde 422 com o código sign_in_failed e o resultado do teste em error.details.test. A rota em lote responde 200 com um resultado por linha. Um teste grátis conecta até 2 caixas de e-mail. Você pode testar 30 vezes e conectar 30 vezes por hora, e conectar até 500 caixas de e-mail por hora pela rota em lote.

Pelo terminal

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

A CLI nunca recebe a senha na linha de comando. Ela pede a senha, ou a lê de uma variável de ambiente que você indica com --password-env NAME, ou de ARGORANT_MAILBOX_PASSWORD. Veja CLI.

Pelo seu assistente de IA

Com o conector do Argorant, peça em palavras simples, por exemplo "conecte anna@yourcompany.com, é uma caixa de e-mail da Zoho". O assistente usa argorant_test_smtp_mailbox para verificar o login e argorant_connect_smtp_mailbox para conectar uma caixa de e-mail ou até 25. Veja Ferramentas.

Depois de conectar

A caixa de e-mail envia como qualquer outra. Defina o limite diário e o aquecimento dela em Caixas de e-mail ou com PATCH /api/v1/inboxes/{email}, e escolha-a como remetente em qualquer campanha. Os follow-ups saem na mesma conversa, as respostas chegam à sua caixa de entrada no Argorant, e você as responde de lá, na mesma conversa. Respostas que caem na pasta de lixo eletrônico ou de spam também são lidas, mas só as de pessoas para quem você enviou e-mail, então o spam é ignorado.

Nesta página