PSR - Plataforma API Centralizada de Leads Parceiros

Plataforma API centralizada recebendo e roteando leads imobiliarios de 9+ portais parceiros externos para o CRM Hermes via Adobe Campaign - cada integracao de parceiro supervisionada de ponta a ponta, da especificacao API ao monitoramento em producao.

Fevereiro 2021 - 2024

~3 anos

Project Manager / Product Owner - Responsavel pela Plataforma API

REST APIMicrosoft APIMAdobe Campaign v7Dynamics 365AWS EKSKubernetesDockerGitLab CISOFT MonitorJira

PSR - Plataforma API Centralizada de Leads Parceiros

Fevereiro 2021 - 2024

~3 anos

Project Manager / Product Owner - Responsavel pela Plataforma API

REST APIMicrosoft APIMAdobe Campaign v7Dynamics 365AWS EKSKubernetesDockerGitLab CISOFT MonitorJira

APIs Parceiras

Integradas e mantidas

Volume de Leads

~43K/day

~1 lead a cada 2 segundos em pico

Taxa de Perda

~0%

Zero incidentes graves de perda

Tempo de Integracao

weeks -> days

Reduzido de semanas para dias

Apresentacao

Definicao e escopo do projeto

O PSR (Pichet Services Repository) e a plataforma API centralizada do Groupe Pichet para recepcao e roteamento de leads imobiliarios provenientes de portais parceiros externos. Cada portal imobiliario ou parceiro de marketing que gera prospects para a Pichet se conecta ao PSR via um endpoint API dedicado, que normaliza os dados e os transmite ao CRM Hermes (Dynamics 365) atraves do Adobe Campaign (Neolane) e do Microsoft API Manager (APIM).

Como Lead Developer e responsavel pela plataforma API, supervisionei a integracao de cada nova API parceira e as evolucoes funcionais da plataforma, coordenando com as equipes de marketing e os prestadores tecnicos externos. O PSR e um sistema critico para o negocio: cada lead perdido ou mal roteado se traduz diretamente em uma oportunidade comercial perdida em um mercado imobiliario altamente competitivo.

Natureza

Plataforma API REST centralizada para recepcao, normalizacao e roteamento multi-parceiro de leads

Dominio

Imobiliario / PropTech - Gestao de Leads (B2B interno + B2B parceiros externos)

Escopo Funcional

Expor APIs REST padronizadas para cada parceiro gerador de leads
Normalizar dados de leads (nome, email, telefone, programa, fonte) independente do formato do parceiro
Rotear leads para o CRM Hermes via Adobe Campaign (Neolane) para acompanhamento comercial
Detectar anomalias: leads bloqueados, duplicatas, erros de formato
Gerenciar credentials e acessos API via Microsoft API Manager (APIM)
Supervisionar a qualidade dos leads com alertas SOFT Monitor e notificacoes por email

Arquitetura do Sistema

PSR - System Architecture Overview

Decisoes Arquiteturais Chave

Microsoft APIM como API Gateway

Escolhido ao inves de um reverse proxy customizado para centralizar a gestao de credentials, throttling e controle de acesso para 9+ parceiros externos. O APIM fornecia nativamente OAuth, rate limiting e analitica por parceiro - desenvolver isso internamente teria levado meses e introduzido riscos de seguranca.

Adobe Campaign como intermediario de roteamento (sem injecao direta no CRM)

Os leads passam pelo Adobe Campaign (Neolane) antes de chegar ao CRM para aproveitar suas capacidades de enriquecimento e deduplicacao. A injecao direta no CRM era mais rapida mas contornaria o workflow comercial existente e perderia a camada de enriquecimento da qual a equipe de marketing dependia.

Um endpoint dedicado por parceiro (sem endpoint generico)

Cada parceiro tem formatos de dados, campos obrigatorios e regras de validacao unicos. Um endpoint generico exigiria configuracao complexa em tempo de execucao e tornaria o debug de problemas especificos de parceiros mais dificil. Endpoints dedicados mantem a logica de normalizacao isolada e testavel por parceiro.

