Criar uma chave de API pessoal (PAT)

Saiba como gerar sua primeira chave de API pessoal no Omnifox para conectar integracoes, scripts ou ferramentas externas ao seu workspace.

Jun 26, 2026

Veja este passo no vídeo · Criar uma chave de API

Uma chave de API pessoal (PAT, Personal Access Token) e uma credencial que permite que aplicativos externos (n8n, Zapier, seus proprios scripts) acessem o Omnifox em seu nome, sem compartilhar seu usuario e senha. Cada chave e emitida para um workspace especifico e pode ser limitada a determinadas permissoes.

Antes de comecar

  • Seu plano deve incluir Acesso via API (disponivel nos planos superiores). Se nao estiver ativo, voce vera um aviso para fazer upgrade.
  • Voce precisa da permissao Gerenciar chaves de API (administradores ja a possuem).
  • Voce deve pertencer ao workspace para o qual vai emitir a chave.

Passos

  1. No menu lateral, abra API Keys (Chaves de API).
  2. Clique em Nova chave.
  3. Digite um Nome descritivo (por exemplo, Integracao n8n - Vendas). Ele ajuda a identificar a chave depois.
  4. Escolha o Workspace em que a chave vai operar. Este campo e obrigatorio: a chave so podera ler e gravar dados desse workspace.
  5. (Opcional) Selecione os Scopes (permissoes). Se nao marcar nenhum, a chave tera acesso total. O recomendado e conceder apenas o necessario.
  6. (Opcional) Defina uma data em Expira em para que a chave caduque sozinha.
  7. Clique em Salvar.

Como verificar

Ao salvar, aparece a janela "Copie e salve agora" com a chave completa. O formato e 123_aBc... com um prefixo visivel como omf_1a2b.

Esta e a unica vez que a chave completa e exibida. Copie-a com o botao Copiar e guarde-a em um gerenciador de senhas. Depois de fechar a janela, so resta o prefixo.

Feche a janela e a nova chave aparece na lista de API Keys com nome, workspace e prefixo.

Se nao funcionar

  • Aparece um aviso de plano (erro 402): seu plano nao inclui Acesso via API. Faca upgrade em Faturamento.
  • Nao encontro API Keys no menu: falta a permissao api-keys.view. Peca a um administrador para concede-la.
  • Nao consigo escolher um workspace: so aparecem os workspaces aos quais voce pertence. Peca para ser adicionado ao correto.
  • Perdi a chave: ela nao pode ser recuperada. Exclua a antiga e crie uma nova (ou use Regenerar).

Dicas

  • Use uma chave por integracao: se uma vazar, voce a exclui sem afetar as demais.
  • Para integracoes automaticas (nao para voce como agente humano), marque Token de servico (bot) ao cria-la.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp