5 minsO que você verá neste artigo
Você já precisou integrar uma ferramenta que não está no catálogo da Pluga, mas que possui uma API aberta? Ou talvez precise consultar dados periodicamente de um sistema e enviá-los automaticamente para outro lugar?
O HTTP Request permite que a Pluga se comunique diretamente com APIs externas para buscar ou enviar informações nas suas automatizações.
Como funciona o HTTP Request na Pluga?
Na prática, funciona assim: você configura os dados de acesso à API da ferramenta que você deseja integrar, e a Pluga se comunica com ela através de uma URL específica (o endpoint da API).
| Essa comunicação torna possível:
Receber dados de uma API
A Pluga faz requisições periódicas para uma URL específica (endpoint) de uma API, coleta os novos dados retornados e os envia automaticamente para as ferramentas de destino que você configurar.
Enviar dados para uma API
A partir de um evento de gatilho, a Pluga envia uma notificação para o endpoint de uma API para criar, atualizar ou apagar informações na ferramenta de destino.
⚡️Importante: Configurar um HTTP Request pode exigir que você tenha um conhecimento básico sobre APIs, além de saber ler e interpretar documentações técnicas.
Resumidamente, as etapas de configuração são:
HTTP Request para coletar dados
1️⃣ A Pluga consulta a API
A Pluga faz, regularmente, uma consulta ao endpoint que você configurou.
2️⃣ A API responde com dados
A API “responde”, retornando uma lista de registros.
3️⃣ A Pluga identifica novidades
A Pluga compara os IDs únicos dos registros recebidos com os que já foram processados anteriormente.
4️⃣ A ação é realizada
Quando a Pluga identifica uma novidade, os dados são enviados para a ferramenta de destino
Passo a passo da configuração
- Selecione o HTTP Request como gatilho da automatização e configure a URL do endpoint
Ao criar uma nova automatização, escolha HTTP Request como ferramenta de origem e selecione a opção Nova requisição na API e informe:
• Nome da ferramenta: Apenas para identificação; e
• URL do endpoint completo da API que você deseja consultar.
💡Como encontrar o endpoint para capturar dados?
Consulte a documentação da API da ferramenta. Procure por endpoints que usam o método GET e retornam listas de dados.
Exemplo:
https://api.ferramenta.com/contacts
- Defina a chave dos dados e a chave única (Deduplication Key)
A chave dos dados indica qual tipo de dado a Pluga deve buscar na API e a chave única identifica cada registro de forma exclusiva (geralmente um ID, e-mail ou CPF), para não enviar dados duplicados.
Por exemplo, se a API retornar:
{
"contacts": {
"id": "123",
"name": "João da Silva",
"email": "[email protected]"
}
}A chave dos dados seria: contacts
E a chave única seria: id
💡 Dica: você também pode usar “Query Params” para refinar sua busca (como por exemplo limitar a quantidade de registros retornados ou filtrar por data).
Depois de configurar tudo, clique em “Salvar e continuar”. E pronto! Agora você poderá mapear os dados recebidos nos campos da ferramenta de destino e finalizar sua automatização.
HTTP Request para enviar dados
Você pode utilizar este método para enviar novos dados, atualizar dados existentes ou até mesmo apagar um registro na sua ferramenta de destino.
1️⃣ A Pluga é notificada
Quando algo acontece em sua ferramenta de origem a Pluga é notificada.
2️⃣ A Pluga organiza os dados
Então, a Pluga organiza os dados recebidos de acordo com as chaves mapeadas.
3️⃣ A Pluga envia as novidades
A API recebe os dados enviados via Pluga, e a ação é executada.
4️⃣ Automatização é finalizada
Os dados são inseridos, atualizados ou apagados, e a etapa é finalizada.
Passo a passo da configuração
- Selecione o HTTP Request como ação da automatização e configure a URL do endpoint
Ao criar uma nova automatização, escolha HTTP Request como ferramenta de destino e selecione a opção Enviar uma mensagem via HTTP Request e informe:
• Nome da ferramenta: Apenas para identificação; e
• Método de requisição : para indicar que tipo de ação deseja realizar na API (POST, GET, PUT, PATCH, DELETE);
- Configure os campos que deseja enviar
Em seguida, basta indicar para a Pluga:
• URL do endpoint para onde vai enviar os dados;
• Nomes dos campos que a Pluga deve preencher; e
• Mapear os valores a serem enviados para de cada um dos campos mapeados;
💡 Dica: você também pode configurar parâmetros de cabeçalho e busca na sua requisição.
Combine o HTTP Request com outros recursos da Pluga
O HTTP Request se torna ainda mais poderoso quando combinado com outros recursos da Pluga:
Filtros Condicionais
Defina regras ainda mais específicas, como “só enviar dados que correpondam a termos específicos”.
Formatador da Pluga
Ajuste textos, elimine caracteres, corrija números ou adapte datas antes de seguir adiante.
Multi-action
Depois de localizar novos dados, envie para múltiplas ferramentas em um único fluxo automatizado.
Por que usar o HTTP Request na Pluga?
Agora que você já entendeu como funciona o HTTP Request na Pluga e descobriu os principais cenários de uso, por que vale a pena investir nessa funcionalidade?
✅ Mais liberdade: integre ferramentas que não possuem integração nativa;
✅ Automação real: elimine tarefas manuais e ganhe tempo;
✅ Personalização total: configure chamadas de API conforme a sua necessidade;
✅ Escalabilidade: conecte sua operação com qualquer sistema que ofereça uma API aberta;
Perguntas frequentes
O que é o HTTP Request da Pluga?
O HTTP Request é um recurso da Pluga que permite buscar e enviar dados entre ferramentas via API, mesmo quando elas não possuem integração nativa. Com ele, é possível automatizar a comunicação entre diferentes sistemas.
Serve para integrar ferramentas que possuem API aberta, permitindo que você:
– Consulte dados periodicamente de uma API;
– Envie informações automaticamente para outra ferramenta;
– Atualize ou apague registros com base em eventos de gatilho.
Você configura o endpoint da API, define quais dados devem ser coletados ou enviados e a Pluga faz o restante automaticamente, realizando chamadas HTTP (como GET, POST, PUT, PATCH ou DELETE) de acordo com o que for configurado.
Os principais métodos HTTP suportados pela Pluga são:
GET – para buscar dados;
POST – para criar novos dados;
PUT / PATCH – para atualizar dados existentes;
DELETE – para apagar dados em uma ferramenta de destino.
Não é obrigatório saber programar, mas é importante ter conhecimentos básicos sobre APIs e saber interpretar documentações técnicas para configurar corretamente o endpoint, os parâmetros e os campos que serão mapeados.
A chave única serve para identificar cada registro de forma exclusiva (como um ID, e-mail ou CPF), evitando que os mesmos dados sejam enviados mais de uma vez para a ferramenta de destino.
O endpoint é geralmente fornecido na documentação técnica da API da ferramenta que você deseja integrar. Ele é uma URL que indica onde os dados devem ser buscados ou enviados.
Sim. A Pluga permite o uso de Query Params para filtrar resultados, limitar registros retornados ou buscar informações por período de tempo, por exemplo.
Sim. Durante a configuração, é possível adicionar parâmetros de cabeçalho (headers) como autenticação (ex: Bearer Token) ou outros campos exigidos pela API.
