Pular para o conteúdo principal

​
Definir Valor

PUT /backend/lead-fields/{lead_id}/{field_id}
Define o valor de um campo personalizado para um lead específico.

​
Path Parameters

​
lead_id
string
obrigatório
UUID do lead
​
field_id
string
obrigatório
UUID da definição do campo

​
Request Body

​
value
any
obrigatório
Valor do campo (tipo deve corresponder ao field_type)
curl -X PUT "https://api.leavo.ai/backend/lead-fields/uuid-lead/uuid-field" \
  -H "Authorization: Bearer sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "Indicação"
  }'

{
  "lead_id": "uuid-lead",
  "field_id": "uuid-field",
  "value": "Indicação",
  "updated_at": "2024-01-15T10:30:00Z"
}

​
Obter Valores de um Lead

GET /backend/lead-fields/{lead_id}
Retorna todos os valores de campos personalizados de um lead.

​
Path Parameters

​
lead_id
string
obrigatório
UUID do lead

​
Query Parameters

​
detailed
boolean
padrão:"false"
Incluir detalhes da definição do campo
curl -X GET "https://api.leavo.ai/backend/lead-fields/uuid-lead?detailed=true" \
  -H "Authorization: Bearer sua_chave_aqui"

{
  "origem_lead": "Indicação",
  "valor_potencial": 50000,
  "data_primeiro_contato": "2024-01-10T00:00:00Z"
}

​
Exemplo Completo

// 1. Criar definição de campo
const fieldDef = await fetch('https://api.leavo.ai/backend/custom-fields', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    field_key: 'valor_potencial',
    field_label: 'Valor Potencial',
    field_type: 'number',
    required: false
  })
}).then(r => r.json());

// 2. Definir valor para um lead
await fetch(
  `https://api.leavo.ai/backend/lead-fields/${leadId}/${fieldDef.id}`,
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ value: 75000 })
  }
);

// 3. Buscar todos os valores do lead
const values = await fetch(
  `https://api.leavo.ai/backend/lead-fields/${leadId}`,
  { headers: { 'Authorization': 'Bearer key' } }
).then(r => r.json());

console.log(values);
// { valor_potencial: 75000 }