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 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
- Em Sistema › Integrações › Integração de API, clique em Gerar API Key.
- Leia o aviso de exibição única e clique em Confirmar e Gerar.
- A janela Credenciais Geradas com Sucesso mostra a API Key e o Secret. Copie os dois e guarde em local seguro.
- 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.
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
- 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.
- 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ção | O que acontece |
|---|---|
| Regenerar API Key | Gera credenciais novas. A chave atual é revogada na hora e todas as integrações que a usavam param até receberem as novas credenciais. |
| Revogar API Key | Para 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
| Regra | Detalhe |
|---|---|
| Quem pode | Só Proprietário ou Administrador vê, gera, regenera e revoga a chave |
| Uma chave por empresa | Só existe uma API Key ativa por vez. Gerar outra revoga a anterior |
| Exibição única | API Key e Secret não podem ser vistos de novo |
| Acesso da chave | As 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 chamadas | A API está sujeita a limite de uso. Acima dele, responde com erro 429; espere e tente de novo. |
| Empresa inativa | Se 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.
A nossa equipe ajuda você a configurar e usar esse recurso.