Encontrar a 200 personas y escribirles
De a quién le vendes a una campaña en marcha: acota a unas 200 personas, escribe los correos con una línea personal, elige los buzones y lanza tras un sí.
Esta guía lleva unos 15 minutos. Buscar es gratis. Añadir a las personas cuesta 1 crédito por cada persona cuyo correo pasa la comprobación, así que unos 200 créditos. Los correos en sí van incluidos en tu plan.
Necesitas una clave de API, un plan o créditos suficientes y al menos un buzón conectado. Comprueba los buzones con GET /api/v1/inboxes. ¿Todavía no tienes buzón? Conecta un Google Workspace en un solo paso, conecta Microsoft 365 en la app, conecta un buzón de cualquier otro proveedor o pide buzones nuevos con POST /api/v1/inboxes/quote.
Di a quién le vendes
Elige los cargos, el sector, el país y el tamaño de empresa. Usa las listas de palabras gratuitas para obtener los nombres exactos:
curl -G "https://app.argorant.com/api/v1/lookups/industries" -H "Authorization: Bearer $ARGORANT_API_KEY" --data-urlencode "q=logistics"Acota el recuento a unas 200
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}¿Demasiadas? Añade una ciudad, un nivel de responsabilidad o un tamaño de empresa menor. ¿Muy pocas? Añade más cargos o países. Contar es gratis, así que prueba todas las veces que quieras.
Mira una página de resultados
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"Si los cargos y las empresas encajan, sigue. Si no, cambia los filtros y vuelve a contar.
Guárdalas como lista
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"}}'Apunta el list_id. La lista se llena sola en unos segundos.
Crea la campaña
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"}'Es un borrador. Las campañas nuevas envían texto plano en días laborables y no llevan línea para darse de baja, salvo que pongas include_unsubscribe en true.
Escribe los correos
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}} es el nombre de la empresa tal como lo dice la gente. {{custom_opener}} es una línea personal para cada persona, que configuras a continuación. El texto sobrante, como [link], vuelve en warnings, y la campaña no se lanzará hasta que desaparezca.
Añade una línea personal (opcional)
Configura la línea una vez, con un texto de respaldo que suene bien para cualquiera:
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."}]}'Después, GET .../personalization lista a las personas que siguen con el texto de respaldo, con datos sobre su empresa, y PATCH .../leads/custom-fields guarda las líneas que escribes tú o tu agente, hasta 5.000 por llamada. La línea que alguien ya tiene se mantiene salvo que envíes "overwrite": true, así que una segunda ejecución nunca sustituye líneas por accidente. Una instrucción puede tener hasta 4.000 caracteres y cada línea entre 20 y 300 (max_length, 150 por defecto); consulta Escribir líneas personales para ver todos los límites.
Añade a las personas
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 primera respuesta puede ser una pregunta (needs_choice: true): cuántas direcciones están confirmadas y cuántas están en dominios que aceptan cualquier dirección. Pregunta al usuario y vuelve a llamar con "grades": ["valid"] (recomendado) o ["valid", "catch_all"]. Cada persona nueva cuesta 1 crédito. Las personas cuyo correo no pasa la comprobación nunca se añaden ni se cobran.
Elige los buzones
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}'Lanza tras un sí
curl "https://app.argorant.com/api/v1/campaigns/$ID" -H "Authorization: Bearer $ARGORANT_API_KEY"Muestra al usuario los correos, el número de personas y los buzones. launch_blockers tiene que estar vacío. Después, y solo tras su sí:
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/launch" -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: ops-nl-launch"Las respuestas llegan a la bandeja de entrada. Responder a las respuestas explica cómo leerlas, contestar en el mismo hilo y seguir tu pipeline. GET /api/v1/campaigns/$ID/analytics da las cifras diarias.
Tu primera llamada
El inicio rápido. Con una sola clave de API cuentas un mercado, ves a las personas, desbloqueas algunas, las guardas como lista y preparas una campaña. Contar y mirar es gratis.
Encontrar un correo
Con el nombre de una persona y el dominio de su empresa, obtienes su correo corporativo. De uno en uno o hasta 10.000 personas, desde la API, la línea de comandos, tu IA o la app.