Contato
Plataforma API de recepção de leads parceiros (PSR)

Plataforma API de recepção de leads parceiros (PSR)

Plataforma API centralizada que roteia leads imobiliários de dezenas de portais parceiros para o CRM comercial.

Fevereiro 2021 - 2024
~3 anos
Project Manager / Product Owner - Responsável pela Plataforma API
REST APIMicrosoft APIMAdobe Campaign v7Dynamics 365AWS EKSKubernetesK8sDockerGitLab CIJira

APIs Parceiras

Dezenas

Integradas e mantidas

Volume de Leads

~**K/day

~1 lead a cada 2 segundos em pico

Taxa de Perda

~0%

Zero incidentes graves de perda

Tempo de Integração

weeks -> days

Reduzido de semanas para dias

Apresentacao

Definicao e escopo do projeto

O projeto em poucas palavras

O PSR é a plataforma API centralizada de recepção de leads parceiros que eu pilotei. Cada parceiro se conecta via um endpoint API dedicado, que normaliza os dados e os transmite ao CRM comercial através da camada de roteamento de marketing e do Microsoft API Manager (APIM).

Como Technical Lead e responsável pela plataforma API, supervisionei a integração de cada nova API parceira e as evoluções funcionais da plataforma, coordenando com as equipes de marketing e os prestadores técnicos externos. O PSR e um sistema crítico para o negócio: cada lead perdido ou mal roteado se traduz diretamente em uma oportunidade comercial perdida em um mercado imobiliário altamente competitivo.

O que e a plataforma

Plataforma API REST centralizada para recepção, normalização e roteamento multi-parceiro de leads

Dominio de negócio

Imobiliário / PropTech - Gestão de Leads (B2B interno + B2B parceiros externos)

Escopo Funcional
  • APIs REST padronizadas por parceiro.
  • Normalização dos leads seja qual for o formato do parceiro.
  • Roteamento para o CRM comercial.
  • Detecção de anomalias: leads bloqueados, duplicatas, erros de formato.
  • Credentials e acessos API centralizados via APIM.
  • Monitoramento em tempo real da qualidade dos leads com alertas.
Decisões Arquiteturais Chave

API Gateway gerenciado

OAuth, throttling e analytics por parceiro nativamente, em vez de reconstruir tudo internamente.

Roteamento via camada de enriquecimento de marketing

Enriquecimento e deduplicação antes da injeção no CRM, para preservar o workflow comercial.

Um endpoint dedicado por parceiro

Lógica de normalização isolada, debug mais simples, sem configuração runtime complexa.

Objetivos, Contexto, Desafios & Riscos

Visao estratégica e restricoes

Objetivos e critérios de sucesso
  • 1Integrar dezenas de parceiros externos sem desenvolvimento customizado no CRM por parceiro.
  • 2Manter zero incidente grave de perda de leads durante e após cada onboarding.
  • 3Reduzir o tempo de integração de um novo parceiro de semanas para dias.
  • 4Garantir governança auditável de credentials e acessos para todos os parceiros.
  • 5Detectar anomalias de processamento em minutos em vez de dias.
Por que este projeto surgiu

O projeto foi iniciado dentro da equipe SI Marketing do Groupe Pichet, onde o número crescente de fontes de leads externas (portais imobiliários, parceiros de publicidade, plataformas de marketing) criou a necessidade de um ponto de entrada único para centralizar e normalizar os leads recebidos antes de rotea-los para o CRM comercial.

A paisagem existente era fragmentada: cada parceiro tinha seu proprio formato de dados, metodo de autenticacao e protocolo de entrega. Sem o PSR, a integração de um novo parceiro exigia desenvolvimento customizado no lado do CRM - uma abordagem insustentavel a medida que o ecossistema de parceiros crescia.

Desafios comerciais e estratégicos

Os leads são a forca vital da atividade comercial no setor imobiliário. Cada lead representa um potencial comprador, e o mercado e altamente competitivo: perder um lead por um erro de roteamento ou uma integração atrasada significa dar esse prospect a um concorrente. Com dezenas de parceiros gerando leads simultaneamente, o PSR se tornou o pipeline de dados mais crítico alimentando o pipeline comercial diário das equipes.

O impacto comercial era direto e mensuravel: uma API de parceiro fora do ar por um único dia poderia significar dezenas de prospects perdidos - cada um valendo potencialmente centenas de milhares de euros em vendas imobiliárias.

