Pular para o conteúdo principal
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 Connections, construir uma Integration e executá-la.

​
O que você vai construir

Você criará uma integração que:
  1. Extrai registros de usuários do JSONPlaceholder (uma API de teste gratuita)
  2. Transforma os dados para um formato mais simples
  3. 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.
  1. Abra webhook.site em uma nova aba do navegador
  2. O site gera automaticamente uma URL única (ex.: https://webhook.site/abc123-def456-...)
  3. Copie esta URL — você precisará dela ao criar sua Connection de destino
  4. 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 Connection de origem

Connections definem como o RWS Integration se comunica com sistemas externos. Você criará uma para a API de origem.
  1. Na barra lateral, clique em Conexões
  2. Clique em Nova Conexão
  3. Configure a connection:
CampoValor
NameJSONPlaceholder API
TypeAPI
URLhttps://jsonplaceholder.typicode.com
Base Path/
AuthenticationSimple
  1. Deixe Header Parameters e Query Parameters vazios
  2. Clique em Save
A API JSONPlaceholder não requer autenticação, então o tipo de autenticação Simple sem parâmetros adicionais funciona.

​
Passo 3: Crie a Connection de destino

Agora crie uma Connection para seu destino webhook.site.
  1. Clique em Nova Conexão
  2. Configure a connection:
CampoValor
NameWebhook Destination
TypeAPI
URLhttps://webhook.site
Base Path/
AuthenticationSimple
  1. Clique em Save

​
Passo 4: Crie a Integration

Com ambas as Connections prontas, crie a Integration que move dados entre elas.
  1. Na barra lateral, clique em Integrações
  2. Clique em Nova Integração

​
Configurações gerais

Configure as propriedades básicas da integração:
CampoValor
NameUser Sync Quickstart
Version1.0.0
TypeFull
EnvironmentStaging
Schedulerate(1 day)

​
Fase de Extração

A fase de Extração recupera dados do seu sistema de origem.
  1. Expanda a seção Extração
  2. Configure estes campos:
CampoValor
ConnectionJSONPlaceholder API
MethodGET
Path/users
  1. Defina o Datapoint Path in Response como root
  2. Defina a Paginação:
CampoValor
Pagination TypeSimple
Page size parameter_limit
Page size value10
Initial page parameterid
Initial page value1
Pagination end typeObject
  1. 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.
  1. Expanda a seção Transformação
  2. Clique em Adicionar Transformação e configure:
TypeFromTo
SimpleiduserId
SimplenamefullName
SimpleemailemailAddress
  1. 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.
  1. Expanda a seção Envio
  2. Configure estes campos:
CampoValor
ConnectionWebhook Destination
MethodPOST
PathSeu caminho único do webhook.site (ex.: /abc123-def456-...)
Tipo de EnvioSimple
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 Path.
  1. Verifique o painel Preview de Envio — ele mostra a requisição completa que será enviada:
    • Path: URL completa do destino
    • Method: POST
    • Request Body: Sua estrutura de dados transformada

​
Passo 5: Crie a Integration

  1. Alterne Implantação para habilitado
  2. Clique em Criar Integração
Como configuramos rate(1 day) como schedule, a integração será executada imediatamente após a criação. Depois disso, ela será executada automaticamente a cada 24 horas.

​
Passo 6: 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

  • Connections armazenam configurações para sistemas externos e podem ser reutilizadas em múltiplas Integrations
  • Integrations seguem o padrão Extração → Transformação → Envio (com Enriquecimento opcional)
  • O Datapoint Path 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/Production) permitem testar com segurança antes de implantar em produção

​
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