Objetivos, Contexto, Desafios & Riscos

Visao estrategica e restricoes

Objetivos

1Expor APIs padronizadas para cada parceiro com contratos de dados consistentes
2Normalizar todos os dados de leads independente do formato especifico do parceiro
3Rotear leads de forma confiavel para o CRM Hermes via Adobe Campaign para rastreamento do pipeline comercial
4Supervisionar a qualidade do fluxo: deteccao de anomalias, leads bloqueados, filtragem de duplicatas
5Gerenciar credentials e acessos API de forma centralizada via Microsoft API Manager

Contexto

O projeto foi iniciado dentro da equipe SI Marketing do Groupe Pichet, onde o numero crescente de fontes de leads externas (portais imobiliarios, parceiros de publicidade, plataformas de marketing) criou a necessidade de um ponto de entrada unico 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 integracao de um novo parceiro exigia desenvolvimento customizado no lado do CRM - uma abordagem insustentavel a medida que o ecossistema de parceiros crescia.

Desafios

Os leads sao a forca vital da atividade comercial no setor imobiliario. Cada lead representa um potencial comprador, e o mercado e altamente competitivo: perder um lead por um erro de roteamento ou uma integracao atrasada significa dar esse prospect a um concorrente. Com 9+ parceiros gerando leads simultaneamente, o PSR se tornou o pipeline de dados mais critico alimentando o pipeline comercial diario das equipes.

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

Seguranca & Conformidade RGPD

Isolamento de credentials por parceiro via APIM: cada parceiro recebe chaves API unicas com permissoes delimitadas - nenhum parceiro pode acessar dados ou endpoints de outro
Politica de rotacao sistematica de chaves API aplicada pela gestao de ciclo de vida do APIM - credentials renovados conforme calendario para limitar a janela de exposicao
Conformidade RGPD para dados pessoais: leads contem nome, email, telefone - dados transmitidos exclusivamente via HTTPS, sem armazenamento persistente em camadas intermediarias, CRM como unico repositorio de dados
Auditoria de seguranca conduzida em fevereiro de 2023 cobrindo infraestrutura PSR, configuracao APIM e integracao Adobe Campaign - resultando em controles de acesso reforçados e regras de firewall atualizadas
Validacao de entradas no nivel gateway: verificacoes de formato, limites de tamanho de payload e rejeicao de requisicoes malformadas antes dos dados atingirem sistemas internos

Riscos

Perda de Leads

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

Heterogeneidade de Formatos

Cada parceiro envia dados em seu proprio formato com diferentes campos obrigatorios, regras de validacao e codificacoes.

Proliferacao de Credentials

A gestao de chaves API, tokens e acessos para 9+ parceiros via APIM requer gestao rigorosa do ciclo de vida das credentials.

Dependencia Adobe Campaign

A migracao do Adobe Campaign v6 para v7 exigiu mudancas de URL em todas as configuracoes de parceiros - um unico erro poderia silenciosamente perder leads.

Pipeline do Ciclo de Vida dos Leads

End-to-end lead lifecycle from partner source to CRM

As Etapas - O Que Eu Fiz

Progressao cronologica do projeto

Fase 1

Fundacao da Plataforma & Primeiro Parceiro

Fev 2021

Integracao da primeira API parceira: VotreAppartementNeuf (KESD-20158)
Estabelecimento da arquitetura PSR: recepcao, normalizacao, roteamento
Configuracao de credentials Microsoft API Manager para CRM Hermes e GED v2 (KESD-24176, KESD-25889)
Configuracao de monitoramento com SOFT Monitor e notificacoes de alerta por email

Fase 2

Integracao Rapida de Parceiros

Jun - Dez 2022

