ArgorantDocs

Rispondi alle risposte

Ogni risposta di ogni campagna in un'unica posta in arrivo. Rispondi nella stessa conversazione, inoltra e segna le risposte come interessato, appuntamento fissato o una fase della tua pipeline.

Vedi le nuove risposte

Shell
curl "https://app.argorant.com/api/v1/inbox?folder=replies&limit=25" -H "Authorization: Bearer $ARGORANT_API_KEY"

folder è all, replies, interested, not_interested, out_of_office, bounces o unsubscribes. Restringi ancora con campaign_id, classification o una parola di ricerca in q. Le conversazioni arrivano con l'attività più recente in cima, comprese le tue risposte. Le liste mostrano i primi 300 caratteri dell'ultimo messaggio. Scorri le pagine con cursor e next_cursor finché has_more è false; ogni conversazione è raggiungibile. Una conversazione a cui nessuno ha ancora dato un'etichetta ha la classificazione unknown.

Leggi solo ciò che è cambiato

Shell
curl "https://app.argorant.com/api/v1/inbox?received_after=2026-11-10T09:00:00Z&limit=100" -H "Authorization: Bearer $ARGORANT_API_KEY"

received_after tiene le conversazioni il cui messaggio più recente della persona è arrivato dopo quel momento. updated_after conta anche le tue risposte. Ogni conversazione ha lead_id, updated_at e last_received_at. Se invece leggi l'API a intervalli regolari, fai partire ogni lettura qualche minuto prima della fine di quella precedente e salta gli id che hai già. Una riga può essere salvata un attimo dopo l'ora che riporta, quindi una finestra che parte esattamente dove è finita l'ultima può perderla. Con i webhook non serve niente di tutto questo.

Leggi una conversazione

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

$THREAD è l'id preso dalla lista. Ricevi il testo completo e tutta la conversazione, dal messaggio più vecchio: le tue email, le loro risposte, le tue risposte e gli inoltri.

Rispondi nella stessa conversazione

Shell
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/reply" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: reply-jane-1" \
  -H "Content-Type: application/json" \
  -d '{"body":"Thursday 10:00 works. I will send an invite."}'

La risposta parte subito, nella stessa conversazione, dalla casella che ha ricevuto la risposta. Un agente dovrebbe mostrare il testo all'utente e aspettare un sì. L'Idempotency-Key fa sì che un nuovo tentativo non la invii mai due volte.

Inoltrala a un collega

Shell
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/forward" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: fwd-jane-1" \
  -H "Content-Type: application/json" \
  -d '{"to":["sales-lead@yourcompany.com"],"note":"Hot lead, please call her this week."}'

L'inoltro porta con sé la cronologia e gli allegati. Entro tre minuti la conversazione mostra se è stato consegnato.

Etichettala e segui la tua pipeline

Ogni workspace ha cinque etichette standard: positive (mostrata come Interessato), meeting_request, out_of_office, unsubscribe e neutral (mostrata come Altro). Puoi attivare not_interested, question, referral, wrong_person e meeting_booked. Aggiungi le tue fasi:

Shell
curl -X POST "https://app.argorant.com/api/v1/reply-statuses" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"label":"Proposal sent","color":"purple"}'

curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/classify" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"classification":"proposal_sent"}'

interested viene inteso come positive. Rinomina una fase, cambiane il colore, nascondila o mostrala con PATCH /api/v1/reply-statuses/{key}. Elimina una delle tue fasi con DELETE /api/v1/reply-statuses/{key}; le sue conversazioni tornano a neutral.

Ricevi un avviso subito

Un webhook per reply.received chiama il tuo server quando una persona risponde, uno per reply.positive quando una risposta riceve l'etichetta Interessato o Richiesta di appuntamento, e uno per reply.label_changed ogni volta che qualcuno imposta o cambia un'etichetta, così nessuno aspetta il controllo successivo.

Dal terminale

Shell
npx argorant inbox list --folder replies
npx argorant inbox read <thread-id>
npx argorant inbox reply <thread-id> --body "Thursday works."
npx argorant inbox classify <thread-id> meeting_booked

In questa pagina