Integração de Leads via API no ImobTotal

Este guia ensina como enviar leads para o sistema ImobTotal de forma automática através de requisições HTTP usando o método POST.
Isso permite integrar formulários, portais ou outros sistemas diretamente ao seu CRM.

---

1. Localizando sua Licença (CodSite)

Cada conta no ImobTotal possui um código de licença único, que será usado na URL da API.
Para encontrá-lo:

1. Clique na sua foto de perfil no canto superior direito.
2. Abaixo do seu nome, aparecerá a Licença (ex.: 207).
3. Anote esse número, pois ele será usado na URL da API.

📷 (Conforme imagem enviada por você)

---

2. Endpoint da API

O endpoint da API deve seguir este formato:

https://imob3.sobressai.com.br/importacoes/integraleads/{CodSite}

🔹 Exemplo para Licença 207:

https://imob3.sobressai.com.br/importacoes/integraleads/{CodSite}

---

3. Método e Cabeçalhos

• Método: POST
• Headers obrigatórios:

Content-Type: application/json
Authorization: Basic SUA_CHAVE_DE_AUTENTICACAO

📌 Atenção: a chave de autenticação (Authorization) é exclusiva para cada conta e deve ser copiada exatamente como aparece no seu painel.

---

4. Estrutura do Corpo da Requisição (BODY)

Envie os dados do lead em formato JSON conforme abaixo:

{
  "name": "Jhon Doe", 
  "email": "[email protected]",
  "message": "Vi seu anúncio e tenho interesse.",
  "leadOrigin": "Site",
  "phoneNumber": "5551992241234",
  "clientListingId": "CA0123",
  "id_assistente": "103"
}

---

5. Campos Explicados

Campo	Obrigatório?	Descrição
name	✅ Sim	Nome do cliente.
email	✅ Sim	E-mail do cliente.
message	❌ Opcional	Mensagem ou observação do cliente.
leadOrigin	✅ Sim	Origem do lead (ex.: “Site”, “Facebook”, “Instagram”).
phoneNumber	✅ Sim	Telefone do cliente com código do país (ex.: “55” para Brasil).
clientListingId	❌ Opcional	Código do imóvel de interesse.
id_assistente	❌ Opcional	ID do corretor/assistente que deverá receber o lead diretamente.

---

6. Exemplo em cURL

curl -X POST "https://imob3.sobressai.com.br/importacoes/integraleads/207" \
-H "Content-Type: application/json" \
-H "Authorization: Basic SUA_CHAVE_DE_AUTENTICACAO" \
-d '{
  "name": "Maria da Silva",
  "email": "[email protected]",
  "message": "Tenho interesse neste imóvel.",
  "leadOrigin": "Facebook",
  "phoneNumber": "5511998765432",
  "clientListingId": "AP102",
  "id_assistente": "103"
}'

---

7. Integração com Formulários e Portais

• Qualquer sistema que envie requisições HTTP (como WordPress, Elementor, RD Station, Zapier, Make, Google Apps Script) pode usar esse método.
• Se você já recebe leads de portais como OLX ou Viva Real, pode configurar para que eles chamem este endpoint.

---

8. Dicas e Boas Práticas

• Valide e formate o telefone antes de enviar (DDD + número, sem caracteres especiais).
• Se possível, envie sempre leadOrigin para rastrear campanhas.
• Caso utilize a Roleta de Atendimento no CRM:
  • Se id_assistente estiver vazio, o sistema seguirá as regras da roleta.
  • Se informado, o lead irá diretamente para o corretor especificado.
• Em conjunto com a IA, o lead será atendido instantaneamente enquanto o corretor é notificado.

---

9. Exemplo de Uso com Roleta + IA

📌 Cenário:

1. Um lead preenche o formulário do site.
2. O formulário envia os dados via API para o ImobTotal.
3. A roleta verifica as regras de prioridade e escolhe um corretor.
4. Simultaneamente, a IA envia a primeira mensagem para o lead.
5. O corretor pode acompanhar a conversa e entrar apenas quando necessário.

#api #integração #lead