9. Associar Imobiliárias

En esta página

Qual a necessidade?

É necessário garantir que a imobiliária concedeu as permissões ao integrador para:

Dar a inclusão (alta), baixa ou modificação dos seus anúncios.
Publicar ou despublicar seus anúncios.
Visualizar o stock (inventário) que a imobiliária gerencia.
Visualizar os contatos da imobiliária.
Visualizar a qualidade dos seus próprios anúncios.

Também é útil para identificar como um integrador nomeia essa imobiliária.

Como a associação pode ser feita?

Para isso, recomendamos que você implemente o botão de “Login”. Este botão permitirá realizar a associação imediatamente e sem intermediários.

Como posso implementar o botão Login?

A informação dos nossos clientes é muito valiosa para a Open. Por isso, além das suas credenciais, você precisará contar com a permissão de cada imobiliária para poder administrar seus dados.

É muito simples obter essa autorização. Em apenas 2 passos, seus clientes poderão autorizar-se automaticamente a partir do seu sistema.

PRIMEIRO: Adicione no HTML um elemento div dentro do seu sistema, com o id opennavent, onde você deseja que o botão apareça

SEGUNDO: De acordo com o país da sua integração, adicione no rodapé do HTML a referência ao javascript de ativação.

Na Argentina

No restante da América Latina

No Brasil

Parâmetros Requeridos:

Parâmetro	Descrição
Integrador	O parâmetro “INTEGRADOR” será fornecido pela equipe de suporte no momento em que você indicar suas credenciais.
Codigo Inmobiliaria	O parâmetro “CODIGOINMOBILIARIA” pode ser qualquer tipo de valor fornecido pelo seu sistema, que identifique a imobiliária.

ATENÇÃO: Você deve assegurar-se de que este dado seja único.

RECOMENDAÇÃO: Utilize um email ou código interno do cliente no seu sistema.

Parâmetros Opcionais

Parâmetro	Descrição
width:	Define a largura da imagem do botão “Login”.
height:	Define a altura da imagem do botão “Login”.

Push de Confirmação

Uma vez que a ativação seja realizada, podemos efetuar um push para o endereço que você indicar para assegurar que a mesma foi concluída corretamente.

A URL de push deve ser fornecida ao suporte quando você desejar utilizar o botão “Login”.

Exemplo:

"https://domain.com/activacion_opennavent.php?codigo=@@code@@"

Sobre o Push de Confirmação

Tenha em mente que, quando o integrador realiza uma ativação, a URL de push deve suportar um método GET, visto que é dessa forma que a Open envia a informação do codigoInmobiliaria verificado. O @@code@@ será o que será substituído pelo codigoInmobiliaria que o próprio integrador enviou.

Da mesma forma, e por se tratar de um

método GET

, não será remetido nenhum

body

. É importante que a sua

URL de PUSH

interprete o valor codigo para identificar a imobiliária associada ao usar o botão

“Login”

Como Funciona o Botão “Login”?

Para poder ativar a integração, o usuário deve ter as permissões necessárias:

Os usuários com permissões de administrador ou supervisor poderão realizar esta ação.
No caso de o usuário ser administrador de uma imobiliária com várias sucursais, será solicitado que ele selecione uma delas no momento da associação.
Qualquer outro tipo de usuário não poderá ativar a integração.

Como segunda ação, simulamos uma mensagem de um possível cliente no portal. O integrador é notificado do evento e nos envia a solicitação com a seguinte mensagem: