RWS Docs

Este guia mostra como criar uma integração funcional que extrai dados de usuários de uma API que usa autenticação OAuth 2.0 e os envia para um endpoint de webhook. Ao final, você entenderá como as conexões OAuth 2.0 funcionam na RWS Integration.

O que você vai construir

Você criará uma integração que:

Extrai registros de usuários de uma API que usa autenticação OAuth 2.0
Transforma os dados para um formato mais simples
Envia os resultados para webhook.site onde você pode inspecioná-los

Tempo necessário: aproximadamente 5 minutos.

Pré-requisitos

Acesso a um Workspace da RWS Integration
Um navegador web

Certifique-se de estar no Workspace correto usando o seletor de workspace na barra lateral antes de começar.

Passo 1: Configure seu destino

Antes de criar a integração, crie um endpoint de destino onde você pode verificar os resultados.

Abra webhook.site em uma nova aba do navegador
O site gera automaticamente uma URL única (ex.: https://webhook.site/abc123-def456-...)
Copie a parte do caminho único (ex.: /abc123-def456-...), pois você precisará dela ao configurar a fase de Envio
Mantenha esta aba aberta para monitorar requisições recebidas

webhook.site é um serviço gratuito que captura e exibe requisições HTTP. É útil para testar integrações antes de conectar a sistemas de destino reais.

Passo 2: Crie a conexão de origem

Conexões definem como a RWS Integration se comunica com sistemas externos. Você criará uma para a API de origem.

Na barra lateral, clique em Conexões
Clique em Nova Conexão
Configure a conexão:

Campo	Valor	Descrição
Nome	`OAuth 2.0 API`	-
Tipo	`API`	-
URL	`https://api.example.com`	A URL base dos dados extraídos
Caminho base (URL base path)	`/`	O caminho base dos dados extraídos
Autenticação	`OAuth 2.0`	O método de autenticação a usar
Token Type	`Bearer`	O tipo de token a usar
Método	`POST`	O método HTTP a usar para a requisição de autenticação
Base URL	`https://api.example.com`	A URL base do endpoint de autenticação
Autenticação path	`/oauth/token`	O caminho para o endpoint de autenticação
Token Path in Response	`access_token`	O caminho para o token no corpo da resposta

Clique em Salvar

Passo 3: Crie a conexão de destino

Agora crie uma Conexão para seu destino webhook.site.

Clique em Nova Conexão
Configure a conexão:

Campo	Valor
Nome	`Webhook Destination`
Tipo	`API`
URL	`https://webhook.site`
Caminho base (URL base path)	`/`
Autenticação	`Sem autenticação`

Clique em Salvar

Passo 4: Crie a Integração

Com ambas as Conexões prontas, crie a Integração que move dados entre elas.

Na barra lateral, clique em Integrações
Clique em Nova Integração

Configurações gerais

Configure as propriedades básicas da integração:

Campo	Valor
Nome	`OAuth 2.0 Integration`
Versão	`1.0.0`
Tipo	`Full`
Ambiente	`Staging`
Agendamento	Diária, no horário que preferir (ex.: `09:00`)

Fase de Extração

A fase de Extração recupera dados do seu sistema de origem.

Expanda a seção Extração
Configure estes campos:

Campo	Valor
Conexão	`OAuth 2.0 API`
Método	`GET`
Caminho (URL path)	`/users`

Defina o Path para o datapoint na resposta como root

A RWS Integration manterá o Token de Autenticação atualizado solicitando um novo token para cada requisição.

Verifique o painel Preview de Extração no lado direito. Ele deve mostrar:
- Status: 200 OK
- Um único registro de usuário (o Datapoint) com campos como id, name, email, username

Fase de Transformação

A fase de Transformação mapeia campos de origem para o formato de destino. Para este guia, crie um mapeamento simples com três campos.

Expanda a seção Transformação
Clique em Adicionar Transformação e configure:

Tipo	Para	De
Simples	`userId`	`id`
Simples	`fullName`	`name`
Simples	`emailAddress`	`email`

Verifique o painel Preview de Transformação. Ele deve exibir:

{
  "userId": 1,
  "fullName": "Leanne Graham",
  "emailAddress": "Sincere@april.biz"
}

Isso confirma que seus mapeamentos estão funcionando corretamente com dados reais da fase de Extração.

Fase de Envio

A fase de Envio envia dados transformados para seu destino.

Expanda a seção Envio
Configure estes campos:

Campo	Valor
Conexão	`Webhook Destination`
Método	`POST`
Caminho (URL path)	Seu caminho único do webhook.site (ex.: `/abc123-def456-...`)
Tipo de Envio	`Simples`

Copie apenas a parte do caminho da sua URL do webhook.site. Se sua URL completa for https://webhook.site/abc-123, insira /abc-123 como o Path.

Verifique o painel Preview de Envio. Ele mostra a requisição completa que será enviada:
- Path: URL completa de destino
- Method: POST
- Request Body: Sua estrutura de dados transformada

Passo 5: Implante a Integração

Ative o toggle Implantação
Clique em Criar Integração

A integração agora será executada automaticamente todos os dias no horário que você escolheu.

Passo 6: Execute agora

Você não precisa esperar o agendamento. Dispare a primeira execução manualmente:

Abra sua integração na lista de Integrações
Clique em Executar agora, ao lado do botão Salvar
Confirme no diálogo: a mensagem Execução iniciada aparece

Passo 7: Verifique os resultados

Mude para a aba do webhook.site no seu navegador. Você deve ver requisições POST recebidas (uma para cada usuário da API), cada uma contendo sua estrutura de dados transformada:

{
  "userId": 1,
  "fullName": "Leanne Graham",
  "emailAddress": "Sincere@april.biz"
}

Parabéns! Você criou e executou sua primeira integração com autenticação OAuth 2.0!

Primeiros Passos

Guias

Conceitos Fundamentais

Integração com OAuth 2.0

O que você vai construir

Pré-requisitos

Passo 1: Configure seu destino

Passo 2: Crie a conexão de origem

Passo 3: Crie a conexão de destino

Passo 4: Crie a Integração

Configurações gerais

Fase de Extração

Fase de Transformação

Fase de Envio

Passo 5: Implante a Integração

Passo 6: Execute agora

Passo 7: Verifique os resultados

​O que você vai construir

​Pré-requisitos

​Passo 1: Configure seu destino

​Passo 2: Crie a conexão de origem

​Passo 3: Crie a conexão de destino

​Passo 4: Crie a Integração

​Configurações gerais

​Fase de Extração

​Fase de Transformação

​Fase de Envio

​Passo 5: Implante a Integração

​Passo 6: Execute agora

​Passo 7: Verifique os resultados

O que você vai construir

Pré-requisitos

Passo 1: Configure seu destino

Passo 2: Crie a conexão de origem

Passo 3: Crie a conexão de destino

Passo 4: Crie a Integração

Configurações gerais

Fase de Extração

Fase de Transformação

Fase de Envio

Passo 5: Implante a Integração

Passo 6: Execute agora

Passo 7: Verifique os resultados