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

Plataforma API de recepção de leads parceiros (alias 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
Groupe Pichet
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
  • Integrei a primeira API parceira: VotreAppartementNeuf
  • Estabeleci a arquitetura do PSR: recepção, normalização e roteamento
  • No lado da segurança, configurei as credentials do Microsoft API Manager para o CRM comercial
  • Para supervisionar a plataforma, instalei o SOFT Monitor e as notificações de alerta por email
Fase 2
Integração Rapida de Parceiros
Jun - Dez 2022
  • Integrei a API SeLoger, o principal portal imobiliário
  • No lado do marketing, integrei a API Myopla
  • Conectei a Cooper Advertising e implantei a integração em pre-produção
  • Em paralelo, integrei Akrivia Leads e Visibilitie
  • Em dezembro de 2022, integrei a API Clovis
  • Para enriquecer os leads, adicionei os campos "Commentaire" e "Apport" na API
Fase 3
Estabilizacao & Evolucoes
Jan - Fev 2023
  • Integrei a API Fine Media, o último parceiro documentado
  • No lado da qualidade, resolvi anomalias de roteamento e tratei leads bloqueados
  • Migrei todas as URLs da camada de roteamento de marketing da v6 para a v7
  • Em um incidente complexo, diagnostiquei e resolvi uma anomalia de roteamento entre sistemas
  • Para proteger a plataforma, conduzi uma revisão formal de segurança da infraestrutura
Fase 4
Refatoração Arquitetural
2024
  • Liderei a refatoração maior do PSR em torno de uma nova arquitetura API SeLoger
  • No lado do roteamento de marketing, redesenhei a camada de integração API
  • Para ganhar robustez, melhorei a gestão de erros, a lógica de retry e a observabilidade
  • Para garantir a continuidade da equipe, documentei o playbook completo de integração de parceiros

Os Atores - As Interacoes

Com quem interagi diretamente e como orquestrei a colaboração

Como coordenei marketing, TI e parceiros externos

Conduzi o projeto PSR na interseção de marketing, TI e parceiros externos. Para cada nova integração de parceiro, coordenei 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 confirmação de roteamento de leads). Atuei como ponto de contato técnico único para todas as integrações de parceiros.

  • Franck C. (Gerente) - Com ele, validei as integrações e priorizei o backlog de onboarding de parceiros.
  • Cyril M. (SI Marketing) - Com ele, coordenei as specs técnicas e os requisitos de negócio com os parceiros.
  • Emilie D. (Prestataire externe) - Com ela, mantive a documentação Confluence PSR e a base de conhecimento.
  • Parceiros externos (SeLoger, Myopla, Cooper...) - Com eles, reuni specs API e credentials de teste, e validei cada integração antes do go-live.
Liderança Técnica & Transferencia de Conhecimento
  • Documentei no Confluence o playbook completo de integração de parceiros.
  • Mantive a documentação API em 5 versões (v1 a v5).
  • No lado dos parceiros externos, treinei as equipes em specs API, autenticação e procedimentos de teste.

Os Resultados

Impacto para mim e para a empresa

Para mim - Competências adquiridas e reforçadas graças a este projeto
  • Construí expertise em escala empresarial nos padrões de integração API (auth, normalização, roteamento, gestão de erros).
  • No lado da postura, aprendi a orquestrar um ecossistema multi-stakeholder entre marketing, TI e parceiros externos.
  • Assumi o ownership de uma plataforma crítica onde cada falha impactava diretamente o comercial.
  • Este projeto mudou minha forma de trabalhar: agora raciocino em termos de 'ponto único de responsabilidade' e invisto em ferramentas de monitoramento desde o primeiro dia em qualquer plataforma crítica.
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

Como julgo este projeto com o recuo

O que funcionou e por que
  • Adotei uma abordagem parceiro por parceiro: cada integração validada antes da seguinte, zero perda grave de leads.
  • Com o APIM como gateway, isolei as credentials, gerenciei o throttling e evitei qualquer acesso direto dos parceiros aos sistemas internos.
  • No lado do monitoramento em tempo real, o dispositivo que instalei faz os problemas aparecerem em minutos em vez de dias.
  • Construí uma camada de normalização que unifica dezenas de formatos heterogêneos em um único schema compatível com o CRM.
O que poderia ter sido melhor
  • Na migração v6 para v7, tive que fazer atualizações manuais de URL em cada configuração de parceiro - eu poderia ter automatizado mais.
  • Na deduplicação, fiquei básico e os casos limites exigiam revisão manual que eu poderia ter automatizado.
  • Nos testes de integração ponta a ponta, não automatizei o suficiente - o processo permaneceu manual e demorado.
  • Produzi muitas vezes a documentação depois em vez de durante o desenvolvimento, e teria ganhado em escrevê-la continuamente.
Trade-offs & Arbitragens Técnicas

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

Entreguei intencionalmente uma deduplicação básica para cumprir o prazo dos 6 parceiros e planejei a implementação adequada para 2024.

Recusa de contornar a camada de roteamento de marketing

Preservei a rastreabilidade e o workflow comercial em vez de economizar 200 ms no caminho.

Endpoints dedicados por parceiro

Aceitei mais código para manter cada integração isolada e fácil de debugar.

Sem fila de retry assíncrono na Fase 1

Comecei em modo síncrono para um monitoramento simples e adicionei o retry na Fase 4.

Os ensinamentos duradouros que este projeto me trouxe
  • Aprendi que em gestão de leads, a velocidade importa tanto quanto a precisão - os leads esfriam rápido.
  • Vi que uma camada de API gateway (como APIM) é essencial diante de múltiplos parceiros externos.
  • Medi que a validação parceiro por parceiro com o negócio é inegociável, mesmo para integrações tecnicamente idênticas.
  • Constatei que um bom playbook de onboarding sobrevive ao seu autor - é o investimento mais rentável para a continuidade da equipe.

Trajetória relacionada

Experiência profissional ligada a está 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