O que é

O Nó HTTP é um tipo de nó do Spaceflow que permite configurar chamadas a APIs externas diretamente dentro de um fluxo de automação. Com ele, o ENSPACE pode enviar e receber dados de qualquer serviço externo que possua uma API REST, sem necessidade de ferramentas ou plataformas intermediárias.

Quando usar

• Integrar o ENSPACE com sistemas externos (ERP, CRM, plataformas de pagamento, serviços de mensageria etc.) dentro de um fluxo.
• Disparar ações em serviços externos automaticamente ao ocorrer um evento no workspace.
• Sincronizar dados entre sistemas durante a execução de um processo.
• Enviar notificações via webhook a sistemas que aguardam eventos do ENSPACE.

Campos de configuração

• Método — tipo da requisição HTTP: GET, POST, PUT, PATCH ou DELETE.
• URL — endereço do endpoint da API de destino. Suporta variáveis do fluxo (ex: {{``item.id``}}).
• Headers — cabeçalhos HTTP da requisição. Exemplo: Content-Type: application/json.
• Parâmetros — query parameters adicionados ao final da URL.
• Corpo (Body) — conteúdo enviado no corpo da requisição (para POST, PUT e PATCH). Suporta variáveis do fluxo.
• Credencial — selecione uma credencial cadastrada para autenticação automática. Evita inserção manual de tokens.
• Mapeamento da resposta — define como os dados retornados pela API serão usados nas etapas seguintes do fluxo.

(imagem: tela de configuração do Nó HTTP)

Como adicionar ao fluxo

1. Acesse o Spaceflow e abra ou crie o fluxo desejado.
2. Clique para adicionar um novo nó e selecione Nó HTTP.
3. Configure o método, a URL e os demais parâmetros da requisição.
4. Se o serviço exigir autenticação, selecione a credencial correspondente no campo Credencial.
5. Configure o mapeamento da resposta para utilizar os dados retornados nos próximos nós.
6. Conecte o nó na cadeia do fluxo e salve.

Boas práticas

• Sempre use credenciais cadastradas em vez de inserir tokens diretamente na URL ou no body.
• Mapeie a resposta corretamente para que os próximos nós possam utilizá-la.
• Adicione nós de condição após o Nó HTTP para tratar respostas de erro (status 4xx/5xx).
• Teste o nó com dados reais antes de ativar o fluxo em produção.
• Use variáveis do fluxo na URL e no body para tornar o nó reutilizável em diferentes contextos.