RWS Docs

Este guia mostra como criar uma integração que extrai dados de posts do JSONPlaceholder, enriquece cada post com detalhes de comentários usando uma chamada de API secundária e envia os dados combinados a um endpoint de webhook. Ao final, você entenderá como usar a fase de Enriquecimento para buscar dados adicionais por datapoint e combiná-los em suas transformações.

O que você vai construir

Você criará uma integração que:

Extrai registros de posts do JSONPlaceholder (uma API de teste gratuita)
Enriquece cada post buscando seus comentários usando uma requisição de API secundária
Transforma os dados combinando campos de ambas as respostas de extração e enriquecimento
Envia os resultados enriquecidos 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

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 JSONPlaceholder, que será usada tanto para a extração principal quanto para as requisições de enriquecimento.

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

Campo	Valor
Nome	`[Doc] Enrichment Extract Connection`
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 Nova Conexão
Configure a conexão:

Campo	Valor
Nome	`[Doc] Enrichment Load Connection`
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 extrai posts, os enriquece com comentários e envia os dados combinados ao seu destino.

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	`[Doc] Enrichment 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 de posts do seu sistema de origem.

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

Campo	Valor
Conexão	`[Doc] Enrichment Extract Connection`
Método	`GET`
Caminho (URL path)	`/posts`

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 post (o Datapoint) como este:

{
     "userId": 1,
     "id": 1,
     "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
     "body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto"
 }

Fase de Enriquecimento

A fase de Enriquecimento busca dados adicionais para cada datapoint extraído na fase de Extração principal. Para cada post, buscaremos seus comentários.

Expanda a seção Enriquecimento
Clique em Adicionar Enriquecimento
Configure o enriquecimento:

Campo	Valor
Nome	`comments`
Conexão	`[Doc] Enrichment Extract Connection`
Método	`GET`
Caminho (URL path)	`/posts/{{ parameterId }}/comments`

Configure os parâmetros de query do Enriquecimento:

Tipo	Para	Valor fixo
Fixo	`parameterId`	`{{ id }}`

O {{ id }} é um parâmetro dinâmico que será interpolado de cada datapoint extraído na etapa principal de Extração. Certifique-se de que o nome do campo corresponda exatamente (sensível a maiúsculas/minúsculas).

O enriquecimento usará automaticamente o valor id extraído do post para fazer uma requisição para /posts/{id}/comments.

Verifique o painel Preview de Extração no lado direito. Ele deve mostrar:

Status: 200 OK
Um array de registros de comentários como este:

[
 {
     "postId": 1,
     "id": 1,
     "name": "id labore ex et quam laborum",
     "email": "Eliseo@gardner.biz",
     "body": "laudantium enim quasi est quidem magnam voluptate ipsam eos\ntempora quo necessitatibus\ndolor quam autem quasi\nreiciendis et nam sapiente accusantium"
 },
 {
     "postId": 1,
     "id": 2,
     "name": "quo vero reiciendis velit similique earum",
     "email": "Jayne_Kuhic@sydney.com",
     "body": "est natus enim nihil est dolore omnis voluptatem numquam\net omnis occaecati quod ullam at\nvoluptatem error expedita pariatur\nnihil sint nostrum voluptatem reiciendis et"
 },
]

Fase de Transformação

A fase de Transformação mapeia campos de origem de ambas as respostas de Extração e Enriquecimento para o formato de destino. Para este guia, crie mapeamentos que combinem dados de posts com informações de comentários.

Expanda a seção Transformação
Clique em Adicionar Transformação e configure campos da Extração principal:

Tipo	Para	De
Simples	`postId`	`id`
Simples	`postTitle`	`title`
Simples	`postBody`	`body`

Clique em Adicionar Transformação novamente e configure campos do Enriquecimento:

Tipo	Para	De
Simples	`firstCommentEmail`	`comments[0].email`
Simples	`firstCommentText`	`comments[0].body`

Para acessar dados de enriquecimento, use o nome do enriquecimento diretamente como início do caminho: {{ enrichmentName }}.{{ fieldPath }} (neste caso, comments). O nome do enriquecimento deve corresponder exatamente ao que você configurou na seção Enriquecimento.

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

{
  "postId": 1,
  "postTitle": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "postBody": "quia et suscipit...",
  "firstCommentEmail": "Eliseo@gardner.biz",
  "firstCommentText": "laudantium enim quasi est quidem magnam voluptate..."
}

Isso confirma que seus mapeamentos estão funcionando corretamente e mostra como os dados de ambas as fases de Extração e Enriquecimento são combinados.

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	`[Doc] Enrichment Load Connection`
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: https://webhook.site/{{ your-unique-path }}
- Method: POST
- Request Body:

{
  "postId": 1,
  "postTitle": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "postBody": "quia et suscipit...",
  "firstCommentEmail": "Eliseo@gardner.biz",
  "firstCommentText": "laudantium enim quasi est quidem magnam voluptate..."
}

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 post processado), cada uma contendo sua estrutura de dados transformada com informações combinadas de posts e comentários:

{
  "postId": 1,
  "postTitle": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "postBody": "quia et suscipit...",
  "firstCommentEmail": "Eliseo@gardner.biz",
  "firstCommentText": "laudantium enim quasi est quidem magnam voluptate..."
}

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

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 → Enriquecimento → Transformação → Envio
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
Enriquecimento permite buscar dados adicionais para cada datapoint extraído na fase de Extração principal
Parâmetros dinâmicos (como {{ id }}) em caminhos de enriquecimento são interpolados de datapoints extraídos
Dados de enriquecimento são acessados na Transformação pelo nome do enriquecimento: {{ enrichmentName }}.{{ fieldPath }}

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

Integração com múltiplas extrações

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 Enriquecimento

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 Enriquecimento

​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 Enriquecimento

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