Saltar al contenido principal
POST
Registrar un lead de campaña

Parámetros de consulta

workspaceId
string | null

Obligatorio al llamar desde un navegador. Una solicitud CORS preflight no lleva cuerpo, por lo que no se puede resolver el tenant ni devolver Access-Control-Allow-Origin a menos que el workspace esté en la URL. Las llamadas de servidor a servidor no realizan preflight y pueden omitirlo.

Cuerpo

application/json

Contrato de intercambio de POST api/v1/leadscout/campaign-leads.

workspaceId
string
requerido
captureKey
string
requerido
cellphone
string
requerido
landingUri
string
requerido

Declaración del tenant de que el visitante dio permiso para recibir mensajes.

Esto NO es CommercialConsentState, nuestro registro del ciclo de vida del consentimiento de un contacto. Es una afirmación externa que no podemos verificar: demuestra qué se nos comunicó y cuándo, que es lo que presentaríamos si se restringiera el portfolio de un tenant.

recaptchaToken
string
requerido
name
string | null
brandId
string | null
utm
Utm · object

Respuesta

Aceptado y en cola. NO enviado: un servicio separado transmite el primer mensaje después.

Cuerpo de la respuesta 202 Accepted.

Tiene un nombre en lugar de ser un simple dict[str, str] para que el esquema publicado indique cuál es el único campo y para qué sirve, en lugar de «un objeto con propiedades de texto».

requestId
string
requerido

ID de correlación de este envío. Solo está presente cuando se acepta; las respuestas de error no lo incluyen.