Automatizar un pitch
Las agencias repiten la misma secuencia con cada prospecto: crear un proyecto pitch, elegir los modelos de IA, añadir los prompts, leer los resultados unos días después y — si el prospecto firma — convertir el pitch en un proyecto de cliente. Cada paso está disponible a través de la API REST, con exactamente los mismos límites y códigos de error que el dashboard, de modo que un pitch puede iniciarse desde un CRM, un formulario o un script sin que nadie abra la UI.Los proyectos pitch requieren una cuenta Agency. No tienen coste de
proyecto, están limitados a 50 prompts y se pausan automáticamente al
cerrarse la ventana del pitch (1, 7 o 14 días). El número de proyectos pitch
simultáneos está limitado por paquete.
1. Crear el proyecto pitch
language es obligatorio y determina el idioma de los prompts y el filtro de
país. Un proyecto nuevo empieza con los modelos predeterminados de tu cuenta.
id que necesitas para todas las llamadas siguientes
y los models actuales. Un 403 con details.reason = "pitch_project_limit"
significa que todos los slots de pitch de tu paquete están en uso — convierte o
elimina un pitch primero.
2. Establecer los modelos
Los prompts siempre se ejecutan en los modelos del proyecto, así que establécelos antes de añadir prompts. Esto reemplaza el conjunto completo, igual que hace la página Model Settings.403 con details.reason = "agency_limit" significa que las respuestas de
IA mensuales proyectadas superan la franja incluida en tu paquete
(details.nextPackage indica el upgrade). En el paquete superior la llamada
tiene éxito y devuelve en su lugar un meteredNotice; el exceso se factura
como consumo adicional.
3. Añadir los prompts
Omitemodels para usar los modelos del proyecto. language usa por defecto
el idioma del proyecto. Cada prompt se pone en cola de inmediato
(enqueued: true).
403: pitch_prompt_limit (50 prompts alcanzados),
pitch_expired, agency_limit. Pasar un modelo que no está habilitado en el
proyecto devuelve 400 model_not_enabled — vuelve al paso 2.
4. Leer los resultados
Da a los workers unos minutos para las primeras respuestas; un pitch completo suele tener una ejecución al día. Después lee los KPIs, el ranking de competidores y el desglose por prompt para la ventana del pitch:visibilityRate, mentionRate y citationRate se explican en
KPIs explicados. Filtra por un único motor con
model=<id>, usando uno de los models del proyecto.
5. Convertir un pitch ganado
Convierte el pitch en un proyecto de cliente facturable: elimina el máximo de prompts, detiene la pausa automática y reanuda todo lo que la caducidad haya pausado.403 con details.reason = "agency_limit" y details.limit = "projects"
significa que no hay ningún slot de cliente libre; con details.limit = "answers"
los prompts del proyecto superarían la franja de respuestas incluida al precio
de mes completo.