Nós genéricos de requisição HTTP e GraphQL para integrações customizadas.
APIs
O grupo de paleta APIs oferece nós genéricos de requisição para chamar qualquer serviço HTTP ou GraphQL externo a partir de um workflow. Use-os quando ainda não existir um nó de integração dedicado ou quando você precisar de controle total sobre URL, método, headers e payload.
Abra Automações, adicione um nó do grupo APIs e configure a requisição. Ambos os nós rodam no motor de workflows do WhatsWave com timeout de 30 segundos e suportam variáveis de workflow ({{...}}) em todos os campos.
Figura 1: Nós HTTP e GraphQL na paleta do editor de workflows
Nós neste grupo
| Nó | Type ID | O que faz |
|---|---|---|
| HTTP | http_request | Chamada REST genérica — URL, método, headers e body JSON configuráveis. |
| GraphQL | graphql_request | Envia uma query ou mutation com variáveis JSON opcionais para um endpoint GraphQL. |
Quando usar nós de APIs
- Integrar uma API REST customizada que não tenha um nó dedicado na paleta (microsserviços internos, APIs de parceiros, sistemas legados)
- Chamar uma API GraphQL (Hasura, Shopify Admin API, GitHub GraphQL, seu próprio schema)
- Construir uma ponte entre sistemas: receber um gatilho Webhook, transformar dados com nós de Lógica e encaminhar via HTTP
- Prototipar uma integração antes de existir um nó de primeira classe em Pagamentos, E-commerce ou outros grupos
Quando preferir um nó dedicado
Se a paleta já tiver um nó para o seu serviço (Stripe, Shopify, Gmail, Postgres, etc.), use-o em vez do genérico. Nós dedicados vêm com:
- URLs base e padrões de autenticação pré-preenchidos
- Rótulos de campos alinhados à API do provedor
- Padrões mais seguros e tratamento de erros específico do provedor
Use HTTP ou GraphQL quando precisar de um endpoint ou formato de payload que os nós dedicados não cobrem.
Padrão de fluxo típico
Webhook trigger → Variable / JavaScript → HTTP or GraphQL → Condition → WhatsWave message / CRM
- O gatilho recebe dados externos (
{{trigger.body.*}}) - Variável ou JavaScript normaliza telefones, IDs ou texto da mensagem
- HTTP / GraphQL chama seu backend ou uma API de terceiros
- Condição ramifica com base em
{{nodeId.status}}ou campos da resposta - Nós WhatsWave enviam mensagens WhatsApp ou atualizam cards do CRM
Conceitos compartilhados
Ambos os nós compartilham o mesmo motor de execução (executeHttpRequest). Consulte os guias por nó para detalhes em nível de campo.
| Tópico | Detalhes |
|---|---|
| Variáveis | {{trigger.body.email}}, {{variables.api_key}}, {{http_1.data.id}} — veja Variáveis no workflow |
| Testes | Execute o fluxo completo em Test ou use o botão Play do nó — veja Testar e depurar |
| Erros | Requisições com falha marcam o nó como error; inspecione http_error_detail nos logs de execução |
| Auth | Passe tokens em Headers (JSON). Nunca coloque secrets em texto puro no canvas — use variáveis de workflow ou Settings → API Keys |
Documentação dos nós
- Nó HTTP — métodos REST, headers, body, saídas, padrões de autenticação e exemplos
- Nó GraphQL — queries, mutations, variáveis, tratamento de erros e exemplos
Documentação relacionada
Este artigo foi útil?
Precisa de mais ajuda? Falar com suporte