--- title: "PSR - Plataforma API Centralizada de Leads Parceiros" description: "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." locale: "pt" canonical: "https://portfolio.josedacosta.info/pt/realizacoes/psr-plateforme-api-partenaires" source: "https://portfolio.josedacosta.info/pt/realizacoes/psr-plateforme-api-partenaires.md" html_source: "https://portfolio.josedacosta.info/pt/realizacoes/psr-plateforme-api-partenaires" author: "José DA COSTA" date: "2021" type: "achievement" slug: "psr-plateforme-api-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-23T15:46:40.846Z" --- # 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. **Date:** Fevereiro 2021 - 2024 **Duration:** ~3 anos **Role:** Project Manager / Product Owner - Responsavel pela Plataforma API **Technologies:** REST API, Microsoft API Manager, Adobe Campaign v7, Dynamics 365, AWS EKS, Kubernetes, Docker, GitLab CI, SOFT Monitor, Jira ### Key Metrics - 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 Integracao: **-** - Reduzido de semanas para dias ## Apresentacao _Definicao e escopo do projeto_ ### Nature Plataforma API REST centralizada para recepcao, normalizacao e roteamento multi-parceiro de leads ### Domain Imobiliario / PropTech - Gestao de Leads (B2B interno + B2B parceiros externos) ### Decisoes Arquiteturais Chave - [object Object] - [object Object] - [object Object] ### Scope - 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 **Content:** 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. **Nature Label:** Natureza **Domain Label:** Dominio **Scope Label:** Escopo Funcional ## Objetivos, Contexto, Desafios & Riscos _Visao estrategica e restricoes_ ### Obj - Expor APIs padronizadas para cada parceiro com contratos de dados consistentes - Normalizar todos os dados de leads independente do formato especifico do parceiro - Rotear leads de forma confiavel para o CRM Hermes via Adobe Campaign para rastreamento do pipeline comercial - Supervisionar a qualidade do fluxo: deteccao de anomalias, leads bloqueados, filtragem de duplicatas - Gerenciar credentials e acessos API de forma centralizada via Microsoft API Manager ### Context 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. ### Stakes 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 ### Risk - [object Object] - [object Object] - [object Object] - [object Object] **Objectives:** Objetivos **Context:** Contexto **Stakes:** Desafios **Risks:** Riscos ## As Etapas - O Que Eu Fiz _Progressao cronologica do projeto_ ## Os Atores - As Interacoes _Equipes, stakeholders e colaboracao_ ### 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 **Content:** 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. ## Os Resultados _Impacto para mim e para a empresa_ ### For Me - 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 ### For Company - 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 **For Me:** Para Mim **For Company:** Para a Empresa ## O Dia Seguinte _O que aconteceu apos a entrega_ **Content:** 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. ## Minha Reflexao Critica _Licoes aprendidas e avaliacao honesta_ ### Positive - 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 ### Improvement - 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 ### Tradeoff - [object Object] - [object Object] - [object Object] - [object Object] ### Lesson - 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 **Positives:** O Que Funcionou Bem **Improvements:** O Que Poderia Ser Melhorado **Lessons:** Licoes Aprendidas