Skip to main content
A Conexão Universal oferece uma seção de Autenticação para adicionar headers de autenticação automaticamente, e uma seção de Credenciais para armazenar valores sensíveis como tokens e chaves de API.

​
Autenticação

Na seção Autenticação da aba Envio, selecione o Tipo de Autenticação no dropdown. As opções disponíveis são:
TipoDescrição
NenhumaSem autenticação automática
Bearer TokenToken Bearer no header Authorization
API KeyChave de API em header customizável
Basic AuthHTTP Basic Auth (usuário e senha em Base64)
Headers CustomizadosHeaders personalizados com interpolação de variáveis

​
Nenhuma

Nenhum header de autenticação é adicionado automaticamente. Útil quando a autenticação é feita via URL (como no Telegram) ou quando o serviço não exige autenticação.

​
Bearer Token

Adiciona automaticamente o header Authorization: Bearer {token} em todas as requisições.
CampoDescrição
Chave do Bearer TokenNome da credencial que contém o token (padrão: token)
Ao selecionar esta opção, crie uma credencial com a chave correspondente. Por exemplo, se a Chave do Bearer Token for token, adicione uma credencial com o nome token e o valor do seu token. Header gerado automaticamente: 
Authorization: Bearer sk_live_abc123def456

​
API Key

Adiciona a chave de API em um header customizável.
CampoDescrição
Header da API KeyNome do header que receberá a chave (padrão: X-API-Key)
Chave da API KeyNome da credencial que contém o valor (padrão: apiKey)
Header gerado automaticamente: 
X-API-Key: minha-chave-secreta

​
Basic Auth

Adiciona o header Authorization com usuário e senha codificados em Base64.
CampoDescrição
Chave do UsuárioNome da credencial do usuário (padrão: username)
Chave da SenhaNome da credencial da senha (padrão: password)
Crie duas credenciais com os nomes correspondentes e seus respectivos valores. Header gerado automaticamente: 
Authorization: Basic bWV1X3VzdWFyaW86bWluaGFfc2VuaGE=

​
Headers Customizados

Permite definir headers personalizados com suporte a interpolação de variáveis. Use esta opção quando a API exige um esquema de autenticação não padrão. Clique em Adicionar Header para adicionar pares de Chave e Valor. Os valores suportam variáveis de credenciais com a sintaxe ${credentials.xxx}. Exemplo:
ChaveValor
X-Token${credentials.apiToken}
X-Account-ID${credentials.accountId}

​
Credenciais

A seção Credenciais (na aba Envio) permite armazenar pares chave-valor de forma segura. Clique em Adicionar Credencial para criar uma nova entrada com Nome da variável e Valor. As credenciais podem ser referenciadas em qualquer campo da configuração usando a sintaxe ${credentials.nomeDaChave}.

​
Onde usar credenciais

LocalExemplo
Caminho da URL/bot${credentials.botToken}/sendMessage
Template do Body{ "token": "${credentials.apiKey}" }
Parâmetros de Queryapi_key=${credentials.apiKey}
Headers customizados${credentials.apiToken}

​
Credenciais vs Autenticação

A autenticação e as credenciais resolvem problemas diferentes:
AutenticaçãoCredenciais
O que fazAdiciona headers automaticamenteArmazena variáveis reutilizáveis
Onde atuaApenas em headers HTTPEm qualquer campo (URL, body, query, headers)
Quando usarQuando o serviço aceita autenticação via headerQuando o token precisa estar na URL, no body, ou em múltiplos locais
Exemplo prático: A API do Telegram exige o token no caminho da URL (/bot{TOKEN}/sendMessage), não em headers. Nesse caso, o tipo de autenticação é Nenhuma e o token é armazenado como credencial para ser usado no campo Caminho: /bot${credentials.botToken}/sendMessage.

​
Segurança

  • Headers sensíveis (authorization, x-api-key, token, secret) são mascarados automaticamente nos logs de atividade
  • Utilize sempre HTTPS na URL Base para garantir que as credenciais trafeguem de forma segura
  • Rotacione tokens e chaves periodicamente