Como gerar o token de acesso

⏱ 3 minsem programaçãoautenticação da API externa

Para chamar a API externa, cada cliente do CRM Hyper tem dois identificadores:

• {apiId} — o ID da API externa cadastrada no seu CRM (aparece na URL de todas as rotas);
• {token} — o token Bearer, que é a "senha" das chamadas. Ele vai no cabeçalho Authorization: Bearer {token}.

1. Acesse o CRM Hyper

   Entre em app.hypersistema.com.br com seu usuário e senha.

2. Abra "API / Serviço externo"

   No menu lateral, vá em Configuração → API / Serviço externo. A tela mostra as APIs já cadastradas, cada uma com URL de Integração e o prefixo do token.

   Dica A mesma tela tem um Sandbox: selecione uma API, cole o token e teste os endpoints direto ali, sem sair do CRM.

3. Clique em "Nova API"

   Preencha o Nome (ex.: "Integração com minha loja") e selecione a Sessão (o canal que a API vai controlar). Clique em Salvar.

4. Copie o API ID e o token

   Depois de salvar, copie da tela:

   • a URL de Integração — ela contém o seu {apiId} no formato https://backend.hypersistema.com.br/v2/api/external/{apiId};
   • o token completo — gerado uma única vez. Se perder, use Atualizar na tela para renovar (o token antigo deixa de valer).

5. Teste com uma chamada

   Use o guia Enviar uma mensagem de teste para validar o token na primeira chamada — ou o sandbox da própria tela.

Próximos passos

• Enviar uma mensagem de teste — valide o token.
• Referência da API — explore as 207 rotas disponíveis.