ArgorantDocs

Campagne dall'inizio alla fine

Crea la campagna, scrivi le email, aggiungi una lista, scegli le caselle e avvia. Ogni passaggio è una chiamata, e nulla parte prima dell'avvio.

Nulla parte finché non chiami launch. Gli stessi passaggi esistono come comandi da riga di comando e come tool MCP, così un agente può eseguire l'intero flusso e chiedere all'utente prima dell'avvio. Invia un header Idempotency-Key con ogni chiamata, così un nuovo tentativo non fa mai il lavoro due volte.

Controlla che una casella sia collegata

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

Nessuna casella ancora? Collega un Google Workspace in un solo passaggio (guida), Microsoft 365 nell'app, oppure una casella di qualsiasi altro provider con le sue impostazioni del server (guida).

Crea la campagna con le sue impostazioni

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

Solo name è obbligatorio, e ogni impostazione si può cambiare in seguito con PATCH /api/v1/campaigns/{id}. timezone_mode: "lead" invia nell'ora locale di ogni persona. Le campagne inviano testo semplice, che arriva meglio nella posta in arrivo. Non c'è una riga di disiscrizione, a meno che tu non imposti include_unsubscribe su true.

Scrivi la sequenza

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

La prima email richiede un oggetto. I follow-up restano nello stesso thread per impostazione predefinita e aspettano delay_days dopo quella precedente. Puoi usare {{first_name}}, {{last_name}}, {{company}}, {{company_normalized}} (il nome che le persone usano a voce), {{title}} e qualsiasi colonna che hai inviato con le persone, come {{plan}}. Scrivi {a|b} per variare una frase da persona a persona. Aggiungi variants a un'email per avere altre versioni; vengono inviate a turno. Una riga personale per ogni persona si imposta con PUT /api/v1/campaigns/{id}/personalization; vedi Trova 200 persone e scrivi loro.

Iscrivi la lista

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}

Oppure invia le tue rows con email, first_name, last_name, company, title e qualsiasi colonna tua. Ogni indirizzo viene controllato prima di entrare. Quando una lista contiene indirizzi che non si possono confermare, la prima risposta chiede quali prendere (needs_choice); chiama di nuovo con "grades": ["valid"] (consigliato) o ["valid", "catch_all"]. Le persone dai dati di Argorant costano 1 credito ciascuna la prima volta; le tue righe sono gratuite. Gli indirizzi privati (email gratuite, connessioni internet di casa) vengono aggiunti come gli altri; invia "exclude_private_emails": true per avere solo email aziendali.

Assegna i mittenti

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}'

Oppure indica emails specifiche. Le email vengono distribuite tra le caselle, ognuna entro il proprio limite giornaliero.

Avvia

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 è vuoto quando la campagna può partire. Prima dell'avvio, POST /api/v1/campaigns/{id}/test-email ti invia un test di un'email, compilato con un contatto di esempio. Avvia solo dopo che l'utente ha detto sì. pause la mette in attesa, stop la termina, e DELETE rimuove una campagna che non è in corso.

Seguila mentre va

GET /api/v1/campaigns/{id}/analytics?days=30 restituisce i numeri giornalieri (inviate, risposte, risposte positive, rimbalzi, disiscrizioni) con totali e tassi. GET /api/v1/campaigns/{id} ha i conteggi in tempo reale. GET /api/v1/campaigns/{id}/leads?status=replied elenca chi ha risposto, e GET /api/v1/campaigns/{id}/replies restituisce i loro messaggi. Per le risposte di tutte le campagne usa la posta in arrivo. GET /api/v1/campaigns/{id}/senders elenca le caselle che la inviano, con il loro stato.

Cambia le persone in una campagna in corso

POST /api/v1/campaigns/{id}/leads/remove toglie molte persone in una volta, scelte per stato, risposta, rimbalzo, dominio email, tag, indirizzi o una lista salvata. Invia prima "preview": true per vedere quante ne uscirebbero. Le persone che hanno già ricevuto un'email restano, a meno che tu non invii "include_contacted": true. Un'aggiunta o una rimozione grande gira in background: la risposta è 202 con un job, e GET /api/v1/campaigns/{id}/lead-jobs/{job_id} indica a che punto è.

Le righe personali per molte persone vanno in un solo file: POST /api/v1/campaigns/{id}/leads/custom-fields/import accetta un file CSV, JSON o NDJSON con fino a 200.000 righe (50 MB). Le righe personali che le persone hanno già vengono mantenute ed elencate con la loro riga del file. Per correggerle, carica con ?overwrite=true; una colonna clear (o null in JSON) toglie una riga personale, e la persona riceve di nuovo il testo di riserva. Ogni riga personale sostituita torna nella risposta, vecchia e nuova.

Cartelle

GET /api/v1/folders elenca le tue cartelle, POST /api/v1/folders ne crea una e PATCH /api/v1/folders/{id} la rinomina. POST /api/v1/campaigns/{id}/folder con un folder_id archivia una campagna in una cartella, e null la toglie di nuovo. Le cartelle servono solo a ordinare le campagne; l'invio non cambia.

Caselle e lista di esclusione

GET /api/v1/inboxes elenca le tue caselle con filtri per dominio, stato, tag e provider. PATCH /api/v1/inboxes/{email} imposta il limite giornaliero di una casella, il warm-up, se può inviare, il suo nome o il suo fuso orario, e DELETE la scollega. POST /api/v1/inboxes/update fa la stessa modifica su molte caselle in una volta, scelte per dominio, tag, stato o indirizzo; per impostazione predefinita mostra un'anteprima e non cambia nulla finché non invii "preview": false. POST /api/v1/blocklist con un indirizzo o un dominio blocca ogni email verso di esso nel tuo workspace; DELETE /api/v1/blocklist/{id} toglie di nuovo il blocco.

Gli stessi passaggi nel terminale

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

In questa pagina