ArgorantDocs

Campañas de principio a fin

Crea la campaña, escribe los correos, añade una lista, elige tus buzones y lanza. Cada paso es una llamada, y no se envía nada antes del lanzamiento.

No se envía nada hasta que llamas a launch. Los mismos pasos existen como comandos de la línea de comandos y como herramientas MCP, así que un agente puede hacer todo el flujo y preguntar al usuario antes del lanzamiento. Envía una cabecera Idempotency-Key en cada llamada para que un reintento nunca haga el trabajo dos veces.

Comprueba que hay un buzón conectado

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

¿Todavía no tienes buzón? Conecta un Google Workspace en un solo paso (guía), Microsoft 365 en la app o un buzón de cualquier otro proveedor con su configuración de servidor (guía).

Crea la campaña con su configuración

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 es obligatorio, y cualquier ajuste se puede cambiar después con PATCH /api/v1/campaigns/{id}. timezone_mode: "lead" envía en la hora local de cada persona. Las campañas envían texto plano, que es lo que mejor llega a la bandeja de entrada. No hay línea para darse de baja salvo que pongas include_unsubscribe en true.

Escribe la secuencia

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

El primer correo necesita asunto. Los seguimientos se quedan en el mismo hilo por defecto y esperan delay_days después del anterior. Puedes usar {{first_name}}, {{last_name}}, {{company}}, {{company_normalized}} (el nombre que usa la gente), {{title}} y cualquier columna que hayas enviado con las personas, como {{plan}}. Escribe {a|b} para variar una frase según la persona. Añade variants a un correo para tener otras versiones; se envían por turnos. Una línea personal para cada persona se configura con PUT /api/v1/campaigns/{id}/personalization; consulta Encontrar a 200 personas y escribirles.

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

O envía tus propias rows con email, first_name, last_name, company, title y cualquier columna propia. Cada dirección se comprueba antes de entrar. Cuando una lista contiene direcciones que no se pueden confirmar, la primera respuesta pregunta cuáles quieres incluir (needs_choice); vuelve a llamar con "grades": ["valid"] (recomendado) o ["valid", "catch_all"]. Las personas de los datos de Argorant cuestan 1 crédito cada una la primera vez; tus propias filas son gratis. Las direcciones privadas (correo gratuito, conexión a internet doméstica) se añaden como cualquier otra; envía "exclude_private_emails": true para incluir solo correos corporativos.

Asigna los remitentes

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

O indica emails concretos. Los correos se reparten entre los buzones, cada uno dentro de su propio límite diario.

Lanza

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 está vacío cuando la campaña puede salir. Antes de lanzar, POST /api/v1/campaigns/{id}/test-email te envía una prueba de un correo, rellenada con un contacto de ejemplo. Lanza solo después de que el usuario haya dicho que sí. pause la detiene temporalmente, stop la termina y DELETE elimina una campaña que no está en marcha.

Sigue su progreso

GET /api/v1/campaigns/{id}/analytics?days=30 da las cifras diarias (enviados, respuestas, respuestas positivas, rebotes, bajas) con totales y tasas. GET /api/v1/campaigns/{id} tiene los recuentos en directo. GET /api/v1/campaigns/{id}/leads?status=replied lista quién ha respondido, y GET /api/v1/campaigns/{id}/replies da sus mensajes. Para las respuestas de todas las campañas usa la bandeja de entrada. GET /api/v1/campaigns/{id}/senders lista los buzones que la envían, con su estado.

Cambia las personas de una campaña en marcha

POST /api/v1/campaigns/{id}/leads/remove saca a muchas personas a la vez, elegidas por estado, respuesta, rebote, dominio del correo, etiqueta, direcciones o una lista guardada. Envía primero "preview": true para ver cuántas saldrían. Las personas que ya recibieron un correo se quedan salvo que envíes "include_contacted": true. Una adición o eliminación grande se ejecuta en segundo plano: la respuesta es 202 con un trabajo, y GET /api/v1/campaigns/{id}/lead-jobs/{job_id} indica cuánto ha avanzado.

Las líneas personales de muchas personas van en un solo archivo: POST /api/v1/campaigns/{id}/leads/custom-fields/import acepta un archivo CSV, JSON o NDJSON con hasta 200.000 filas (50 MB). Las líneas que las personas ya tienen se mantienen y se listan con su fila. Para corregirlas, sube el archivo con ?overwrite=true; una columna clear (o null en JSON) quita una línea, y la persona vuelve a recibir el texto de respaldo. Cada línea sustituida vuelve en la respuesta, la antigua y la nueva.

Carpetas

GET /api/v1/folders lista tus carpetas, POST /api/v1/folders crea una y PATCH /api/v1/folders/{id} le cambia el nombre. POST /api/v1/campaigns/{id}/folder con un folder_id archiva una campaña en esa carpeta, y null la vuelve a sacar. Las carpetas solo ordenan las campañas; el envío no se ve afectado.

Buzones y la lista de bloqueo

GET /api/v1/inboxes lista tus buzones con filtros por dominio, estado, etiqueta y proveedor. PATCH /api/v1/inboxes/{email} fija el límite diario de un buzón, el calentamiento, si puede enviar, su nombre o su zona horaria, y DELETE lo desconecta. POST /api/v1/inboxes/update hace el mismo cambio en muchos buzones a la vez, elegidos por dominio, etiqueta, estado o dirección; por defecto muestra una vista previa y no cambia nada hasta que envías "preview": false. POST /api/v1/blocklist con una dirección o un dominio detiene todos los correos hacia ella en tu espacio de trabajo; DELETE /api/v1/blocklist/{id} lo vuelve a levantar.

Los mismos pasos en la terminal

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

En esta página