Integracao da API SeLoger (PSR-48) - portal imobiliario principal
Integracao da API Myopla (PSR-47, KESD-55205) - parceiro de marketing
Integracao Cooper Advertising (PSR-52) - implantada em pre-producao
Integracao Akrivia Leads (PSR-58, KESD-66929) e Visibilitie (KESD-67023)
Integracao da API Clovis (PSR-60, KESD-68919) - dezembro 2022
Adicao dos campos "Commentaire" e "Apport" na API (PSR-54, KESD-61307)

Fase 3

Estabilizacao & Evolucoes

Jan - Fev 2023

Integracao da API Fine Media (KESD-71757) - ultimo parceiro documentado
Correcao de codigos de acao e status de leads bloqueados (PSR-51)
Migracao de todas as URLs do Adobe Campaign v6 para v7 (PSR-56)
Investigacao e resolucao da anomalia Investimeo PSR vs Neolane (PSR-59)
Reuniao de auditoria de seguranca para infraestrutura PSR (fev 2023)

Fase 4

Refatoracao Arquitetural

2024

Lideranca da refatoracao major do PSR: nova arquitetura API SeLoger
Redesign da camada de integracao Adobe Campaign API
Melhoria da gestao de erros, logica de retry e observabilidade
Documentacao do playbook completo de integracao de parceiros para continuidade da equipe

APIs de Parceiros Integradas

Partner	Jira Ticket	Period	Status
VotreAppartementNeuf	KESD-20158	Feb 2021	Active
SeLoger	PSR-48	Jun 2022	Active
Myopla	PSR-47	Jun 2022	Active
Cooper Advertising	PSR-52	Oct 2022	Pre-prod
Akrivia Leads	PSR-58	Nov 2022	Active
Visibilitie	KESD-67023	Nov 2022	Active
Clovis	PSR-60	Dec 2022	Active
Fine Media	KESD-71757	Jan 2023	Active
Investimeo	PSR-59	2022	Investigated

Cronograma de Integracao de Parceiros

Integracoes de Parceiros por Ano

Processo de Integracao de Parceiro

Step-by-step process for each partner integration

Os Atores - As Interacoes

Equipes, stakeholders e colaboracao

O projeto PSR operava na interseccao de marketing, TI e parceiros externos. Cada nova integracao de parceiro exigia coordenacao entre a equipe tecnica do parceiro (para especificacoes API), a equipe SI Marketing (para validacao de negocio) e a equipe CRM (para confirmacao de roteamento de leads). Eu atuei como o ponto de contato tecnico unico para todas as integracoes de parceiros.

Lideranca Tecnica & Transferencia de Conhecimento

Elaboracao do playbook completo de integracao de parceiros no Confluence - um guia passo a passo permitindo que qualquer membro da equipe integre um novo parceiro de forma autonoma, desde a configuracao de credentials APIM ate o monitoramento em producao
Conducao de meetups tecnicos internos sobre padroes de integracao API, compartilhando licoes aprendidas durante o onboarding de parceiros com a equipe SI ampliada
Producao e manutencao da documentacao API em 5 versoes (v1 a v5), servindo como referencia para equipes internas e parceiros externos
Treinamento das equipes tecnicas de parceiros externos sobre especificacoes da API PSR, fluxos de autenticacao e procedimentos de teste durante cada ciclo de onboarding
Definicao dos padroes de qualidade de codigo para o codebase PSR: padroes de validacao, convencoes de gestao de erros e praticas de logging adotadas pela equipe SI Marketing

Franck C.

Gerente N+1

Validacao de cada integracao de parceiro, aprovacao de implantacoes em producao e priorizacao do backlog de integracao.

Cyril M.

Equipe SI Marketing

Coordenacao com parceiros externos sobre especificacoes tecnicas, formatos de dados e requisitos de negocio.

Emilie D.

Equipe Kariba

Manutencao das paginas de documentacao Confluence PSR, contribuicao para a base de conhecimento.

Parceiros Externos

SeLoger, Myopla, Cooper, Akrivia, Clovis, Fine Media...

