Roll Your Own Siebel Outbound REST Service

Esse artigo é fruto da excelente didática e redação de Alexander Hansal, da Blacksheep, um verdadeiro mestre da educação técnica, cocriador do SiebelHub e profissional com mais de duas décadas de experiência.

O artigo “Roll Your Own Siebel Outbound REST Service” é uma referência valiosa para profissionais que trabalham com o CRM, especialmente para aqueles que precisam criar integrações RESTful de saída (ou seja, integrações onde o CRM atua como cliente, consumindo APIs externas). Escrito com base em um post do especialista Neilson Faria, da Troubleshooter IT, o texto oferece um passo a passo detalhado para montar um serviço robusto sem depender do tradicional Web Service Import Wizard, ferramenta que muitas vezes apresenta limitações ou dificuldades de uso.

Neilson destaca que, desde a versão 20.8, a Oracle trouxe melhorias significativas para o suporte a RESTful de saída, tornando o processo mais simples, especialmente com a introdução do Web Service Import Wizard para Web Tools e as bibliotecas necessárias. Em teoria, importar um arquivo JSON ou Swagger para criar um Business Service proxy e os Integration Objects relacionados deveria ser uma tarefa rápida, realizada em poucos minutos. No entanto, na prática, diversos desafios podem transformar essa tarefa em um projeto que consome o dia inteiro. Entre os obstáculos mais comuns estão versões incompatíveis do Swagger, referências circulares, métodos de autenticação não suportados ou protocolos não compatíveis.

No artigo, Neilson compartilha como ele e sua equipe usaram a plataforma de chatbot Take Blip para criar um proof of concept, integrando o CRM com um chatbot baseado em nuvem. O objetivo era demonstrar como é possível ampliar as capacidades da aplicação utilizando integrações modernas, mesmo diante das limitações de ferramentas automáticas.

O processo descrito envolve a criação manual de um Integration Object, que define a estrutura das mensagens trocadas com o serviço externo. Esse passo exige atenção aos detalhes, pois qualquer erro na definição pode comprometer a integração. Em seguida, é necessário criar um Business Service com a classe CSSWSRESTOutboundDispatcher, responsável por gerenciar as chamadas RESTful. Embora esse passo também seja manual, pode ser agilizado copiando um serviço proxy já existente, como aquele criado a partir do arquivo Swagger do Petstore.

Para versões do anteriores à 21.7, Neilson recomenda criar um serviço customizado em eScript para montar o conjunto de propriedades de entrada do proxy, devido a um bug corrigido apenas nas versões mais recentes. Depois, o Business Service criado deve ser publicado como um Web Service, criando assim um Serviço Web de Saída SOAP. Esse registro precisa ser atualizado para o tipo RESTful e ter seu endpoint ajustado. Neilson sugere o uso de arquivos XML de importação para facilitar essa etapa, evitando a necessidade de manipulação direta no banco de dados via SQL, prática não suportada oficialmente.

Outro ponto importante abordado é a configuração de certificados SSL nos truststores corretos, garantindo a segurança da comunicação entre o CRM e o serviço externo. Caso o servidor exija autenticação mútua (mutual TLS), o CRM também deve ser capaz de fornecer um certificado válido.

Após completar todas essas etapas, o serviço de saída pode ser utilizado normalmente via eScript ou Workflow Processes, permitindo ao CRM interagir com servidores de chatbot ou outras APIs modernas.

Além do guia prático, Neilson compartilha exemplos de arquivos SIF e instruções detalhadas em seu repositório no GitHub, facilitando o aprendizado de outros profissionais e promovendo a colaboração na comunidade. Ferramentas como a Devpops, também mencionadas, são fundamentais para testes e validações em ambientes de desenvolvimento, especialmente em projetos que exigem customização ou possuem demandas variáveis.

A Troubleshooter IT se destaca por atender projetos tradicionais ou altamente customizados, incluindo demandas de curta duração ou de difícil alocação de profissionais no mercado, contando com uma rede global de especialistas. O artigo reforça a importância do compartilhamento de conhecimento e da busca por soluções criativas para superar limitações técnicas, contribuindo para o avanço da comunidade.

Eles ainda não sabem, mas…

O conteúdo do SiebelHub é referência para os novos profissionais que integram o quadro de desenvolvedores e arquitetos relacionados ao CRM nos projetos da Troubleshooter IT.

Além disso, a excelente ferramenta devpops, disponibilizada gratuitamente no GitHub, ajuda demais nos testes de novas funcionalidades e POCs que fazemos nos nossos ambientes de testes.

Lei o artigo completo em “Roll Your Own Outbound REST Service – The SiebelHub“.