O Bloco de Ação "Enviar solicitação HTTP" permite enviar e/ou receber dados entre a SleekFlow e a API de um sistema externo. Para utilizar esse bloco, é necessário que o sistema externo disponibilize uma API pública para possibilitar a integração com a SleekFlow.

Configure o Bloco de Ação "Enviar solicitação HTTP" seguindo as etapas abaixo:

• Configurar a solicitação HTTP
• Configurar o corpo da solicitação HTTP
• Configurar a persistência da resposta da solicitação HTTP

Configurando o Bloco de Ação "Enviar solicitação HTTP"

1. Clique no Bloco de Ação "Enviar solicitação HTTP" para abrir o formulário do bloco, que será exibido no lado direito da tela.

2. O formulário do bloco contém os seguintes campos para configurar a interação da SleekFlow com seu sistema externo para enviar e/ou recuperar dados.

• Aba Configuração
  • Método: Especifique o método HTTP esperado pela API do seu sistema externo.
    • GET: Escolha GET para solicitar dados da API do sistema externo.
    • POST: Escolha POST para enviar dados da SleekFlow para o sistema externo por meio da API.
    • PUT: Escolha PUT para atualizar ou substituir dados existentes no sistema externo por meio da API.
    • DELETE: Escolha DELETE para remover dados existentes do sistema externo por meio da API.
      
• URL: Insira a URL para acessar a API do sistema externo e suas funcionalidades.
• Cabeçalhos: Configure os pares de chave e valor necessários no cabeçalho da solicitação HTTP para acessar a API.
• Parâmetros da consulta (Query string): Configure os pares de chave e valor necessários na query string para acessar a API.
  

• Tratar erro: Ative essa opção para configurar um caminho alternativo sempre que uma solicitação HTTP falhar. Quando habilitada:
  • Um ramo adicional será criado no fluxo especificamente para solicitações com falha.
  • Você poderá configurar esse ramo para definir o que deve acontecer quando a solicitação não puder ser concluída, como, por exemplo, enviar uma mensagem de erro.
    
    

Configurar o corpo da solicitação HTTP

A seção Corpo do formulário do bloco permite configurar os dados e o tipo de conteúdo que serão enviados na solicitação HTTP para a API do sistema externo. Consulte a documentação da API do seu sistema externo para verificar a configuração e os parâmetros necessários para a integração.

Essa seção contém os seguintes campos:

• Tipo de corpo: Especifique o tipo de corpo aceito pela API do seu sistema externo. Você pode configurar o tipo de conteúdo usando uma das opções abaixo.

Tipo de corpo	Descrição
Raw	Escolha o tipo de corpo Raw se a API receber texto simples, JSON ou dados em formato de string.Especifique o tipo de conteúdo aceito pela API: Texto (text/plain) .JSON (application/json) .XML (application/xml) .HTML (text/html) .XML (text/xml) Você pode inserir os dados na caixa azul-escura de conteúdo da solicitação utilizando a sintaxe correspondente ao tipo de conteúdo selecionado.
Form-data ou x-www-form-urlencoded	Escolha o tipo de corpo que atenda aos requisitos da API e informe os dados da solicitação como pares de chave e valor. Caso seja necessário adicionar mais de um conjunto de pares de chave e valor, clique em + Adicionar conjunto para incluir outro conjunto.

Configurar a persistência da resposta da solicitação HTTP

Depois de configurar sua solicitação HTTP, você poderá analisar as respostas da API diretamente na aba Variáveis. Isso facilita a extração de campos específicos do sistema externo e permite reutilizá-los posteriormente no fluxo sem a necessidade de escrever caminhos .JSON manualmente.

How to parse API responses

1. Acesse a aba Variáveis no formulário do Bloco de Ação "Enviar solicitação HTTP".
2. Cole um exemplo da carga útil (payload) de resposta do seu sistema externo na caixa de entrada.
3. Clique em Analisar dados.
4. A SleekFlow analisará o payload e detectará automaticamente todos os campos disponíveis na resposta.
5. Após a análise, esses campos estarão disponíveis como variáveis e poderão ser usados para:
   • Inserir informações em mensagens enviadas.
   • Utilizar como condições para ramificações ou roteamento de contatos.
   • Salvar informações para uso posterior em outros Blocos de Ação.