Fornecimento de especificacoes API, credentials de teste e validacao de testes de integracao antes do go-live em producao.

Os Resultados

Impacto para mim e para a empresa

Para Mim

Aprofundamento da expertise em padroes de integracao API: autenticacao, normalizacao, roteamento, gestao de erros em escala empresarial
Dominio da plataforma Microsoft API Manager para gestao de credentials e acessos
Desenvolvimento de fortes habilidades de coordenacao na interseccao de marketing, TI e parceiros externos
Experiencia adquirida no dominio de gestao de leads: qualidade de dados, deduplicacao, estrategias de roteamento CRM
Construcao de confianca na responsabilidade por uma plataforma critica onde cada falha tinha impacto comercial direto

Para a Empresa

9+ APIs parceiras integradas → diversificacao dos canais de aquisicao de leads alimentando o pipeline comercial
Ponto de entrada centralizado → eliminacao da necessidade de desenvolvimento customizado no CRM por parceiro
Formato de dados padronizado → qualidade consistente de leads independente da fonte, melhorando a eficiencia comercial
Monitoramento em tempo real → deteccao imediata de anomalias, reduzindo a perda de leads a quase zero
Arquitetura escalavel → integracao de novos parceiros reduzida de semanas para dias com o playbook PSR
Refatoracao 2024 → plataforma preparada para o futuro com novas integracoes SeLoger e Adobe Campaign

Estrategia de Monitoramento & Observabilidade

Dashboard SOFT Monitor com gauges KPI em tempo real rastreando a saude do fluxo de leads de 9+ parceiros simultaneamente
Alertas de email automatizados acionados em anomalias de processamento de leads: leads bloqueados, falhas de validacao de formato, timeouts de API de parceiros e erros de roteamento
Rastreamento de fluxo por parceiro: cada API parceira tem monitoramento individual com logs de transacao, taxas de sucesso/falha e tendencias de volume
Deteccao proativa de anomalias: mudancas de formato dos parceiros (adicoes de campos, alteracoes de codificacao) detectadas na camada de validacao antes de impactar sistemas downstream
Resposta a incidentes de producao: o monitoramento permitiu deteccao em menos de um minuto de quedas de parceiros, reduzindo a perda silenciosa de leads de dias para minutos

Competencias Demonstradas

Competencias Tecnicas

Design de API & Padroes de Integracao
Arquitetura de Sistema (Gateway, Mediacao, Roteamento)
Seguranca de API (APIM, OAuth, ciclo de vida de credentials)
Monitoramento & Observabilidade (SOFT Monitor, alerting)
Normalizacao & Gestao de Qualidade de Dados
Planejamento de Migracao (Adobe Campaign v6 para v7)
CI/CD & Deploy (GitLab CI, AWS EKS, Kubernetes)

Lideranca & Soft Skills

Coordenacao Multi-stakeholder (marketing, TI, parceiros externos)
Comunicacao Tecnica com equipes nao-tecnicas
Ownership de Plataforma (ponto unico de responsabilidade)
Transferencia de Conhecimento & Documentacao (playbooks, docs API v1-v5)
Tomada de Decisao sob Pressao de Negocio
Conducao de Meetups Tecnicos Internos & Treinamento de Equipe

Etapas do Fluxo de Leads (% retencao)

Distribuicao de Tickets Jira

Status dos Parceiros

O Dia Seguinte

O que aconteceu apos a entrega

Apos a onda inicial de integracoes de parceiros (2021-2023), o PSR entrou em uma fase de estabilizacao e otimizacao. A plataforma continuou processando leads diariamente de todos os parceiros integrados, com alertas de monitoramento capturando anomalias ocasionais (mudancas de formato dos parceiros, deprecacoes de API, renovacoes de credentials).

A refatoracao de 2024 marcou uma evolucao arquitetural significativa: a integracao da API SeLoger foi redesenhada, e a camada Adobe Campaign API foi modernizada. Essa refatoracao demonstrou que as escolhas arquiteturais originais eram solidas mas precisavam de atualizacao a medida que tanto os requisitos internos quanto as APIs de parceiros externos evoluiam.

