Guia de configuração: integrações com sites

1. Antes de começar

Um plano Pro. O widget de anúncios, o botão para moradores, os botões prontos, os QR codes e os feeds de dados fazem parte do RentMerchant Pro. Links simples e sua página gratuita do RentMerchant funcionam em todos os planos. Faça o upgrade em Cobrança na sua conta.
Um endereço de e-mail confirmado. Anúncios e widgets só carregam para contas verificadas.
Acesso para editar seu site. Você precisa poder adicionar um elemento de página no seu criador de sites. Alguns criadores só permitem código personalizado nos planos pagos; as passos da ferramenta de criação de sites abaixo dizem onde.

2. Encontre seu código

Entre em app.rentmerchant.com.
Abra Configurações e depois a aba Integrações.
Clique em uma opção para abri-la e use o botão Copiar código dela. Seu código já contém o nome da sua conta, então cole exatamente como copiou.

Nos exemplos desta página, your-name representa o nome da sua conta. Sempre copie seu código real da página Integrações em vez de digitar estes de novo.

3. Adicione seus anúncios de imóveis

O widget mostra os imóveis que você anuncia. Nada é anunciado até você ativar, um imóvel por vez.

Abra Anúncios (em Locação). Todas as suas unidades estão lá. Um imóvel sem unidades mostra um botão Criar anúncio.
Clique em Editar em um imóvel e preencha quartos, banheiros, pés quadrados, aluguel mensal, depósito, a data em que fica disponível (deixe em branco para "disponível agora"), animais e uma descrição.
Envie até 12 fotos. A primeira foto é a capa; use as setas para reordenar. Os dados de localização são removidos de todas as fotos automaticamente.
Marque Anunciar este imóvel publicamente e clique em Salvar anúncio.

Quando um imóvel for alugado, clique em Retirar anúncio na página Anúncios. Ele some do seu site em até cinco minutos, sem precisar mudar código.

Cada anúncio também ganha uma página própria com galeria de fotos e um botão Candidatar-se a este imóvel. O formulário de solicitação abre com aquele imóvel já selecionado, e as solicitações chegam na sua aba Solicitações.

Mostra seus imóveis anunciados como cartões com foto, aluguel, quartos, banheiros e disponibilidade. Os visitantes clicam em um cartão para abrir a página do anúncio.

Opção A: código do widget (recomendado)

Se ajusta à largura da sua página e cresce conforme seus anúncios. Cole onde os anúncios devem aparecer:

<div data-rentmerchant-listings="your-name"></div>
<script src="https://app.rentmerchant.com/embed/v1/listings.js" async></script>

Opção B: iframe

Para criadores que não permitem scripts. É uma caixa de altura fixa com rolagem:

<iframe src="https://app.rentmerchant.com/embed/listings/your-name" title="Available rentals"
        loading="lazy" style="width:100%;height:900px;border:0"></iframe>

Se o seu criador permitir um script ao lado, use a versão com tamanho automático da página Integrações. Ela adiciona uma linha que deixa a caixa exatamente da altura dos seus anúncios.

5. Botão flutuante para moradores

Adiciona um botão Moradores no canto inferior de todas as páginas. Ele abre um pequeno menu: Login do morador, Pagar aluguel, Enviar um pedido de manutenção, Candidatar-se agora e Imóveis disponíveis (cada um aparece só quando se aplica à sua conta). Cole uma vez, na área do seu criador que adiciona código a todas as páginas (normalmente chamada de código do site inteiro, código do rodapé ou injeção de código):

<script src="https://app.rentmerchant.com/embed/v1/resident-button.js" data-rentmerchant-site="your-name" async></script>

Se o seu criador não tiver uma área de código para o site inteiro, cole em cada página onde você quiser o botão.

6. Botões e links

Botões: na seção Botões de Integrações, marque os botões que você quer, escolha uma cor, confira a prévia e copie o código. Os botões são links simples com estilo, então funcionam em qualquer criador que aceite HTML, incluindo newsletters por e-mail.

Links (todos os planos): copie qualquer link para o menu de navegação do seu site, o rodapé, um perfil de rede social ou a assinatura do seu e-mail. Na maioria dos criadores: abra o editor de menu, adicione um item link e cole o endereço.

7. Códigos QR

Na seção de QR codes, clique em Baixar PNG abaixo do código que você quer. Imprima numa placa de "Aluga-se" (use Imóveis disponíveis ou Candidatar-se agora), num aviso da lavanderia (Pagar aluguel ou Manutenção) ou no seu kit de mudança. Imprima com pelo menos 2,5 cm (1 polegada) de largura e escaneie com seu próprio celular antes de imprimir um lote.

8. Passo a passo para a sua ferramenta de criação de sites

Os criadores de sites mudam os menus de vez em quando. Se um nome abaixo não for exatamente igual, procure o elemento chamado HTML, Embed ou Code.

Wix

Anúncios ou botões: no Editor, clique em Adicionar elementos (+), depois em Embed Code, depois em Embed HTML. Escolha Código, cole e clique em Atualizar. Arraste a caixa até o tamanho que você quiser.
Botão do morador: vá em Configurações do seu site, depois em Custom Code (em Avançado), clique em Adicionar código personalizado, cole e escolha Todas as páginas e Body, final. O Wix só oferece Código personalizado em sites com domínio conectado e plano pago.
Publique seu site.

Squarespace

Anúncios ou botões: edite a página, clique em um ponto de inserção, escolha Código, cole e confira se Display Source está desligado.
Botão do morador: abra Configurações, depois Developer Tools (ou Avançado), depois Code Injection, e cole em Rodapé.
Scripts em blocos de Código e em Code Injection exigem um plano do Squarespace que inclua código personalizado. Se o código do widget não funcionar, use a opção iframe.

