{"openapi":"3.1.0","info":{"title":"SoftSales CRM - Entrada de Leads","version":"1.0.0","description":"API idempotente para criar ou atualizar leads em um funil do SoftSales CRM."},"servers":[{"url":"http://teste.softsales.com.br"}],"paths":{"/api/v1/inbox/{endpointId}":{"post":{"summary":"Criar ou atualizar um lead","security":[{"bearerAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncomingLead"},"example":{"external_id":"meta-123456","name":"Maria da Silva","cpf_cnpj":"123.456.789-00","email":"maria@empresa.com.br","phone":"+55 11 99999-9999","company":"Empresa Exemplo","source":"Meta Ads","value":1500,"tags":["campanha-julho"],"tracking":{"utm_source":"facebook","utm_campaign":"julho"}}}}},"responses":{"200":{"description":"Lead atualizado ou requisição repetida"},"201":{"description":"Lead criado"},"400":{"description":"Dados inválidos"},"401":{"description":"Token ausente ou inválido"},"409":{"description":"Conflito de idempotência"},"429":{"description":"Limite temporário de requisições excedido"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"IncomingLead":{"type":"object","required":["name"],"properties":{"external_id":{"type":"string","maxLength":200},"name":{"type":"string","maxLength":200},"cpf_cnpj":{"type":["string","null"],"maxLength":40,"description":"CPF ou CNPJ do lead. Também são aceitos os campos document, cpf ou cnpj."},"email":{"type":["string","null"],"format":"email"},"phone":{"type":["string","null"]},"company":{"type":["string","null"]},"value":{"type":"number","minimum":0},"source":{"type":["string","null"]},"priority":{"enum":["low","normal","high","urgent"]},"tags":{"type":"array","items":{"type":"string"}},"custom_fields":{"type":"object","additionalProperties":true},"tracking":{"type":"object","additionalProperties":true}}}}}}