ArgorantDocs

Répondre aux réponses

Toutes les réponses de toutes les campagnes dans une seule boîte de réception. Répondez dans le même fil, transférez, et marquez les réponses comme intéressé, rendez-vous pris ou votre propre étape de pipeline.

Voir les nouvelles réponses

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

folder vaut all, replies, interested, not_interested, out_of_office, bounces ou unsubscribes. Affinez avec campaign_id, classification ou un mot recherché dans q. Les conversations arrivent avec l'activité la plus récente en premier, vos propres réponses comprises. Les listes affichent les 300 premiers caractères du dernier message. Paginez avec cursor et next_cursor jusqu'à ce que has_more soit faux ; chaque conversation est accessible. Une conversation que personne n'a encore classée a la classification unknown.

Ne lire que ce qui a changé

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 garde les conversations dont le message le plus récent de la personne est arrivé après ce moment. updated_after compte aussi vos propres réponses. Chaque conversation a lead_id, updated_at et last_received_at. Si vous interrogez plutôt l'API à intervalles réguliers, commencez chaque lecture quelques minutes avant la fin de la précédente et ignorez les identifiants que vous avez déjà. Une ligne peut être enregistrée un instant après l'heure qu'elle porte, donc une fenêtre qui commence exactement là où la précédente s'est arrêtée peut la manquer. Les webhooks n'ont besoin de rien de tout cela.

Lire une conversation

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

$THREAD est l'id de la liste. Vous obtenez le texte complet et tout le fil, du plus ancien au plus récent : vos e-mails, leurs réponses, vos réponses et vos transferts.

Répondre dans le même fil

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 réponse part immédiatement, dans le même fil, depuis la boîte mail qui a reçu la réponse. Un agent doit montrer le texte à l'utilisateur et attendre un oui. L'Idempotency-Key garantit qu'une nouvelle tentative ne l'envoie jamais deux fois.

La transférer à un collègue

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

Le transfert contient l'historique et les pièces jointes. Dans les trois minutes, la conversation indique s'il a été délivré.

La marquer et suivre votre pipeline

Chaque espace de travail a cinq statuts standard : positive (affiché comme Intéressé), meeting_request, out_of_office, unsubscribe et neutral (affiché comme Autre). Vous pouvez activer not_interested, question, referral, wrong_person et meeting_booked. Ajoutez vos propres étapes :

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 est compris comme positive. Renommez une étape, changez sa couleur, masquez-la ou affichez-la avec PATCH /api/v1/reply-statuses/{key}. Supprimez l'une de vos propres étapes avec DELETE /api/v1/reply-statuses/{key} ; ses conversations repassent en neutre.

Être prévenu tout de suite

Un webhook pour reply.received appelle votre serveur quand une personne répond, un autre pour reply.positive quand une réponse reçoit le statut Intéressé ou Demande de rendez-vous, et un autre pour reply.label_changed chaque fois que quelqu'un attribue ou modifie un statut, pour que personne n'attende la vérification suivante.

Depuis le terminal

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

Sur cette page