ArgorantDocs

Responder a las respuestas

Todas las respuestas de todas las campañas en una sola bandeja de entrada. Contesta en el mismo hilo, reenvía y marca las respuestas como interesado, reunión agendada o tu propia etapa del pipeline.

Ver las respuestas nuevas

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

folder es all, replies, interested, not_interested, out_of_office, bounces o unsubscribes. Filtra más con campaign_id, classification o una palabra de búsqueda en q. Las conversaciones llegan con la actividad más reciente primero, incluidas tus propias respuestas. Las listas muestran los primeros 300 caracteres del último mensaje. Pagina con cursor y next_cursor hasta que has_more sea false; se puede llegar a todas las conversaciones. Una conversación que nadie ha etiquetado todavía tiene la clasificación unknown.

Leer solo lo que cambió

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 conserva las conversaciones cuyo mensaje más reciente de la persona llegó después de ese momento. updated_after también cuenta tus propias respuestas. Cada conversación tiene lead_id, updated_at y last_received_at. Si en cambio lees la API de forma periódica, empieza cada lectura unos minutos antes del final de la anterior y omite los ids que ya tienes. Una fila puede guardarse un momento después de la hora que lleva, así que una ventana que empieza justo donde terminó la anterior puede perderla. Los webhooks no necesitan nada de esto.

Leer una conversación

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

$THREAD es el id de la lista. Recibes el texto completo y todo el hilo, del más antiguo al más reciente: tus correos, sus respuestas, tus contestaciones y los reenvíos.

Contestar en el mismo hilo

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 respuesta sale de inmediato, en el mismo hilo, desde el buzón que recibió la respuesta. Un agente debería mostrar el texto al usuario y esperar un sí. El Idempotency-Key garantiza que un reintento nunca la envíe dos veces.

Reenviarla a un compañero

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

El reenvío incluye el historial y los adjuntos. En menos de tres minutos la conversación muestra si se entregó.

Márcala y sigue tu pipeline

Cada espacio de trabajo tiene cinco etiquetas estándar: positive (se muestra como Interesado), meeting_request, out_of_office, unsubscribe y neutral (se muestra como Otro). Puedes activar not_interested, question, referral, wrong_person y meeting_booked. Añade tus propias etapas:

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 se entiende como positive. Cambia el nombre o el color de una etapa, ocúltala o muéstrala con PATCH /api/v1/reply-statuses/{key}. Borra una de tus propias etapas con DELETE /api/v1/reply-statuses/{key}; sus conversaciones vuelven a neutral.

Recibe el aviso al momento

Un webhook para reply.received llama a tu servidor cuando una persona responde, uno para reply.positive cuando una respuesta recibe la etiqueta Interesado o Solicitud de reunión, y uno para reply.label_changed cada vez que alguien pone o cambia una etiqueta, así nadie espera a la siguiente comprobación.

Desde la 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

En esta página