API de Integração de Leads com ImobiBrasil: Documentação
Esta documentação se destina a desenvolvedores de portais imobiliários e CRMs que desejam integração com a ImobiBrasil.
Este post serve como um guia completo para a integração da API de leads com ImobiBrasil. Aqui você encontrará informações sobre como enviar dados de leads para nosso sistema.
Endpoint
Para enviar dados de leads, faça uma requisição POST para o seguinte endpoint:
POST https://admin01.imobibrasil.net/feed/integracao_leads_imobibrasil/integracao_api.php
Headers
Inclua os seguintes headers na sua requisição:
Content-Type: application/json
token: Seu_Token_Aqui
Corpo da Requisição
O corpo da requisição deve conter um objeto JSON com as seguintes propriedades:
nome
(string): Nome do lead.
email
(string): E-mail do lead.
telefone
(string): Telefone do lead.
mensagem
(string): conteúdo da mensagem ou descrição.
referencia
(string): Referência do imóvel no CRM ImobiBrasil.
origem
(string): Origem do lead (dado fornecido pela imobibrasil para os parceiros integrados).
website
(string): Website da imobiliária ou corretor cliente ImobiBrasil.
Exemplo de Corpo da Requisição
{
"nome": "Maria José João",
"email": "testecnm@teste.com.br",
"telefone": "(99) 99999-9999",
"mensagem": "Mensagem de teste de um lead",
"referencia": "CASA23",
"origem": "ChavesNaMao",
"website": "www.siteparaconstrutora.com.br"
}
Exemplos de Resposta
Resposta de Sucesso (HTTP 200)
{
"status": true,
"data": "Lead Inserido com sucesso."
}
Resposta de Erro – Token Inválido (HTTP 400)
{
"status": false,
"errors": ["Token inválido."]
}
Resposta de Erro – Dados Inválidos (HTTP 400)
{
"status": false,
"errors":
[
"Informe o nome do contato.",
"O campo nome tem que ser no máximo 70 caracteres."
]
}
Resposta de Erro – Autenticação (HTTP 401)
Sem corpo de resposta.
Resposta de Erro Interno (HTTP 500)
Sem corpo de resposta.
Como obter um token
O envio de leads para o sistema ImobiBrasil é destinado apenas para portais parceiros e ferramentas que desejam integrar conosco, por exemplo, portais imobiliários e sistemas de CRM. Para obter um token de acesso entre em contato com nosso suporte em: contato@imobibrasil.com.br
Sou cliente ImobiBrasil, posso usar essa API exclusivamente para conectar os funis de conversão da minha imobiliária?
No momento não, porém estamos trabalhando para disponibilizar uma integração exclusiva via API destinada aos clientes ImobiBrasil. Caso tenha dúvidas ou sugestões entre em contato.
Exceções e Regras
Todos os campos são obrigatórios.
O token deve ser válido e ativo.
O website informado deve existir no sistema.
O cadastro não deve estar bloqueado no sistema.