ArgorantDocs

Trova 200 persone e scrivi loro

Da chi è il tuo cliente a una campagna in corso: restringi a circa 200 persone, scrivi le email con una riga personale, scegli le caselle e avvia dopo un sì.

Questa guida richiede circa 15 minuti. La ricerca è gratuita. Aggiungere le persone costa 1 credito per ogni persona la cui email supera il controllo, quindi circa 200 crediti. Le email in sé sono incluse nel tuo piano.

Ti servono una chiave API, un piano o abbastanza crediti, e almeno una casella collegata. Controlla le caselle con GET /api/v1/inboxes. Nessuna casella ancora? Collega un Google Workspace in un solo passaggio, collega Microsoft 365 nell'app, collega una casella di qualsiasi altro provider, oppure ordina nuove caselle con POST /api/v1/inboxes/quote.

Indica a chi vendi

Scegli le qualifiche, il settore, il paese e la dimensione dell'azienda. Usa le liste di parole gratuite per ottenere i nomi esatti:

Shell
curl -G "https://app.argorant.com/api/v1/lookups/industries" -H "Authorization: Bearer $ARGORANT_API_KEY" --data-urlencode "q=logistics"

Restringi il conteggio a circa 200

Shell
curl -G "https://app.argorant.com/api/v1/people/count" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=Head of Operations,COO" --data-urlencode "industries=Truck Transportation" \
  --data-urlencode "country=Netherlands" --data-urlencode "employee_range=51-200"
# {"count": 214}

Troppe? Aggiungi una città, un livello di anzianità o una dimensione aziendale più piccola. Troppo poche? Aggiungi altre qualifiche o altri paesi. Il conteggio è gratuito, quindi prova tutte le volte che vuoi.

Guarda una pagina di risultati

Shell
curl -G "https://app.argorant.com/api/v1/people/search" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  --data-urlencode "title=Head of Operations,COO" --data-urlencode "industries=Truck Transportation" \
  --data-urlencode "country=Netherlands" --data-urlencode "employee_range=51-200"

Se i ruoli e le aziende ti sembrano giusti, vai avanti. Altrimenti cambia i filtri e conta di nuovo.

Salvali come lista

Shell
curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: ops-nl-list" -H "Content-Type: application/json" \
  -d '{"name":"Ops leaders NL trucking","filters":{"title":"Head of Operations,COO","industries":"Truck Transportation","country":"Netherlands","employee_range":"51-200"}}'

Annota il list_id. La lista si riempie da sola in pochi secondi.

Crea la campagna

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: ops-nl-campaign" -H "Content-Type: application/json" \
  -d '{"name":"NL trucking ops Q4","daily_limit":40,"timezone":"Europe/Amsterdam","window_start":"08:30","window_end":"16:30"}'

È una bozza. Le nuove campagne inviano testo semplice nei giorni feriali e non hanno una riga di disiscrizione, a meno che tu non imposti include_unsubscribe su true.

Scrivi le email

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/emails" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: ops-nl-emails-1" -H "Content-Type: application/json" \
  -d '{"emails":[
    {"subject":"Planning at {{company_normalized}}","body":"Hi {{first_name}},\n\n{{custom_opener}}\n\nWe help trucking firms cut empty miles. Worth a short call next week?\n\nBest, Maria"},
    {"body":"Hi {{first_name}}, just bringing this back up. Happy to send a two-minute video instead.","delay_days":3}
  ]}'

{{company_normalized}} è il nome dell'azienda che le persone usano a voce. {{custom_opener}} è una riga personale per ogni persona, che imposti nel passaggio successivo. Il testo rimasto, come [link], torna in warnings, e la campagna non parte finché non viene tolto.

Aggiungi una riga personale (facoltativo)

Imposta la riga una sola volta, con un testo di riserva che vada bene per chiunque:

Shell
curl -X PUT "https://app.argorant.com/api/v1/campaigns/$ID/personalization" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"variables":[{"name":"opener","instruction":"One sentence about something recent at their company.","fallback":"Hope the busy season treats you well."}]}'

Poi GET .../personalization elenca le persone che hanno ancora il testo di riserva, con informazioni sulla loro azienda, e PATCH .../leads/custom-fields salva le righe scritte da te o dal tuo agente, fino a 5.000 per chiamata. Una riga che qualcuno ha già resta, a meno che tu non invii "overwrite": true, così una seconda esecuzione non sostituisce mai righe per errore. Un'istruzione può avere fino a 4.000 caratteri e ogni riga da 20 a 300 (max_length, 150 per impostazione predefinita); vedi Scrivi le righe personali per tutti i limiti.

Aggiungi le persone

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/leads" -H "Authorization: Bearer $ARGORANT_API_KEY" \
  -H "Idempotency-Key: ops-nl-leads" -H "Content-Type: application/json" \
  -d '{"list_id": 312}'

La prima risposta può essere una domanda (needs_choice: true): quanti indirizzi sono confermati e quanti si trovano su domini che accettano qualsiasi indirizzo. Chiedi all'utente, poi chiama di nuovo con "grades": ["valid"] (consigliato) o ["valid", "catch_all"]. Ogni nuova persona costa 1 credito. Le persone la cui email non supera il controllo non vengono mai aggiunte né addebitate.

Scegli le caselle

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

Avvia dopo un sì

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

Mostra all'utente le email, il numero di persone e le caselle. launch_blockers deve essere vuoto. Poi, solo dopo il suo sì:

Shell
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/launch" -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: ops-nl-launch"

Le risposte arrivano nella posta in arrivo. Rispondi alle risposte mostra come leggerle, rispondere nello stesso thread e seguire la tua pipeline. GET /api/v1/campaigns/$ID/analytics restituisce i numeri giornalieri.

In questa pagina