> For the complete documentation index, see [llms.txt](https://digisac.gitbook.io/manual-digisac-2-0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digisac.gitbook.io/manual-digisac-2-0/mais-opcoes/robos/fluxograma/como-configurar-blocos-de-requisicao-http.md).
# Como configurar blocos de requisição http
O bloco **Requisição HTTP** permite que o robô se conecte diretamente a APIs externas para enviar ou buscar informações durante o fluxo. Com ele, o bot consegue integrar-se a sistemas internos e externos e qualquer serviço que disponibilize uma API.
### O que é possível fazer com blocos de requisição http:
* Realizar chamadas HTTP nos seguintes métodos:
* **GET** - pedir informações;
* **POST** - enviar novo item;
* **PUT** - substituir ou atualizar tudo;
* **DELETE** - remover item.
* Utilizar **variáveis do bot** em qualquer campo da requisição (URL, headers, parâmetros ou body).
* Transformar a **resposta da API** em novas variáveis para uso em blocos seguintes.
* Criar condições baseadas:
* no **status da resposta** (ex.: 200, 400, 404 etc.)
* no **conteúdo retornado** (ex.: campos específicos do JSON)
* Selecionar quantidade de tentativas em caso de falha e tempo de timeout.
### Como configurar blocos de requisição http
1. No Menu Principal, acesse **Mais opções** > **Robôs**.
2. Crie um novo Robô em **+ Adicionar** > **Fluxograma** ou utilize um robô fluxograma já existente, clicando nos **três pontinhos (⋮)** > **Editar**
3. Dentro do construtor, no canto esquerdo, vá até a seção **Automações** e selecione o bloco **Enviar Requisição HTTP** (logo abaixo de “Enviar webhook”).
4. A primeira etapa da configuração do bloco é constituída em três áreas principais:
**Configurações básicas:**
* **Nome da requisição** - Identifica essa requisição dentro do robô (especialmente útil quando você tem várias chamadas diferentes);
* **URL do endpoint** - Endereço da API que será acessada.
* A URL não é validada no momento da configuração. Se estiver errada, a requisição será feita e retornará erro, visível no **Histórico de Erros** do robô.
* **Dica:** Em requisições aninhadas, você pode utilizar uma url que foi retornada anteriormente por uma requisição já realizada. Isso também funciona com outros campos do robô.
* **Método HTTP** - Selecione o método da requisição:
* **GET** – consultar informações
* **POST** – enviar informações
* **PUT** – atualizar
* **DELETE** – remover
**Configurações internas:**
* **Cabeçalhos cadastrados (Headers)** - É opcional, permite cadastrar diversos cabeçalhos, além de editar ou apagar um cabeçalho já adicionado anteriormente. Para cadastrar, preencha:
* Chave do cabeçalho;
* Valor do cabeçalho;
* Ative a chave **Ocultar dados sensíveis** para ocultar o valor do cabeçalho na tela. Essa opção pode ser utilizada para proteger informações como **senhas e tokens**. Quando marcada, o valor do cabeçalho será exibido de forma **ofuscada** na tabela, mas continuará sendo enviado normalmente pela requisição.
* Se quiser configurar mais de um cabeçalho, clique em **Adicionar cabeçalho** e repita o processo quantas vezes seja necessário.
{% hint style="warning" %}
**IMPORTANTE:** Para alterar o valor de um cabeçalho marcado como sensível, é necessário **excluí-lo e cadastrá-lo novamente**, pois o valor atual não será exibido para edição.
Os cabeçalhos cadastrados anteriormente continuam visíveis normalmente e podem ser marcados como sensíveis posteriormente.
A proteção se aplica apenas aos **headers** da requisição. Valores sensíveis inseridos no **body** não são ocultados.
{% endhint %}
* **Corpo da requisição (Body)** - Formatos aceitos:
* JSON - Digite ou cole o JSON no campo indicado;
* XML - Digite ou cole o XML no campo indicado;
* Formulário - Preencha:
* Nome;
* Valor;
* Clique em **Adicionar campo**;
* Repita o processo quantas vezes seja necessário.
* Sem corpo.
* **Requisição assíncrona (opcional)** - Por padrão, vem desativada (requisição síncrona). A diferença será explicada em diante. Para ativá-la, clique na chave ao lado.
* **Incluir dados da Digisac no payload:** Ao ativá-la, serão incluídos automaticamente no payload da requisição os IDs das entidades da Digisac relacionadas ao atendimento, como **bot**, **contato**, **conexão**, **conta**, **chamado** e **mensagem**, agrupados no campo **`digisacData`**.
{% hint style="warning" %}
Essa opção está disponível apenas em **requisições síncronas**, ou seja, quando a chave **Requisição assíncrona** estiver desativada, e em requisições com **corpo JSON** ou **vazio**.
{% endhint %}
**Tentativas e timeout:**
* **Número de tentativas** - Quantas vezes o bloco deve tentar novamente em caso de falha. Escolha entre 1 a 5 tentativas.
* **Tempo do timeout** - Tempo máximo de espera pela resposta da API. Escolha entre 30 a 120 segundos.
{% hint style="warning" %}
**IMPORTANTE:** Para configurar corretamente, é fundamental que você conheça a API que está consumindo (métodos, URLs, dados esperados, formato de resposta etc.).
{% endhint %}
5. Após preencher todas as informações da etapa 1, clique em **Continuar**.
6. Na segunda etapa do bloco - **configurações de resposta** - você poderá **mapear os dados retornados pela API** e salvá-los em variáveis para usar em qualquer parte do fluxo.
* Para cadastrá-las, preencha:
* Chave na resposta - É o **nome exato do dado** que vem na resposta da sua requisição. Ou seja, é o “caminho” que o robô deve seguir dentro do método para encontrar a informação que você quer guardar;
* Nome da variável - É o **nome que você quer dar** para armazenar esse dado dentro do robô. Depois disso, poderá usar essa variável em outros blocos;
* Clique **Adicionar variável**;
* Repita o processo quantas vezes seja necessário.
* As variáveis podem ser usadas em:
* blocos de mensagem
* blocos condicionais
* novos blocos de requisição
* verificações dentro do fluxo
{% hint style="info" %}
**Atenção:**
* Variáveis **não** podem ter nomes duplicados.
* É necessário usá-las **após** o bloco onde foram criadas.
* O “root” da resposta **SEMPRE** é `response`.
{% endhint %}
7. Após cadastrar todas variáveis, clique em **Aplicar** e o bloco "Enviar requisição HTTP" será criado com sucesso.
***
### Como utilizar condicionais ligadas ao bloco de requisição http
Você pode conectar **blocos de condição** após blocos de requisição para poder validar informações retornadas nessas requisições. Para isso, selecione o bloco **"Configurar condição"** e arraste-o para o ambiente do robô, conectando-o após o bloco "Enviar requisição HTTP".
É possível validar:
* **O código de status** da requisição: selecione "**Código de status**" em Variável, nas configurações do bloco de condições. Exemplos de uso:
* Se status = 200 → seguir fluxo de sucesso.
* Se status = 404 → informar que o dado não foi encontrado.
* Se status = 500 → tentar outra ação ou encerrar.
* **Valores de variáveis:** selecione "**Propriedades da resposta**" em Variável, nas configurações do bloco de condições. Exemplo:
* Se `estado = "SP"` → enviar mensagem específica.
* Se `cep` estiver vazio → pedir outro dado.
***
### Requisição Síncrona x Assíncrona
#### **Síncrona (padrão)**
* O robô **espera a resposta** da API.
* O fluxo só continua após receber o retorno.
* Ideal para consultas rápidas (CEP, CPF, status de pedido etc.).
* Se a API demorar, pode gerar timeout.
#### **Assíncrona**
* O robô **não espera** a API responder.
* Fica com status `PENDING` até que o callback seja recebido com a resposta.
* A resposta chega depois via **callback**.
* Ideal para APIs lentas, processamentos complexos ou quando a resposta não é crítica para o fluxo imediato.
{% hint style="info" %}
**Importante:**
* Requisições pendentes por mais de **24h** são encerradas automaticamente por timeout.
* O callback precisa ser autenticado via token.
{% endhint %}
***
### Histórico de Erros
Se algo der errado no robô, você poderá visualizar no histórico de erros:
1. No Menu Principal, acesse **Mais Opções** > **Robô**;
2. Clique nos **3 pontinhos** ao lado do robô que deseja visualizar e **Histórico de erros.**
Ali você verá:
* requisições com falha
* detalhes do erro
* timestamp
* contexto da execução
Além disso, dentro do **chamado**, você pode acompanhar em tempo real as requisições sendo executadas e erros gerados.
***
### Exemplos práticos de ações realizáveis com Bloco HTTP
