Pular para o conteúdo principal

Login e aplicações integradas

Para que serve​

Esta página cobre duas coisas: como as pessoas entram no Tesselys e como conectar um sistema da sua empresa (um BI, um site, um sistema legado) ao Tesselys pela API Externa, sem uma pessoa logada.

Onde fica​

  • Login: em sso.tesselys.com.br, a tela de entrada do Tesselys.
  • API Externa: Sistema › Integrações › Integração de API, na barra lateral. A tela se chama API Externa.

Login do Tesselys​

Todas as pessoas entram pelo login do Tesselys com o próprio e-mail e senha. A mesma conta dá acesso a todas as empresas para as quais a pessoa foi convidada; depois de entrar, ela escolhe em qual empresa vai trabalhar.

O que não existe hoje

O Tesselys não oferece, na tela, configuração de login corporativo por um provedor de identidade externo (SSO por OIDC ou SAML), nem "Entrar com Google/Microsoft". O acesso é controlado pelos convites e pelos perfis de acesso de cada empresa. Veja Convidando usuários e Permissões e papéis.

API Externa​

A conexão é feita por uma API Key e um Secret exclusivos da empresa.

Antes de começar​

  • Você precisa ser Proprietário ou Administrador da empresa. Só esses perfis veem o status da chave, geram, regeneram ou revogam.
  • Gerar e revogar a chave são ações sensíveis: quando a verificação em duas etapas está em uso, quem não tem a verificação configurada não consegue concluir, e quem entrou sem digitar o código pode precisar informá-lo.
  • Tenha à mão um local seguro (cofre de senhas) para guardar a API Key e o Secret: eles aparecem uma única vez.

Gerando a chave​

  1. Em Sistema › Integrações › Integração de API, clique em Gerar API Key.
  2. Leia o aviso de exibição única e clique em Confirmar e Gerar.
  3. A janela Credenciais Geradas com Sucesso mostra a API Key e o Secret. Copie os dois e guarde em local seguro.
  4. Marque Confirmo que copiei a API Key e o Secret em local seguro e clique em Entendi, Fechar.

Ao gerar, o Tesselys cria uma conta de serviço da empresa, com acesso de Proprietário, que é quem executa as chamadas da API. Com a chave ativa, a tela mostra o início da API Key, quando e por quem foi criada e essa conta de serviço.

Exibição única

A API Key e o Secret aparecem só nessa janela. O Tesselys guarda apenas uma versão cifrada da chave e não consegue mostrá-la de novo. Se perder, gere uma nova.

Como o sistema externo usa as credenciais​

  1. Autenticar: o sistema envia a API Key e o Secret para a rota de autenticação da API Externa e recebe um token de acesso.
  2. Integrar: com o token, o sistema chama os recursos da API.

A própria tela lista os recursos disponíveis (pessoas e clientes, negociações, lançamentos financeiros, produtos, projetos, cotações, contratos, tickets, apontamento de horas, ordens de compra e cobranças) e o link Ver documentação completa. Os detalhes técnicos estão na documentação da API.

Regenerar e revogar​

AçãoO que acontece
Regenerar API KeyGera credenciais novas. A chave atual é revogada na hora e todas as integrações que a usavam param até receberem as novas credenciais.
Revogar API KeyPara confirmar, digite REVOGAR. A chave deixa de valer imediatamente, a conta de serviço é desativada e todos os sistemas conectados são desconectados. Para reconectar, gere uma nova chave.

Depois de revogada, a tela mostra a data da revogação e o botão Gerar Nova API Key.

Regras importantes​

RegraDetalhe
Quem podeSó Proprietário ou Administrador vê, gera, regenera e revoga a chave
Uma chave por empresaSó existe uma API Key ativa por vez. Gerar outra revoga a anterior
Exibição únicaAPI Key e Secret não podem ser vistos de novo
Acesso da chaveAs chamadas são feitas pela conta de serviço da empresa, com acesso de Proprietário. Trate a chave como uma senha de administrador
Volume de chamadasA API está sujeita a limite de uso. Acima dele, responde com erro 429; espere e tente de novo.
Empresa inativaSe a empresa estiver inativa, a API recusa a chave

Perguntas frequentes​

Posso ter uma chave diferente para cada sistema?​

Não. A empresa tem uma única API Key ativa; todos os sistemas integrados usam a mesma. Por isso, ao regenerar, atualize todos eles.

Perdi o Secret. Consigo ver de novo?​

Não. O Secret é exibido só na geração. Use Regenerar API Key e atualize as integrações com as novas credenciais.

O meu sistema recebe "API Key inválida ou expirada" ou "Secret inválido". O que fazer?​

A chave foi regenerada ou revogada, ou o Secret foi copiado errado. Gere uma nova chave e atualize o sistema.

O meu sistema recebe "A conta de serviço está inativa. Gere uma nova API Key."​

A chave foi revogada. Gere uma nova em Sistema › Integrações › Integração de API.

Não vejo a tela Integração de API.​

Ela é exclusiva do Proprietário e do Administrador da empresa.

O Tesselys tem login único com o provedor de identidade da minha empresa?​

Não pela tela. O acesso é por e-mail e senha no login do Tesselys, com convites e perfis de acesso.

Quero que o meu sistema seja avisado quando algo acontecer no Tesselys. Uso a API?​

Para receber avisos em tempo real, use Webhooks. A API Externa serve para o seu sistema consultar e gravar dados quando ele precisar.

Ainda com dúvida?

A nossa equipe ajuda você a configurar e usar esse recurso.