A conexão com o Senior X é feita por uma chave de acesso e uma chave secreta de aplicação, geradas pelo administrador no painel do Senior X. O login de usuário do painel não serve: precisa ser uma chave de aplicação.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
Peça ao administrador do Senior X:
- a chave de acesso e a chave secreta da aplicação, geradas em Tecnologia → Administração → Gerenciamento de aplicações → Ações → Gerar chave. A chave secreta aparece uma única vez — guarde-a no momento em que for gerada;
- o nome do tenant — o domínio da empresa na plataforma Senior.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Senior X e clique no botão de conexão.
- Preencha os três campos:
- Chave de acesso — a chave gerada pelo administrador.
- Chave secreta — o segredo correspondente à chave de acesso.
- Nome do tenant — o domínio da empresa na plataforma.
- Salve. O card fica marcado como conectado.
O que a Toca acessa
Com a conexão ativa, a Toca lê o financeiro (contas a pagar e a receber), o estoque, os cadastros de clientes, fornecedores e produtos, e os módulos de gestão da plataforma. A integração é somente leitura: a Toca não cria, não altera e não exclui nada no Senior X. A plataforma é modular, então os serviços disponíveis dependem do que a empresa contratou e do que está publicado no seu ambiente.
Manutenção da conexão
A chave do Senior X não expira: a conexão permanece ativa até o administrador revogá-la
no painel ou você desconectar a integração na Toca. Justamente por não expirar, vale
combinar com o administrador uma rotina de troca — revogar a chave antiga e gerar uma
nova de tempos em tempos — e atualizar o card em Configurações → Integrações a cada
troca.
Problemas comuns
- Erro de autenticação logo após conectar — confira se os valores são de uma chave de aplicação gerada no Gerenciamento de aplicações, e não o login e a senha de um usuário do painel, e se foram colados sem espaços extras.
- Erro de autenticação numa conexão que funcionava — como a chave não expira, o motivo é revogação: o administrador revogou a chave no painel. Peça uma chave nova e atualize o card.
- Chave secreta perdida — ela aparece uma única vez, ao gerar a chave. Se foi perdida, o administrador precisa gerar um novo par de chaves.
- Um módulo não responde — a plataforma é modular e nem todo ambiente expõe os mesmos serviços. A orientação da própria Senior é pedir a publicação do serviço ao suporte deles.