Cómo lanzar la primera campaña por API
La campaña en NN Agent se compone de tres partes: contactos, grupo de opciones del primer mensaje y cuentas vinculadas. A continuación, el orden de las llamadas de la versión v2.
Antes de comenzar, conecta al menos una cuenta — ver Conectar cuenta por API.
curl -X POST https://api.nexifyneo.com/v2/campaigns \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d 'YOUR_JSON_BODY'La respuesta devolverá el identificador de la campaña en formato UUID. Luego, se utiliza en la ruta de todas las demás solicitudes.
Los contactos se cargan mediante un archivo, no línea por línea. Se admiten CSV y XLSX; el formato se indica con el parámetro de solicitud format, por defecto csv.
curl -X POST "https://api.nexifyneo.com/v2/campaigns/CAMPAIGN_ID/contacts/upload?format=csv" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-F "file=@contacts.csv"Para verificar que la base se ha cargado, se puede usar un resumen: GET /v2/campaigns/{campaign_id}/contacts/stats.
curl -X POST https://api.nexifyneo.com/v2/campaigns/CAMPAIGN_ID/message-pool \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d 'YOUR_JSON_BODY'Agrega varias opciones, no solo una. NN Agent toma del grupo el texto para el siguiente contacto, y esta es la única forma de no enviar el mismo texto a toda la base carácter por carácter.
curl -X POST https://api.nexifyneo.com/v2/campaigns/CAMPAIGN_ID/accounts \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d 'YOUR_JSON_BODY'Las salidas se enviarán desde las cuentas vinculadas. La desvinculación se realiza con la misma dirección mediante el método DELETE.
curl https://api.nexifyneo.com/v2/campaigns/CAMPAIGN_ID \
-H "Authorization: Bearer YOUR_API_TOKEN"Verifica que la campaña tenga contactos, un grupo de mensajes y al menos una cuenta. Una campaña sin grupo o sin cuenta no tiene de dónde enviar y nada que enviar.
Cómo se inicia el envío#
No hay una operación separada "iniciar campaña" que declare la especificación publicada. El inicio se realiza actualizando la campaña (POST /v2/campaigns/{campaign_id}/update) ya sea desde la oficina; qué campos específicos cambia el inicio, consulte con los gerentes en el bot @NN_official_bot.
¿Qué pasa después con los diálogos?#
Después del primer contacto, la conversación es guiada por la IA según su guion — vea Flujo de chat. La correspondencia se puede leer y continuar manualmente a través de operaciones de diálogos.
Exportar la base con los resultados de vuelta: GET /v2/campaigns/{campaign_id}/contacts/export?format=xlsx.
Siguiente#
- Campañas y contactos en la API — lista completa de operaciones.
- Diálogos — lectura de la correspondencia y envío de mensajes.
- AI Outreach — cómo se ve en el panel.