# Bloco Requisição HTTP

> Faça chamadas HTTP para APIs externas e envie dados coletados no fluxo.

Fonte: https://gaio.social/ajuda/categoria/automacoes/bloco-requisicao-http

O bloco `Requisição HTTP` envia dados da automação para uma API externa e permite salvar o retorno em campos personalizados do contato.

## Quando usar

Use para integrar sua automação a ferramentas externas: criar leads em um CRM, consultar dados de um cliente ou disparar webhooks.

## Configure o bloco

1. Selecione o bloco `Requisição HTTP` no editor para abrir as configurações.

   ![Configuração do bloco Requisição HTTP](https://media.gaio.social/help-center/77f51562-ac0e-4697-80bd-ded5846b2853.webp)

2. Na aba `Configuração`, selecione o `Método` da requisição:
   - `Get`
   - `Post`
   - `Put`
   - `Patch`
   - `Delete`

3. Em `Endpoint`, informe a URL completa da API de destino.

4. Em `Cabeçalhos`, adicione os cabeçalhos necessários selecionando `Adicionar Cabeçalho`.

5. Em `Dados da Requisição`, monte o corpo da requisição no modo `Visual` ou digite o JSON diretamente na aba `JSON`.

6. Na aba `Mapeamento`, selecione `Adicionar Mapeamento` para relacionar um caminho da resposta JSON a um `Campo Personalizado` do contato.

7. O bloco possui duas saídas no editor: `Sucesso` e `Falha`. Conecte cada uma delas ao próximo passo correspondente.

As integrações da Gaio são de saída: a automação envia dados para sistemas externos, mas nenhuma chamada externa inicia uma automação.

## Perguntas frequentes

### Quais métodos HTTP são suportados?

GET, POST, PUT, PATCH e DELETE com cabeçalhos e corpo personalizáveis.

### A Gaio recebe retornos da API no fluxo?

As requisições enviam dados para ferramentas externas durante o fluxo.