Segurança & Conformidade RGPD
  • Isolamento de credentials por parceiro via APIM: chaves API únicas, permissões delimitadas.
  • Rotação sistematica das chaves API via ciclo de vida APIM.
  • Conformidade RGPD: HTTPS exclusivo, sem armazenamento persistente em camadas intermediárias, CRM como único repositorio.
  • Auditoria de segurança formal durante o projeto → controles de acesso reforçados e regras de firewall atualizadas.
  • Validação no gateway: formato, tamanho de payload, rejeicao de requisicoes malformadas.
Riscos identificados no início

Perda de Leads

Qualquer falha de API ou erro de roteamento se traduz diretamente em prospects comerciais perdidos - irrecuperaveis em um mercado imobiliário competitivo.

Heterogeneidade de Formatos

Cada parceiro envia dados em seu proprio formato com diferentes campos obrigatorios, regras de validação e codificacoes.

Proliferacao de Credentials

A gestão de chaves API, tokens e acessos para dezenas de parceiros via APIM requer gestão rigorosa do ciclo de vida das credentials.

Dependência da camada de roteamento de marketing

A migração v6 para v7 da camada de roteamento de marketing exigiu mudanças de URL em todas as configurações de parceiros - um único erro poderia silenciosamente perder leads.

Pipeline do Ciclo de Vida dos Leads
Ciclo de vida completo de um lead, da fonte parceira ao CRM

As Etapas - O Que Eu Fiz

Progressao cronologica do projeto

Fase 1
Fundacao da Plataforma & Primeiro Parceiro
Fev 2021
  • Integração da primeira API parceira: VotreAppartementNeuf
  • Estabelecimento da arquitetura PSR: recepção, normalização, roteamento
  • Configuração de credentials Microsoft API Manager para o CRM comercial
  • Configuração de monitoramento com SOFT Monitor e notificacoes de alerta por email
Fase 2
Integração Rapida de Parceiros
Jun - Dez 2022
  • Integração da API SeLoger - portal imobiliário principal
  • Integração da API Myopla - parceiro de marketing
  • Integração Cooper Advertising - implantada em pre-producao
  • Integração Akrivia Leads e Visibilitie
  • Integração da API Clovis - dezembro 2022
  • Adicao dos campos "Commentaire" e "Apport" na API
Fase 3
Estabilizacao & Evolucoes
Jan - Fev 2023
  • Integração da API Fine Media - ultimo parceiro documentado
  • Resolução de anomalias de roteamento e gestão de leads bloqueados
  • Migração de todas as URLs da camada de roteamento de marketing v6 para v7
  • Diagnóstico e resolução de uma anomalia de roteamento inter-sistemas
  • Revisão formal de segurança sobre a infraestrutura da plataforma
Fase 4
Refatoração Arquitetural
2024
  • Liderança da refatoração major do PSR: nova arquitetura API SeLoger
  • Redesign da camada de integração API de roteamento de marketing
  • Melhoria da gestão de erros, lógica de retry e observabilidade
  • Documentação do playbook completo de integração de parceiros para continuidade da equipe

Os Atores - As Interacoes

Equipes, stakeholders e colaboração

Coordenando marketing, TI e parceiros externos

O projeto PSR operava na interseção de marketing, TI e parceiros externos. Cada nova integração de parceiro exigia coordenação entre a equipe técnica do parceiro (para especificações API), a equipe SI Marketing (para validação de negócio) e a equipe CRM (para confirmacao de roteamento de leads). Eu atuei como o ponto de contato técnico único para todas as integrações de parceiros.

  • Franck C. (Gerente) - Validou as integrações e priorizou o backlog de onboarding de parceiros.
  • Cyril M. (SI Marketing) - Coordenou specs técnicas e requisitos de negócio com os parceiros.
  • Emilie D. (Prestataire externe) - Manteve a documentação Confluence PSR e a base de conhecimento.
  • Parceiros externos (SeLoger, Myopla, Cooper...) - Forneceram specs API, credentials de teste e validaram as integrações antes do go-live.
Liderança Técnica & Transferencia de Conhecimento
  • Playbook de integração de parceiros documentado no Confluence.
  • Documentação API mantida em 5 versões (v1 a v5).
  • Treinamento dos parceiros externos sobre specs API, autenticacao e procedimentos de teste.

