Update prospect
PUT
https://evo-integracao-api.w12app.com.br/api/v1/prospects
🌐 API Reference/Prospects
Actualizar Prospecto
Descripción
OBS. Disponible para uso con clave de acceso de sucursal y también con clave de acceso de ADM General.
📨 Cuerpo de la Solicitud (Body Params)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| idProspect | int32 | Sí | ID del prospecto a actualizar. |
| name | string | No | Nombre preferencial del prospecto. |
| string | No | Correo electrónico del prospecto. | |
| lastName | string | No | Apellido preferencial del prospecto. |
| idBranch | int32 | No | ID de la unidad/sucursal asociada. |
| ddi | string | No | Código DDI del teléfono. |
| cellphone | string | No | Número de celular del prospecto. |
| birthday | date-time | No | Fecha de nacimiento (formato ISO 8601). |
| gender | string | No | Género del prospecto {M, F, P}. |
| visit | int32 | No | Código del origen de la visita/campaña. |
| marketingType | string | No | Tipo de marketing asociado. |
| notes | string | No | Notas adicionales sobre el prospecto. |
| currentStep | string | No | Etapa actual del prospecto en el embudo de conversión. |
| cpf | string | No | CPF del prospecto. |
| passport | string | No | Número de pasaporte del prospecto. |
| rg | string | No | Número de RG del prospecto. |
| address | string | No | Dirección del prospecto. |
| city | string | No | Ciudad del prospecto. |
| complement | string | No | Complemento de la dirección. |
| neighborhood | string | No | Barrio del prospecto. |
| idState | int32 | No | ID del estado (UF). |
| zipCode | string | No | Código postal del prospecto. |
| number | string | No | Número de la dirección. |
| tokenGympass | string | No | Token de integración con Gympass (si aplica). |
| userTokenGoGood | string | No | Token de integración con GoGood (si aplica). |
| additionalFieldName | string | No | Nombre de campo adicional personalizado. |
| additionalFieldValue | string | No | Valor del campo adicional personalizado. |
| validateCpfDuplication | boolean | No | Valida duplicidad de CPF antes de actualizar el prospecto. |
| temperature | number | No | Temperatura/clasificación del lead. |
| financiallyResponsible | object | No | Datos del responsable financiero. Ver estructura abajo. |
| interests | array[int32] | No | Lista de IDs de intereses del prospecto. |
🧩 Estructura del objeto financiallyResponsible
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| idMember | int32 | ID del miembro vinculado como responsable financiero. | No |
| name | string | Nombre del responsable financiero. | No |
| string | Correo electrónico del responsable financiero. | No | |
| cpf | string | CPF del responsable financiero. | No |
📤 Estructura de la Respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
| idProspect | int | Identificador del prospecto actualizado. |
Solicitud
Parámetros del Body
application/json-patch+json
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://evo-integracao-api.w12app.com.br/api/v1/prospects' \
--header 'Content-Type: application/json-patch+json' \
--data '{
"idProspect": 0,
"name": "string",
"email": "string",
"lastName": "string",
"registerName": "string",
"registerLastName": "string",
"usePreferredName": true,
"ddi": "string",
"cellphone": "string",
"birthday": "2019-08-24T14:15:22.123Z",
"gender": "string",
"notes": "string",
"currentStep": "string",
"cpf": "string",
"rg": "string",
"passport": "string",
"address": "string",
"city": "string",
"complement": "string",
"neighborhood": "string",
"idState": 0,
"zipCode": "string",
"number": "string",
"tokenGympass": "string",
"idBranch": 0,
"temperature": 1,
"financiallyResponsible": {
"idMember": 0,
"name": "string",
"email": "string",
"cpf": "string"
},
"interests": [
0
]
}'Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
"idProspect": 0
}Modificado en 2026-05-15 13:34:34