Atualização de lead

curl --request PUT \
  --url https://api.wegly.com.br/integrations/external/leads/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Lead ajustado",
  "persons_id": [
    {
      "person_id": "2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111"
    },
    {
      "person_id": "9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99",
      "delete": true
    }
  ],
  "organization_id": null,
  "custom_fields": [
    {
      "id": "f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11",
      "value": "Prioritário"
    }
  ]
}
'

import requests

url = "https://api.wegly.com.br/integrations/external/leads/{id}"

payload = {
    "title": "Lead ajustado",
    "persons_id": [
        { "person_id": "2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111" },
        {
            "person_id": "9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99",
            "delete": True
        }
    ],
    "organization_id": None,
    "custom_fields": [
        {
            "id": "f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11",
            "value": "Prioritário"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Lead ajustado',
    persons_id: [
      {person_id: '2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111'},
      {person_id: '9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99', delete: true}
    ],
    organization_id: null,
    custom_fields: [{id: 'f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11', value: 'Prioritário'}]
  })
};

fetch('https://api.wegly.com.br/integrations/external/leads/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.wegly.com.br/integrations/external/leads/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Lead ajustado',
    'persons_id' => [
        [
                'person_id' => '2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111'
        ],
        [
                'person_id' => '9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99',
                'delete' => true
        ]
    ],
    'organization_id' => null,
    'custom_fields' => [
        [
                'id' => 'f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11',
                'value' => 'Prioritário'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.wegly.com.br/integrations/external/leads/{id}"

	payload := strings.NewReader("{\n  \"title\": \"Lead ajustado\",\n  \"persons_id\": [\n    {\n      \"person_id\": \"2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111\"\n    },\n    {\n      \"person_id\": \"9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99\",\n      \"delete\": true\n    }\n  ],\n  \"organization_id\": null,\n  \"custom_fields\": [\n    {\n      \"id\": \"f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11\",\n      \"value\": \"Prioritário\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.wegly.com.br/integrations/external/leads/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Lead ajustado\",\n  \"persons_id\": [\n    {\n      \"person_id\": \"2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111\"\n    },\n    {\n      \"person_id\": \"9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99\",\n      \"delete\": true\n    }\n  ],\n  \"organization_id\": null,\n  \"custom_fields\": [\n    {\n      \"id\": \"f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11\",\n      \"value\": \"Prioritário\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.wegly.com.br/integrations/external/leads/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Lead ajustado\",\n  \"persons_id\": [\n    {\n      \"person_id\": \"2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111\"\n    },\n    {\n      \"person_id\": \"9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99\",\n      \"delete\": true\n    }\n  ],\n  \"organization_id\": null,\n  \"custom_fields\": [\n    {\n      \"id\": \"f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11\",\n      \"value\": \"Prioritário\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "code": 123,
  "title": "<string>",
  "quality_rating": 123,
  "quality_reason": "<string>",
  "lost_reason_description": "<string>"
}

Leads

Atualização de lead

Atualiza campos do lead. Somente campos enviados são considerados. - O campo lead_source não é aceito nesta API; utilize crm_lead_source_id. - Enviar ao mesmo tempo organization_id e organization resulta em erro. - Para remover a organização vinculada, envie organization_id como null. - persons_id aceita marcação com delete: true para remover participantes; remoções inexistentes são ignoradas. - Quando marketing é enviado, um novo snapshot de rastreio pode ser registrado; mudanças em crm_lead_source_id também atualizam esse histórico.

PUT

integrations

external

leads

{id}

Atualização de lead

curl --request PUT \
  --url https://api.wegly.com.br/integrations/external/leads/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Lead ajustado",
  "persons_id": [
    {
      "person_id": "2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111"
    },
    {
      "person_id": "9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99",
      "delete": true
    }
  ],
  "organization_id": null,
  "custom_fields": [
    {
      "id": "f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11",
      "value": "Prioritário"
    }
  ]
}
'

import requests

url = "https://api.wegly.com.br/integrations/external/leads/{id}"

payload = {
    "title": "Lead ajustado",
    "persons_id": [
        { "person_id": "2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111" },
        {
            "person_id": "9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99",
            "delete": True
        }
    ],
    "organization_id": None,
    "custom_fields": [
        {
            "id": "f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11",
            "value": "Prioritário"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Lead ajustado',
    persons_id: [
      {person_id: '2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111'},
      {person_id: '9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99', delete: true}
    ],
    organization_id: null,
    custom_fields: [{id: 'f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11', value: 'Prioritário'}]
  })
};

fetch('https://api.wegly.com.br/integrations/external/leads/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.wegly.com.br/integrations/external/leads/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Lead ajustado',
    'persons_id' => [
        [
                'person_id' => '2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111'
        ],
        [
                'person_id' => '9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99',
                'delete' => true
        ]
    ],
    'organization_id' => null,
    'custom_fields' => [
        [
                'id' => 'f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11',
                'value' => 'Prioritário'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.wegly.com.br/integrations/external/leads/{id}"

	payload := strings.NewReader("{\n  \"title\": \"Lead ajustado\",\n  \"persons_id\": [\n    {\n      \"person_id\": \"2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111\"\n    },\n    {\n      \"person_id\": \"9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99\",\n      \"delete\": true\n    }\n  ],\n  \"organization_id\": null,\n  \"custom_fields\": [\n    {\n      \"id\": \"f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11\",\n      \"value\": \"Prioritário\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.wegly.com.br/integrations/external/leads/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Lead ajustado\",\n  \"persons_id\": [\n    {\n      \"person_id\": \"2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111\"\n    },\n    {\n      \"person_id\": \"9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99\",\n      \"delete\": true\n    }\n  ],\n  \"organization_id\": null,\n  \"custom_fields\": [\n    {\n      \"id\": \"f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11\",\n      \"value\": \"Prioritário\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.wegly.com.br/integrations/external/leads/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Lead ajustado\",\n  \"persons_id\": [\n    {\n      \"person_id\": \"2c7f0b73-1b5b-4ce0-9b8c-22c55c7cc111\"\n    },\n    {\n      \"person_id\": \"9c1de125-7d0a-4e9f-8f8a-8b233c6f6e99\",\n      \"delete\": true\n    }\n  ],\n  \"organization_id\": null,\n  \"custom_fields\": [\n    {\n      \"id\": \"f0d82e2b-a6b0-48e9-a4f2-6d3d2e6e9d11\",\n      \"value\": \"Prioritário\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "code": 123,
  "title": "<string>",
  "quality_rating": 123,
  "quality_reason": "<string>",
  "lost_reason_description": "<string>"
}

Authorizations

Authorization

string

header

required

Utilize o token de integração no header Authorization: Bearer {token}. O domínio de origem (Origin/Referer) deve respeitar allowed_domain, quando configurado na chave.

Path Parameters

string

required

UUID do lead a ser atualizado.

Body

application/json

title

string

required

Maximum string length: 150

stage_id

string<uuid>

responsible_id

string<uuid>

quality_rating

enum<integer>

Available options:

1,

2,

3,

4,

5

quality_reason

string

visibility

enum<integer>

0 = privado (responsável, membros dos times do responsável e supervisores), 1 = restrito ao responsável e times relacionados.

Available options:

0,

1

persons_id

object[]

Lista de operações de associação ou remoção de participantes. delete: true remove a pessoa do lead; omita ou envie false para adicionar.

Show child attributes

person

object

Pessoa associada ao lead. Envie telefone, e-mail e redes sociais em contacts; phone e email no topo do lead não são aceitos.

Show child attributes

organization_id

string<uuid> | null

Organização existente. Envie null para remover a organização atual. Conflita com organization.

organization

object

Show child attributes

custom_fields

object[]

Show child attributes

marketing

object

Rastreio de marketing. Todos os valores são sanitizados (trim) e campos vazios são ignorados. utm_* são normalizados para wegly_* equivalentes quando estes não forem enviados. utm_term vira utm_search_term se o campo específico não for enviado. url_conversion tem seus parâmetros extraídos automaticamente (wegly_, utm_, gclid, fbclid, conversion_tool_name). Quando wegly_code referencia um tracker válido, a origem do lead é extraída do tracker. Quando não há tracker nem origem explícita, wegly_source ou utm_source busca/cria a origem automaticamente.

Show child attributes

crm_lead_source_id

string<uuid>

Response

Lead atualizado.

Retorno enxuto da atualização.

string

code

integer

title

string

quality_rating

integer | null

quality_reason

string | null

status

enum<integer>

1 = aberto, 2 = ganho, 3 = perdido.

Available options:

1,

2,

3

lost_reason_description

string | null

Integrações

Eventos de Webhooks

Rotas da API

Atualização de lead

Authorizations

Path Parameters

Body

Response