Os Resultados

Impacto para mim e para a empresa

O que eu retirei pessoalmente
  • Expertise em escala empresarial nos padrões de integração API (auth, normalização, roteamento, gestão de erros).
  • Coordenação multi-stakeholders entre marketing, TI e parceiros externos.
  • Ownership de uma plataforma crítica onde cada falha impactava diretamente o comercial.
Valor entregue ao Groupe Pichet
  • Dezenas de APIs parceiras integradas, diversificando os canais de aquisicao de leads.
  • Ponto de entrada único, eliminando a necessidade de dev customizado no CRM por parceiro.
  • Monitoramento em tempo real, reduzindo a perda silenciosa de leads de dias para minutos.
  • Onboarding de novos parceiros reduzido de semanas para dias via playbook PSR.

O Dia Seguinte

O que aconteceu após a entrega

Onde o projeto esta hoje

Após a onda inicial (2021-2023), o PSR entrou em fase de estabilização e continuou processando leads diariamente. A refatoração de 2024 modernizou a integração SeLoger e a camada de roteamento de marketing.

Hoje, o PSR permanece como o ponto de entrada único para toda a aquisicao de leads externos no Groupe Pichet. O playbook que documentei permite a equipe integrar novos parceiros de forma autônoma.

Distribuicao do Esforco Técnico

Minha Reflexao Crítica

Lições aprendidas e avaliação honesta

O que funcionou e por que
  • Abordagem parceiro por parceiro: cada integração validada antes da seguinte, zero perda grave de leads.
  • APIM como gateway: credentials isolados, throttling gerenciado, parceiros nunca tocaram sistemas internos diretamente.
  • Monitoramento em tempo real: problemas detectados em minutos em vez de dias.
  • Camada de normalização: dezenas de formatos heterogêneos unificados em um único schema compativel com CRM.
O que poderia ter sido melhor
  • A migracao v6 para v7 exigiu atualizacoes manuais de URL em cada configuração de parceiro.
  • A deduplicação ficou básica: casos limites exigiam revisao manual.
  • Os testes de integração de ponta a ponta eram manuais e demorados.
  • A documentação chegava depois em vez de durante o desenvolvimento.
Trade-offs & Arbitragens Técnicas

Dívida técnica assumida na deduplicação na Fase 2

Deduplicação básica para cumprir o prazo dos 6 parceiros; implementação adequada planejada para 2024.

Recusa de contornar a camada de roteamento de marketing

Rastreabilidade e workflow comercial preservados, em vez de ganhar 200 ms.

Endpoints dedicados por parceiro

Mais código, mas cada integração continua isolada e fácil de debugar.

Sem fila de retry assíncrono na Fase 1

Síncrono no início para monitoramento simples; retry adicionado na Fase 4.

Lições Aprendidas
  • Em gestão de leads, velocidade importa tanto quanto precisao - leads esfriam rápido.
  • Uma camada de API gateway (como APIM) e essencial com multiplos parceiros externos.
  • A validação parceiro por parceiro com o negócio e inegociavel, mesmo para integrações tecnicamente identicas.
  • Um bom playbook de onboarding sobrevive ao seu autor - e o investimento mais rentavel a longo prazo.

Trajetória relacionada

Experiência profissional ligada a esta realização

Competências aplicadas

Competências técnicas e humanas aplicadas

Galeria de imagens

Capturas e visuais do projeto

Apresentacao do comite de arquitetura Groupe Pichet com objetivos, processo de governanca e diagrama de visão do SI
Comite de arquitetura - Objetivos e governanca
Diagrama de fluxo técnico detalhado mostrando a sequencia de integração de dados de parceiros com pontos de decisão e chamadas API
Fluxo técnico - Sequencia de integração de parceiros
Diagrama de fluxo de dados legacy-para-CRM mostrando chamadas API, processamento de eventos e sincronização de banco de dados
Fluxo de dados - Processamento legacy-para-CRM
Arquitetura Azure API Management com autenticacao Active Directory, API Gateway, MongoDB, Power BI e infraestrutura Terraform
Arquitetura - Plataforma Azure API Management

Voce tem uma API de parceiros para projetar ?

Entreguei a PSR API Parceiros: autenticacao, versionamento, documentacao OpenAPI e monitoramento de uso para abertura B2B a terceiros. Vamos conversar sobre seu contexto.

Entrar em contato