--- title: "Plataforma API de recepção de leads parceiros (PSR)" description: "Plataforma API centralizada que roteia leads imobiliários de dezenas de portais parceiros para o CRM comercial." locale: "pt" canonical: "https://portfolio.josedacosta.info/pt/realizacoes/plateforme-api-reception-leads-partenaires" source: "https://portfolio.josedacosta.info/pt/realizacoes/plateforme-api-reception-leads-partenaires.md" html_source: "https://portfolio.josedacosta.info/pt/realizacoes/plateforme-api-reception-leads-partenaires" author: "José DA COSTA" date: "2021" type: "achievement" slug: "plateforme-api-reception-leads-partenaires" tags: ["REST API", "Microsoft API Manager", "Adobe Campaign v7", "Dynamics 365", "AWS EKS", "Kubernetes", "Docker", "GitLab CI", "SOFT Monitor", "Jira"] generated_at: "2026-04-24T08:30:09.881Z" --- # 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. **Data:** Fevereiro 2021 - 2024 **Duração:** ~3 anos **Função:** Project Manager / Product Owner - Responsável pela Plataforma API **Tecnologias:** REST API, Microsoft API Manager, Adobe Campaign v7, Dynamics 365, AWS EKS, Kubernetes, Docker, GitLab CI, SOFT Monitor, Jira ### Indicadores-chave - APIs Parceiras: **-** - Integradas e mantidas - Volume de Leads: **-** - ~1 lead a cada 2 segundos em pico - Taxa de Perda: **-** - Zero incidentes graves de perda - Tempo de Integração: **-** - Reduzido de semanas para dias - Dezenas: **-** ## Apresentacao _Definicao e escopo do projeto_ ### O projeto em poucas palavras ### O que e a plataforma Plataforma API REST centralizada para recepção, normalização e roteamento multi-parceiro de leads ### Imobiliário / PropTech - Gestão de Leads (B2B interno + B2B parceiros externos) ### 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. ### 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. 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. Dominio de negócio ## Objetivos, Contexto, Desafios & Riscos _Visao estratégica e restricoes_ ### Objetivos e critérios de sucesso - Integrar dezenas de parceiros externos sem desenvolvimento customizado no CRM por parceiro. - Manter zero incidente grave de perda de leads durante e após cada onboarding. - Reduzir o tempo de integração de um novo parceiro de semanas para dias. - Garantir governança auditável de credentials e acessos para todos os parceiros. - Detectar 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. ## 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 ### 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. - 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. 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. ## 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. ### Estratégia de Monitoramento & Observabilidade - Dashboard SOFT Monitor com gauges KPI em tempo real rastreando a saúde do fluxo de leads de dezenas de parceiros simultaneamente - Alertas de email automatizados acionados em anomalias de processamento de leads: leads bloqueados, falhas de validação 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 - Detecção proativa de anomalias: mudancas de formato dos parceiros (adicoes de campos, alteracoes de codificacao) detectadas na camada de validação antes de impactar sistemas downstream - Resposta a incidentes de producao: o monitoramento permitiu detecção em menos de um minuto de quedas de parceiros, reduzindo a perda silenciosa de leads de dias para minutos ### Competencias Demonstradas ### Competencias Técnicas - Design de API & Padrões de Integração - Arquitetura de Sistema (Gateway, Mediacao, Roteamento) - Segurança de API (APIM, OAuth, ciclo de vida de credentials) - Monitoramento & Observabilidade (SOFT Monitor, alerting) - Normalização & Gestão de Qualidade de Dados - Planejamento de Migração (camada de roteamento de marketing v6 para v7) - CI/CD & Deploy (GitLab CI, AWS EKS, Kubernetes) ### Liderança & Soft Skills - Coordenação Multi-stakeholder (marketing, TI, parceiros externos) - Comunicacao Técnica com equipes não-técnicas - Ownership de Plataforma (ponto único de responsabilidade) - Transferencia de Conhecimento & Documentação (playbooks, docs API v1-v5) - Tomada de Decisão sob Pressao de Negócio - Conducao de Meetups Técnicos Internos & Treinamento de Equipe ## 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. ## 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. ### Contexto adicional - Cronograma de Integração de Parceiros - Distribuicao de Tickets Jira - Etapas do Fluxo de Leads (% retencao) - Integrações de Parceiros por Ano - Distribuicao do Esforco Técnico - Status dos Parceiros - Arquitetura do Sistema - Pipeline do Ciclo de Vida dos Leads - Ciclo de vida completo de um lead, da fonte parceira ao CRM - APIs de Parceiros Integradas - Processo de Integração de Parceiro ## Competências aplicadas _Competências técnicas e humanas aplicadas_ - **Arquitetura e Design de Sistemas** - Arquitetura de ponta a ponta: API gateway, normalização, camada de enriquecimento, roteamento CRM - **REST API Design** - Endpoints REST para parceiros, contratos de dados e 5 versões da API - **Gestão de Stakeholders** - Ponto único de contato técnico para dezenas de parceiros externos e equipes internas - **Gestão de Projetos** - Project Manager / Product Owner da plataforma de 2021 a 2023 - **Comunicação e Colaboração** - Ciclo de integração API com parceiros externos: specs, testes, validação, go-live - **Web Application Security (OWASP)** - Isolamento de credentials via APIM, conformidade RGPD e auditoria de segurança em 2023 - **Resolução de Problemas e Pensamento Crítico** - Diagnóstico de anomalias inter-sistemas e migrações complexas de configurações de parceiros - **Monitoring & Supervision** - Dashboards SOFT Monitor, alertas email em tempo real, observabilidade por parceiro - **Adaptabilidade e Agilidade de Aprendizagem** - Domínio de Microsoft APIM e do domínio de lead management imobiliário ## Trajetória relacionada _Experiência profissional ligada a esta realização_ - **Technical Lead · Fluxos e Produtos: conteúdos e integração empresarial** ## Galeria de imagens _Capturas e visuais do projeto_ ## 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**