Skip to main content
O Workspace ID é o identificador único do seu espaço de trabalho na Tess. Ele é necessário em todas as chamadas à API da Tess, incluindo integrações feitas com N8n, Zapier, Make, Power Automate, códigos em HTML/JavaScript ou qualquer outra ferramenta que envie requisições HTTP. Esse identificador é enviado no header x-workspace-id e informa de qual workspace a requisição parte. Na prática, ele define de onde os créditos da execução serão consumidos.
O Workspace Id não funciona como um filtro, você pode localizar qualquer agente público na API que está disponível na Tess e que estejam em outros Workspaces.

​
O que é?

Todo usuário da Tess está vinculado a um ou mais workspaces: espaços onde agentes, automações, membros e créditos são organizados. O Workspace ID é o código numérico que identifica cada um desses ambientes de forma única. Sempre que você faz uma chamada à API da Tess — seja diretamente por código ou por uma plataforma integradora — envie o Workspace ID no header x-workspace-id. A Tess usa esse valor para identificar:
  • O workspace de origem da requisição;
  • O workspace associado à API Key utilizada;
  • O workspace de onde os créditos da execução serão descontados.
Importente:O x-workspace-id não limita quais agentes podem ser executados. Você pode executar agentes públicos de outros workspaces, desde que tenha acesso a eles. Nesse caso, a chamada continua partindo do seu workspace e os créditos são consumidos dele.

​
Onde encontrar

Para localizar o Workspace ID do ambiente atual:
  1. Na Tess, abra as Configurações.
  2. Clique em Workspace.
  3. Localize o campo Workspace ID.
  4. Copie apenas o número informado.
Essa é a forma recomendada, pois evita confusões quando você tem acesso a mais de um workspace.
Captura De Tela 2026 07 21 Às 11 37 55
Há uma opção alternativa, identificando via URL, mas precisa de atenção para que não haja nenhum erro:
  • Observe a barra de endereços do navegador e localize o parâmetro w=. O número logo após esse parâmetro é o Workspace ID.

    Exemplo:
Ao usar a URL, confirme que você está navegando no workspace correto antes de copiar o valor.

​
Aplicando na API

Inclua o Workspace ID no header x-workspace-id em toda requisição enviada à API da Tess. Além dele, inclua também sua API Key no header Authorization.
Isso se aplica a chamadas realizadas por:
  • Código próprio, como HTML, JavaScript, Python ou outras linguagens;
  • Ferramentas de teste de API, como Postman ou Insomnia;
  • Plataformas de automação, como N8n, Zapier, Make e Power Automate;
  • Sistemas internos, CRMs, backends e integrações personalizadas.
Em plataformas integradoras, configure esses valores manualmente na seção de Headers do módulo ou etapa de requisição HTTP. Depois, envie os demais parâmetros da chamada, como o agent_id e o prompt que será processado pelo agente.

​
Boas práticas

  • Inclua o x-workspace-id em todas as requisições à API da Tess.
  • Priorize a consulta em Configurações > Workspace para copiar o ID correto.
  • Copie apenas o número do Workspace ID, sem espaços ou caracteres adicionais.
  • Use sempre o Workspace ID associado à API Key configurada na integração.
  • Em automações com múltiplos agentes, mantenha o mesmo x-workspace-id quando as chamadas partirem do mesmo workspace.
  • Armazene a API Key em variáveis de ambiente, cofres de credenciais ou campos seguros da plataforma integradora.
  • Nunca compartilhe sua API Key em prompts, mensagens, repositórios públicos ou capturas de tela.
Observação importanteEm qualquer integração com a API da Tess, envie o x-workspace-id junto à sua API Key. Esse header identifica o workspace de origem da chamada e garante que os créditos sejam contabilizados corretamente — seja em um código próprio, no N8n, Zapier, Make ou outra ferramenta de automação.