Hoje, o PSR permanece como o ponto de entrada unico para toda a aquisicao de leads externos no Groupe Pichet. O playbook de integracao de parceiros que documentei permite a equipe integrar novos parceiros de forma autonoma, garantindo a continuidade do conhecimento alem do meu envolvimento direto.

Distribuicao do Esforco Tecnico

Minha Reflexao Critica

Licoes aprendidas e avaliacao honesta

O Que Funcionou Bem

A abordagem incremental parceiro por parceiro permitiu validar cada integracao minuciosamente - zero incidentes graves de perda de leads durante a integracao
O uso do Microsoft APIM como camada gateway forneceu isolamento limpo de credentials e throttling - parceiros nunca tiveram acesso direto aos sistemas internos
A integracao SOFT Monitor ofereceu visibilidade em tempo real sobre a saude do fluxo de leads, detectando problemas em minutos ao inves de dias
A camada de normalizacao absorveu com sucesso a heterogeneidade dos formatos de 9+ parceiros em um unico schema compativel com CRM

O Que Poderia Ser Melhorado

A migracao Adobe Campaign v6 para v7 revelou uma fragilidade: mudancas de URL exigiam atualizacoes manuais em todas as configuracoes de parceiros
A logica de deduplicacao de leads poderia ter sido mais sofisticada - o matching basico era suficiente mas casos limite exigiam revisao manual
Os testes de integracao de ponta a ponta eram manuais e demorados - simulacao automatizada de parceiros teria acelerado o ciclo de integracao
A documentacao as vezes era escrita depois e nao durante o desenvolvimento - documentacao mais precoce teria facilitado a transferencia de conhecimento

Trade-offs & Arbitragens Tecnicas

Divida tecnica aceita na logica de deduplicacao na Fase 2

O negocio precisava de 6 parceiros integrados em 6 meses. Investir em um motor de matching sofisticado teria atrasado as integracoes em 2-3 meses. A deduplicacao basica era "suficiente" para o volume - planejamos a implementacao adequada para a fase de refatoracao de 2024.

Recusa de contornar Adobe Campaign para "injecao direta no CRM" solicitada por um parceiro

Um parceiro queria entrega de leads mais rapida pulando a camada de enriquecimento Neolane. Recusei porque criaria um fluxo de dados paralelo fora do nosso monitoramento, quebrando a rastreabilidade dos leads e o workflow da equipe comercial. A latencia de 200ms era aceitavel.

Endpoints dedicados por parceiro ao inves de endpoint generico dirigido por configuracao

Mais codigo para manter por parceiro, mas cada integracao e isolada: um bug na normalizacao de um parceiro nunca afeta os outros. Esse trade-off se mostrou critico quando a SeLoger mudou seu formato durante o contrato - apenas seu endpoint precisou de atualizacao.

Sem fila de retry assincrono na Fase 1

Processamento sincrono era mais simples de monitorar e debugar durante o periodo de estabilizacao. Retry assincrono teria adicionado complexidade antes de entendermos completamente os padroes de falha. Adicionamos a logica de retry na Fase 4 quando os padroes ficaram claros.

Licoes Aprendidas

Em gestao de leads, velocidade importa tanto quanto precisao - um roteamento rapido mas ligeiramente imperfeito supera um lento mas perfeito, pois leads esfriam rapidamente
Camadas de API gateway (como APIM) sao essenciais ao lidar com multiplos parceiros externos - fornecem seguranca, monitoramento e isolamento de credentials em uma unica camada
A validacao parceiro por parceiro com equipes de negocio e inegociavel - mesmo integracoes tecnicamente identicas podem ter expectativas de negocio diferentes
Um playbook de integracao bem documentado e o melhor investimento para a autonomia da equipe a longo prazo - o playbook PSR sobreviveu ao meu envolvimento direto no projeto