O que você precisa para integrar
Para cada tipo de integração, o que você precisa ter em mãos, o que a imobiliária fornece e onde achar cada coisa.
Escolha o que você quer fazer. Cada linha diz o que é necessário e leva à página com o passo a passo.
| Quero… | Preciso de… | Detalhes |
|---|---|---|
| Mostrar os imóveis no site da imobiliária | Uma chave de API (gerada pela imobiliária) e um servidor onde o site possa guardá-la. | API pública e guia para montar um site |
| Receber contatos do site no funil de vendas | A mesma chave de API e um formulário no site com nome e telefone. | Enviar contatos |
| Conectar o WhatsApp da imobiliária | O número da imobiliária, o celular com o WhatsApp para ler o QR code e a conta no provedor de WhatsApp. | |
| Cobrar por boleto e PIX e fazer repasses | A conta da imobiliária no Asaas e uma chave de API dessa conta. | Asaas |
| Atender os primeiros contatos com IA | O WhatsApp conectado e uma chave de API do provedor de IA (Google Gemini), da própria imobiliária. | Agente de IA |
#Integração do site: o essencial
- Chave de API: quem administra a conta da imobiliária na Zariv a gera em Configurações › API & Integrações. Ela aparece uma única vez, então peça para guardá-la com segurança e enviá-la a você por um canal seguro (nunca por mensagem aberta ou e-mail sem proteção). Veja Autenticação.
- Um servidor para o site: a chave não deve ficar no navegador do visitante. Sites estáticos puros precisam de uma função de backend ou de um servidor intermediário.
- Endereço da API:
https://web.zariv.com.br/api/public/v1. - Imóveis cadastrados: o site mostra o que a imobiliária cadastrou. Para testar, peça que ao menos um imóvel esteja disponível.
#Como testar
- Use o painel Testar agora das páginas da API com a chave recebida.
- Importe o OpenAPI no Postman ou no Insomnia.
- Envie um contato de teste pelo formulário do site e peça à imobiliária que confirme que ele chegou.
#Integração com WhatsApp e Asaas: o essencial
- As contas são da imobiliária. Ela contrata o provedor de WhatsApp e a conta Asaas, e informa as chaves na Zariv.
- Webhooks: os dois serviços avisam a Zariv por um endereço com segredo. A Zariv mostra o endereço pronto na tela da integração, é só colar no provedor.
- Teste antes de produção: o Asaas tem ambiente de testes (sandbox).