Introdução aos serviços externos
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Explicar o recurso Serviços externos e quais são os serviços externos.
- Descrever o fluxo de trabalho geral de um serviço externo.
Por que Serviços Externos?
Assista ao vídeo de introdução para ver como você pode transformar especificações de API de maneira declarativa em ações invocáveis.
Os clientes hoje em dia esperam uma experiência do cliente perfeita; não importa se essa experiência é composta de soluções e serviços comerciais nos bastidores que residam em uma única plataforma ou hospedados em várias plataformas. É nessa interação entre o Salesforce e os serviços de fora que os Serviços externos brilham.
Os Serviços externos facilitam essa troca, permitindo que você se integre declarativamente (sem codificação!) a serviços hospedados externamente que realizam ações comerciais ou cálculos para serem usados em sua organização do Salesforce. Então que tipo de serviços de terceiros valiosos podem ser integrados a uma organização do Salesforce? Veja alguns exemplos.
- Função de serviço de pontuação de crédito para a página de detalhes da sua conta do Salesforce
- Um serviço de verificação de qualificação para descontos
- Serviços de pagamento digital flexíveis
- Serviços de mapeamento com ferramentas de visualização
- Notificação de pedido em tempo real no Slack
- Identificação: serviço de prevenção de fraudes
- Integração de serviços de varejo de omnicanal diferentes
- Serviços do Google
- Serviços governamentais e de instituições internacionais
- Índice de qualidade do ar (AirNow)
- Serviços de cidadania
- Agências governamentais de controle de doenças (CDC)
- O Banco Mundial
Veremos os detalhes sobre o que são Serviços externos e como eles funcionam daqui a pouco. Mas, primeiro, vamos ver alguns exemplos que ilustram o fluxo de trabalho e destacam como os Serviços externos mudam o panorama de integração de todos os tipos de serviços web.
Torne os seus novos usuários da organização do Salesforce colaboradores automaticamente em aplicativos externos e relacionados à organização. Digamos que você queira que os usuários tenham acesso a um aplicativo de informações de folha de pagamento externo para que possam procurar suas próprias horas trabalhadas e seus dados de pagamento. Você registra seu serviço externo (o aplicativo de folha de pagamento) e os Serviços externos convertem o serviço em ações para uso com o Flow Builder. Em seguida, você cria um fluxo com acionadores que atuam na entrada (por exemplo, ID de usuário) em seu aplicativo de folha de pagamento. Agora, toda vez que você cria um novo usuário no Salesforce, um fluxo iniciado automaticamente dispara e adiciona o usuário como um colaborador com acesso ao serviço de aplicativo de folha de pagamento fora do Salesforce que contém seu quadro de horários e salário.
Acessar os serviços fora do Salesforce para realizar uma tarefa. Digamos que você queira se conectar a um serviço de crédito que determina se o crédito é estendido a um registro de conta armazenado em sua organização do Salesforce. Veja como funciona. Você registra seu serviço externo (o serviço de validação de crédito). Os Serviços externos convertem o serviço em ações invocáveis (veja a definição) para uso com uma ferramenta da plataforma como o Flow Builder. Em seguida, você usa o Flow Builder para criar um fluxo que inclui as ações desse serviço externo em entradas como valor do pedido e termos de crédito. Quando o fluxo é executado, ele atualiza os termos de crédito para o pedido associado à conta.
Depois de aprender as noções básicas, você poderá usar o fluxo de trabalho de Serviços externos para tirar proveito dos serviços fora do Salesforce que melhor se adaptem ao seu modelo de negócios, caso de uso e, o mais importante, aos seus clientes.
O que queremos dizer com Serviços externos
Você conhece a diferença entre o serviço Web externo e os Serviços externos? Começaremos com algumas definições.
Serviços externos: um produto de integração do Salesforce que engloba (1) registrar um serviço Web externo que você envia como uma especificação compatível com o OpenAPI para definir o serviço Web e (2) magicamente (bem, quase!) trazer as operações de seu serviço Web externo para a Salesforce Platform (veja ações invocáveis) para uso com ferramentas de apontar e clicar, como o Flow Builder. Resumindo, ele conecta APIs REST externas usando padrões do OpenAPI.
Serviço Web externo: também chamado de serviços externos (em letras minúsculas). Qualquer tipo de função, ação ou processo que seja desenvolvido e fique hospedado fora da Salesforce Platform. Para que um serviço Web externo possa ser consumido pelos Serviços externos, ele deve ser uma API baseada em REST que normalmente usa o protocolo HTTPS para navegar pela Web. (Se você não sabe o que é REST, tudo bem.)
Especificação de API: é um arquivo que contém o esquema descritivo que define o que uma API pode fazer. Os Serviços externos aderem a um formato de especificação de OpenAPI baseado em JSON. Uma especificação de API pode ser lida por humanos e máquinas. Ela define as noções básicas para a nomeação, a ordenação e o conteúdo dos objetos e assegura interações claras com uma API REST. Consulte Especificação de OpenAPI.
Ações invocáveis (no contexto dos Serviços externos): representam os blocos de construção declarativos disponibilizados por um número cada vez maior de ferramentas da Salesforce Platform, como o Flow Builder ou os Bots do Einstein. Ações invocáveis ajudam administradores e desenvolvedores fornecendo uma forma de implementar e usar qualquer tipo de ação de maneira consistente. No ecossistema dos Serviços externos, depois de registrar as operações do seu serviço Web externo nos Serviços externos, você poderá acessar as ações invocáveis resultantes, por exemplo, da ferramenta Flow Builder.
Flow Builder: uma ferramenta do tipo apontar e clicar para criar fluxos.
Fluxo: um fluxo é a parte do Salesforce Flow que coleta dados e realiza ações em sua organização do Salesforce ou em um sistema externo. O Salesforce Flow inclui fluxos (criados com o Flow Builder) e processos (criados com o Process Builder).
Embora esses termos (especificação de OpenAPI, especificação de API e esquema) sejam voltados para desenvolvedores, os Serviços externos ajudam a preencher a lacuna entre a codificação de serviços Web e a automação do acesso a eles.
O panorama geral
É hora de voltar atrás e olhar para o panorama geral a fim de entender os blocos de construção interconectados dos Serviços externos. Observe que muito do trabalho de registrar um serviço Web externo seu é feito declarativamente por meio da página de registro dos Serviços externos. Depois de registrado, você pode usar ferramentas como o Flow Builder para criar um fluxo com as ações invocáveis de seu serviço Web.
Aqui está uma visão geral do que vai acontecer. Observe que, embora haja seis etapas, as principais para os Serviços externos são as etapas 3, 4 e 5.
- Um provedor de serviços Web externos, como um banco, hospeda sua API baseada em REST. Neste cenário, pense em uma API baseada em REST como a que especifica um tipo de contrato entre o banco (provedor) e você (consumidor).
- O provedor de serviços da Web (como no nosso exemplo de serviço bancário Web) ou um desenvolvedor (ou até mesmo você) compartilha uma especificação de API baseada em JSON que descreve a API.
- Um administrador ou desenvolvedor do Salesforce cria declarativamente uma credencial nomeada para autenticar o ponto de extremidade do serviço Web usando a URL da API baseada em REST fornecida pelo provedor de serviços Web externos. O ponto de extremidade é simplesmente o que expõe os recursos para interação com os Serviços externos.
- Um administrador do Salesforce registra declarativamente o serviço Web e usa a credencial nomeada e a especificação de API durante o processo de registro. Os Serviços externos importam as operações da especificação de API para sua organização e as disponibilizam como ações invocáveis.
- Um administrador do Salesforce usa o Flow Builder para acessar as ações de fluxo invocáveis que foram registradas na etapa 4.
- Durante o tempo de execução, o fluxo envia um callout ao ponto de extremidade do serviço. O serviço Web retorna a saída com base na especificação da API. Os dados são recuperados, criados, atualizados ou excluídos pelo serviço Web externo. O Salesforce pode capturar essas respostas do serviço Web externo para uso com uma ferramenta como o Flow Builder.
Se um produtor de API não compartilhou uma especificação com você, a criação da especificação de API na etapa 2 não será um processo declarativo. Você pode criar a especificação de API (dependendo da sua formação) por conta própria, pedir ajuda ao seu desenvolvedor ou usar uma ferramenta de criação de esquemas, como o Swagger Editor, para isso.
Na próxima unidade, abordaremos os prós e contras (ou, mais precisamente, as entradas e saídas) de uma especificação de API e discutiremos o que ela é. Quando tiver sua especificação da API, use as ferramentas declarativas já no Salesforce para adicionar as ações comerciais de que sua organização precisa.