Como gerar o Token da API de Leads e Imóveis

Visão geral

Este conteúdo detalha o processo de geração da chave de autenticação (Token) e acesso às APIs de Leads e Imóveis no CRM Superlógica. Nosso objetivo é fornecer uma orientação clara e prática para disponibilizar esses canais de integração, permitindo que desenvolvedores, sites próprios ou plataformas parceiras consultem e consumam dados do seu sistema de forma segura.

Quando usar este artigo

Utilize este guia sempre que a sua imobiliária for integrar o CRM com um site próprio ou aplicativo de terceiros, precisar fornecer credenciais de desenvolvedor para consultar a carteira de imóveis ou a lista de leads, ou quando surgirem dúvidas operacionais sobre como localizar e gerar o Token de API do sistema.

Sintoma ou cenário

• A equipe de desenvolvimento web da imobiliária solicita a API e o Token de chave privada para conectar o novo site ao CRM.

• Necessidade de extrair e sincronizar dados de imóveis ou leads com um sistema externo de BI, ERP ou automação de marketing.

• Configuração de novos canais de consumo de dados via integrações personalizadas.

Benefício para o usuário ou operação

• Conectividade Total: Permite conectar o CRM a qualquer solução externa através de endpoints padronizados de Leads e Imóveis.

• Segurança na Integração: Geração de Tokens de acesso exclusivos para garantir o controle e a privacidade dos dados da imobiliária.

• Agilidade no Desenvolvimento: Acesso direto à documentação técnica oficial das APIs para acelerar o trabalho de programadores.

Onde acessar / contexto de uso

•  No menu superior do CRM, acesse Preferências > Integrações.

Pré-requisitos (Antes de começar)

• Perfil Exato: Possuir nível de acesso como Diretor ou Gestor no CRM com permissão total de gerenciamento do módulo de integrações.

• Insumos Técnicos: Definir com clareza qual tipo de informação será consumida pela plataforma de destino (Leads ou Imóveis) e ter o nome de identificação da integração planejado.

Causas prováveis

Desenvolvimento de novo portal imobiliário próprio, conexão com aplicativos personalizados de corretores ou integração com plataformas externas de automação comercial e relatórios.

Como fazer ou corrigir

A API de Leads e Imóveis do CRM funciona como uma biblioteca onde é possível consultar as informações atualizadas do sistema. Siga as instruções abaixo para criar a integração e obter seu Token de acesso:

1.  No menu superior do CRM, acesse Preferências > Integrações.

2. No canto superior direito da tela, clique no botão Novo Registro.

3. No formulário que será aberto:

   • No campo Nome, digite uma identificação personalizada para o seu controle (ex: API Site Próprio - Imóveis ou Integração App - Leads).

   • No campo INTEGRAÇÃO*, selecione a categoria desejada:

     • API LEADS (para consulta e envio de contatos)

     • API IMÓVEIS (para consulta do catálogo de unidades e características)

4. Clique em Salvar.

5. Após o salvamento, a página será atualizada automaticamente e o campo Token de Integração passará a exibir a sua chave de acesso alfanumérica.

⚠️ Importante: O Token é a chave de segurança que autoriza o acesso aos dados da sua imobiliária. Copie o código gerado e envie-o com segurança apenas para o desenvolvedor ou plataforma responsável.

Documentação Técnica para Desenvolvedores

Caso a equipe técnica ou o programador responsável pelo processo precise das especificações dos endpoints, parâmetros e métodos de requisição, disponibilize os links da documentação oficial:

• Documentação API IMÓVEIS: Especificações de consulta de catálogo, fotos e dados da carteira. (https://documenter.getpostman.com/view/17050484/UVBzpAZ8) 

• Documentação API LEADS: Especificações de recebimento, envio e consulta de contatos e interações. (https://documenter.getpostman.com/view/20302231/Uz5CNeHd)

Resultado esperado

Ao concluir os passos e salvar o registro, o sistema processará a solicitação e gerará o Token de API com sucesso. A chave ficará disponível na tela de Integrações Personalizadas e a API estará pronta para responder às requisições do desenvolvedor responsável.

Quando escalar

Acione o suporte técnico se o Token de integração não for gerado após clicar em salvar, se as chamadas da API retornarem erro de autenticação (código 401/403) mesmo utilizando o Token correto, ou se os endpoints indicarem indisponibilidade de servidor.

Informações que devem ser reunidas antes do escalonamento

Para que nosso time de suporte técnico atue com agilidade no diagnóstico da sua API, reúna:

• Nome e e-mail de login do usuário Administrador no CRM.

• Captura de tela (print) do registro em Integrações Personalizadas mostrando o nome e o tipo de API criada.

• O Token de Integração utilizado no teste.

• Exemplo do payload ou da requisição/endpoint que apresentou erro no ambiente do desenvolvedor.

• Data e horário em que os testes de chamada da API foram realizados.

Regras importantes / Observações

• Guarda Segura do Token: Nunca compartilhe seu Token em fóruns públicos. Ele dá acesso de leitura e/ou escrita aos dados da sua carteira e clientes.

• Chaves Individuais: Recomenda-se criar um registro (Token) diferente para cada sistema externo que for conectar ao CRM para facilitar auditorias e eventuais revogações de acesso.

Problemas comuns e como resolver

• Problema: O botão de salvar em "Integrações Personalizadas" fica inativo.

  • Causa provável: O tipo de integração não foi marcado no campo obrigatório ou o campo de nome está vazio.

  • Ação recomendada: Preencha o campo "Nome" e selecione expressamente uma das opções no campo "INTEGRAÇÃO*" antes de salvar.

• Problema: A requisição do desenvolvedor retorna erro de "Acesso Não Autorizado" (401/403).

  • Causa provável: O Token enviado no cabeçalho (header) da requisição está incompleto ou foi copiado com espaços em branco adicionais.

  • Ação recomendada: Copie novamente o Token gerado no CRM, certificando-se de não selecionar espaços antes ou depois do código, e revise a estrutura do header de autenticação na aplicação.

Dúvidas relacionadas

• P: Como conferir se a ação em 'Como gerar nossa API de Leads/Imóveis para integração?' foi validada em sistema?

  R: Acesse a lista em "Integrações Personalizadas" e confirme se o registro da API está salvo exibindo o código do Token no painel.

• P: Restrições de acesso implicam no salvamento dessa rotina?

  R: Sim. Apenas usuários que possuem nível de permissão de Gestão ou Administração no CRM conseguem criar registros e visualizar Tokens de API.

Precisa de suporte ou ficou com alguma dúvida?

Nossa equipe está super a postos para te ajudar a conectar suas APIs e apoiar o desenvolvimento das suas integrações! Se precisar de auxílio com a geração do Token ou com a documentação, é só chamar a gente no WhatsApp:

WhatsApp Suporte: (11) 91573-4091 🚀

Atendimento de segunda a sexta-feira, em horário comercial.

Palavras-chave de busca

Como gerar nossa API de Leads/Imóveis para integração?, gerar_api_leads_imoveis, token_de_integracao_crm, api_imoveis_arbo, api_leads_arbo, integracoes_personalizadas, suporte superlógica, ajuda, manual.