WordPress

Anúncios ou botões: edite a página, clique em +, adicione um bloco Custom HTML, cole e atualize a página.
Botão do morador: use a configuração de código de rodapé do seu tema, se houver, ou um plugin de código de cabeçalho e rodapé (por exemplo, o WPCode), e cole no rodapé.
No WordPress.com (o serviço hospedado), os scripts só funcionam em planos que permitem plugins e código personalizado. Nos outros planos, use a opção de iframe e os botões.

GoDaddy Websites + Marketing

Edite seu site, clique em Adicionar seção, procure por HTML e adicione.
Cole seu código na caixa de código personalizado da seção e clique em Pronto. A opção iframe é a mais confiável aqui.
Para o botão para moradores, procure em Configurações do seu site o código para o site inteiro. Se o seu plano não tiver isso, adicione os botões nas suas páginas.

Weebly (Square Online classic)

Anúncios ou botões: arraste um elemento Embed Code para a página, clique nele, escolha Edit Custom HTML e cole.
Botão do morador: Configurações, depois SEO, e cole em Footer Code.

Webflow

Anúncios ou botões: arraste um elemento Code Embed para a página e cole.
Botão do morador: Configurações do site, depois Código personalizado, e cole em Código do rodapé. Publique.
O Webflow exige um plano pago do site para código personalizado.

Um site personalizado ou feito à mão

Cole o código do widget onde os anúncios devem aparecer e o botão de moradores logo antes da tag de fechamento </body>. Ou use os Feeds JSON para criar seu próprio design.

9. Referência de opções

Atributo	Funciona em	O que faz
data-limit="3"	Widget de anúncios	Mostrar só os primeiros imóveis (os disponíveis mais cedo primeiro).
data-accent="#0f766e"	Widget de anúncios, botão para moradores	Sua própria cor, como um código hexadecimal de seis dígitos. O padrão é o índigo do RentMerchant.
data-position="left"	Botão do morador	Coloque o botão no canto inferior esquerdo em vez do direito.
data-label="Tenants"	Botão do morador	Altere o texto do botão (até 24 caracteres).
?accent=0f766e	Endereço do iframe	Sua cor para a versão iframe, adicionada ao fim do endereço.

Exemplo, um widget mostrando três imóveis em verde-azulado:

<div data-rentmerchant-listings="your-name" data-limit="3" data-accent="#0f766e"></div>
<script src="https://app.rentmerchant.com/embed/v1/listings.js" async></script>

10. Para desenvolvedores web: feeds JSON

Dois feeds públicos e somente leitura trazem os mesmos dados dos widgets. Não é preciso chave, requisições de outras origens são permitidas e as respostas ficam em cache por cinco minutos.

GET https://app.rentmerchant.com/r/your-name/listings.json
GET https://app.rentmerchant.com/r/your-name/links.json

Cada item em listings inclui:

{
  "id": 476,
  "title": "Capitol Flats · Unit 102",
  "city": "Columbus, OH",
  "rent": "$1,950/mo",          "rent_amount": 1950,
  "deposit": "$1,950",
  "facts": ["2 bed", "1 bath", "880 sq ft"],
  "bedrooms": 2, "bathrooms": 1, "square_feet": 880,
  "available": "Available now", "available_on": null,
  "pets": "Cats OK",
  "description": "Bright corner two bedroom...",
  "photos": [{ "url": "...", "thumb": "...", "w": 2000, "h": 1500 }],
  "url": "https://app.rentmerchant.com/r/your-name/listings/476",
  "apply_url": "https://app.rentmerchant.com/apply/...?unit=476"
}

Exiba o texto exatamente como fornecido e crie links para url e apply_url em vez de montar seu próprio formulário de solicitação. O endereço completo só aparece na página do anúncio, não no feed. links.json retorna seu nome, a cor de destaque e os links para moradores (key, label, url).

11. Solução de problemas

A área do widget está em branco.: Sua ferramenta de criação de sites pode estar removendo scripts; use a opção iframe. Confira também se sua conta está no Pro e se seu e-mail está confirmado, e se o código foi colado por inteiro.
Aparece que não há imóveis disponíveis.: Abra Anúncios na sua conta e confirme que pelo menos um imóvel está marcado como anunciado. As alterações aparecem em até cinco minutos.
Aparece certo no editor, mas não no meu site publicado.: A maioria dos criadores de sites só roda scripts no site publicado, não na prévia do editor. Publique e depois confira o endereço no ar.
O iframe está cortado ou tem uma barra de rolagem.: Use a versão com tamanho automático ou aumente o valor de height no código do iframe.
O botão do morador não aparece.: Precisa estar numa área de código do site inteiro ou na própria página, e só aparece no site publicado. Se a sua conta não tiver links para mostrar, ele fica oculto.
Outra coisa?: Abra Suporte na sua conta e informe o endereço do seu site e a ferramenta usada para criá-lo. Vamos dar uma olhada.

12. Segurança e privacidade

Pagamentos e login sempre abrem no RentMerchant. Um inquilino nunca digita uma senha ou dado bancário no seu site.
Os widgets só mostram links e fotos do RentMerchant e ficam isolados do resto do código e dos estilos da sua página.
Somente os imóveis que você anuncia ficam públicos. Retirar o anúncio de um imóvel o remove de todos os lugares de uma vez.
Os dados de localização e outras informações ocultas são removidos de todas as fotos que você envia.
Se uma conta for encerrada, suspensa ou sair do Pro, os anúncios e widgets dela deixam de aparecer automaticamente.

Pronto para conectar seu site?

Entre e abra Integrações, ou veja primeiro o widget de anúncios funcionando.

Abrir Integrações Ver a demonstração ao vivo

Integrações com sites