RWS Docs

Este guia mostra como criar uma integração funcional que extrai dados de usuários de uma API pública e os entrega a um endpoint webhook. Ao final, você entenderá o fluxo principal: criar Conexões, construir uma Integração e executá-la.

O que você vai construir

Você criará uma integração que:

Extrai registros de usuários do JSONPlaceholder (uma API de teste gratuita)
Transforma os dados para um formato mais simples
Carrega os resultados no webhook.site onde você pode inspecioná-los

Tempo necessário: aproximadamente 5 minutos.

Pré-requisitos

Acesso a um Workspace do RWS Integration
Um navegador web

Passo 1: Configure seu destino

Antes de construir 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 esta URL: você precisará dela ao criar sua Conexão de destino
Mantenha esta aba aberta para monitorar as 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 o RWS Integration se comunica com sistemas externos. Você criará uma para a API de origem.

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

Campo	Valor
Nome	`JSONPlaceholder API`
Tipo	`API`
URL	`https://jsonplaceholder.typicode.com`
Caminho base (URL base path)	`/`
Autenticação	`Sem autenticação`

Clique em Salvar

A API JSONPlaceholder não requer autenticação, então a opção Sem autenticação, já selecionada por padrão para novas conexões, é tudo o que você precisa.

Passo 3: Crie a Conexão de destino

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

Clique em Criar 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 Criar Integração

Configurações gerais

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

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

O agendamento é definido com um seletor de frequência: escolha com que frequência a integração executa e preencha os detalhes, como o horário do dia. Veja Agendamento para todas as opções.

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	`JSONPlaceholder API`
Método	`GET`
Caminho (URL path)	`/users`

Defina o Path para o datapoint na resposta como root
Defina a Paginação:

Campo	Valor
Tipo	`Simples`
Parâmetro do tamanho da página	`_limit`
Valor do tamanho da página	`10`
Parâmetro da página	`_page`
Valor da página inicial	`1`
Tipo de fim de paginação	`Objeto`

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 início rápido, crie um mapeamento simples com três campos.

Expanda a seção Transformação
Clique em Adicionar 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 é https://webhook.site/abc-123, insira /abc-123 como o caminho.

Verifique o painel Preview de Envio. Ele mostra a requisição completa que será enviada:
- Caminho: URL completa do destino
- Método: POST
- Corpo da requisição: Sua estrutura de dados transformada

Passo 5: Implante a Integração

Habilite o Agendamento para deploy
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

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

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

Parabéns! Você construiu e executou sua primeira integração!

O que você aprendeu

Conexões armazenam configurações para sistemas externos e podem ser reutilizadas em múltiplas Integrações
Integrações seguem o padrão Extração → Transformação → Envio (com Enriquecimento opcional)
O Path para o datapoint indica ao RWS Integration onde encontrar registros nas respostas da API
Painéis de Preview atualizam automaticamente conforme você configura cada fase, permitindo validar antes de executar
Transformações simples mapeiam campos da origem para o destino usando notação JSONPath
Ambientes (Staging/Produção) permitem testar com segurança antes de implantar em produção
Executar agora dispara uma execução sob demanda, sem esperar o agendamento

Próximos passos

Conexões

Aprenda sobre os diferentes métodos de autenticação

Paginação

Lide com paginação e respostas de API complexas

Regras de Negócio

Domine transformações de campos com JavaScript

Agendamento

Agende suas integrações para executar automaticamente

Primeiros Passos

Guias

Conceitos Fundamentais

Início Rápido

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ê aprendeu

Próximos passos

Conexões

Paginação

Regras de Negócio

Agendamento

​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ê aprendeu

​Próximos passos

Conexões

Paginação

Regras de Negócio

Agendamento

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ê aprendeu

Próximos passos