curl -X PUT "https://suasofia.online/api/user/leads/123" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"campaign_id": 456,
"phone_number": "+1234567890",
"variables": {
"name": "John Doe",
"company": "Acme Corp"
}
}'
{
"message": "Lead atualizado com sucesso"
}
{
"message": "Lead não encontrado"
}
{
"message": "Campanha não encontrada"
}
{
"message": "Número de telefone inválido"
}
{
"message": "Validação falhou",
"errors": {
"campaign_id": ["A campanha selecionada não existe"],
"status": ["Este status é atribuído automaticamente e não pode ser definido manualmente"],
"variables": ["As variáveis devem ser um array"]
}
}
{
"message": "Campos inválidos: invalid_field, another_invalid_field"
}
Leads
Atualizar Lead
Atualize um lead existente em suas campanhas
PUT
/
user
/
leads
/
{id}
curl -X PUT "https://suasofia.online/api/user/leads/123" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"campaign_id": 456,
"phone_number": "+1234567890",
"variables": {
"name": "John Doe",
"company": "Acme Corp"
}
}'
{
"message": "Lead atualizado com sucesso"
}
{
"message": "Lead não encontrado"
}
{
"message": "Campanha não encontrada"
}
{
"message": "Número de telefone inválido"
}
{
"message": "Validação falhou",
"errors": {
"campaign_id": ["A campanha selecionada não existe"],
"status": ["Este status é atribuído automaticamente e não pode ser definido manualmente"],
"variables": ["As variáveis devem ser um array"]
}
}
{
"message": "Campos inválidos: invalid_field, another_invalid_field"
}
Atualize um lead fornecendo o ID do lead e os campos que você deseja modificar. Somente os campos fornecidos na solicitação serão atualizados.
Parâmetros de Caminho
integer
required
O ID do lead a ser atualizado
Parâmetros do Corpo
integer
O ID da campanha para atribuir o lead
string
O número de telefone do lead (será formatado para E164)
string
O status do lead. Deve ser um dos seguintes:
created, completed, reached-max-retriesobject
Variáveis personalizadas para mesclar com as variáveis existentes do lead
Resposta
string
Mensagem de sucesso indicando que o lead foi atualizado
curl -X PUT "https://suasofia.online/api/user/leads/123" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"campaign_id": 456,
"phone_number": "+1234567890",
"variables": {
"name": "John Doe",
"company": "Acme Corp"
}
}'
{
"message": "Lead atualizado com sucesso"
}
{
"message": "Lead não encontrado"
}
{
"message": "Campanha não encontrada"
}
{
"message": "Número de telefone inválido"
}
{
"message": "Validação falhou",
"errors": {
"campaign_id": ["A campanha selecionada não existe"],
"status": ["Este status é atribuído automaticamente e não pode ser definido manualmente"],
"variables": ["As variáveis devem ser um array"]
}
}
{
"message": "Campos inválidos: invalid_field, another_invalid_field"
}
Notas
- O lead deve pertencer ao usuário autenticado
- Se atualizar a campanha, a nova campanha também deve pertencer ao usuário autenticado
- Números de telefone são automaticamente formatados e validados
- Variáveis são mescladas com as variáveis existentes (não substituídas)
- Somente campos permitidos podem ser atualizados:
campaign_id,phone_number,status,variables - O campo
statuspossui valores restritos para integridade dos dados