Passar para o conteúdo principal

[Workflow Builder - GCW] Usando conexões para enviar dados via HTTP em workflows: um guia passo a passo

R
Escrito por Roman Aldunate

Este artigo oferece um guia completo sobre como usar o recurso Connections para enviar dados via HTTP em workflows. Ele aborda as etapas para adicionar uma conexão, utilizá-la em um workflow, editar conexões existentes e responde às perguntas frequentes para aprofundar seu entendimento e aplicação desse recurso.


O recurso de Pacotes Agregados permite reunir vários pacotes menores em um único pacote maior para envio. Assim, as gráficas conseguem otimizar os custos de envio ao reduzir o número de remessas necessárias, o que gera economia e mais eficiência operacional.

O recurso Conexões permite configurar e salvar endpoints HTTP/HTTPS externos em um local centralizado. Depois que uma conexão é estabelecida, ela pode ser utilizada em diversos fluxos de trabalho por meio da atividade Enviar para HTTP, permitindo que você envie dados ou arquivos para o endpoint especificado.

🎬 Vídeo explicativo


Etapa 1: Adicionar uma conexão

  1. Clique no ícone do seu Perfil no canto superior direito.

  2. Navegue até Configurações de trabalho → Conexões.

    image-20260220-080300.png
  3. Clique em Add Connection.

  4. Preencha os detalhes de conexão:

    • Nome — Um rótulo para identificar esta conexão (por exemplo, My API Endpoint).

    • URL — O URL HTTPS do endpoint.

    • Autenticação — Selecione o tipo de autenticação adequado ou escolha Sem autenticação se não for necessário.

    • Cabeçalhos(opcional) — Adicione os cabeçalhos HTTP necessários para o endpoint.

  5. Clique em Test Connection para verificar se o endpoint está acessível.

  6. Edite o modelo onde você deseja usar pesquisas

Sua conexão agora aparecerá na lista de conexões e estará disponível para uso em qualquer fluxo de trabalho.

Nota: O Connections foi criado para ser o hub central de todas as suas integrações externas. O suporte para tipos de conexão adicionais, como SFTP, será adicionado futuramente.


Etapa 2: Use a conexão em um fluxo de trabalho

  1. Abra um fluxo de trabalho (ou crie um novo).

  2. Adicione uma nova atividade e selecione Send to HTTP Endpoint.

  3. Configure a atividade:

    • Conexão — Selecione uma conexão salva no menu suspenso.

    • Cabeçalhos(opcional) — Adicione ou substitua cabeçalhos para esta etapa específica do fluxo de trabalho.

    • Formato do corpo — Escolha como os dados devem ser enviados:

      • JSON (padrão)

      • XML

  4. Salve o fluxo de trabalho.

A atividade agora enviará dados para o endpoint configurado sempre que o fluxo de trabalho for executado.


Editando uma conexão

Para atualizar uma conexão existente:

  1. Acesse Perfil → Configurações de trabalho → Conexões.

  2. Selecione a conexão que deseja editar.

  3. Faça suas alterações (por exemplo, atualize o URL, mude o formato do corpo ou adicione cabeçalhos).

  4. Edite o modelo onde você deseja usar pesquisas

Todos os fluxos de trabalho que usam essa conexão vão refletir automaticamente a configuração atualizada.


FAQ

Posso usar a mesma conexão em vários fluxos de trabalho? Sim. Depois que uma conexão é salva, ela fica disponível no menu suspenso de conexões em todos os fluxos de trabalho.

Quais formatos de corpo são suportados? Atualmente, JSON e XML são suportados como formatos de corpo ao enviar dados pela atividade Send to HTTP.

O que fazer se o Teste de conexão falhar? Verifique se há erros de digitação na URL, certifique-se de que o endpoint está acessível publicamente e confirme se a autenticação e os cabeçalhos corretos foram fornecidos.

Mais tipos de conexão serão suportados no futuro? Sim. SFTP e outros tipos de conexão estão planejados para versões futuras.


Respondeu à sua pergunta?