Por que esse processo precisa ser feito pelo cliente
Como parceiro de integração, a Niuco não pode gerar nem solicitar essas credenciais em nome do cliente. Isso acontece porque:
- Apenas o Administrador Geral da empresa no painel da Tako tem permissão para solicitar credenciais de API junto ao suporte/segurança da Tako.
- A Tako não envia
organizationId,accessKeyeaccessSecretpor e-mail convencional. Eles são entregues por um link seguro e temporário, de acesso único, gerado exclusivamente para quem abriu a solicitação. - Por isso, é o cliente quem precisa abrir o chamado com a Tako e, depois, repassar as credenciais para a Niuco por um canal seguro.
Passo a passo
1. Identifique o Administrador Geral da empresa na Tako
Confirme com o cliente quem é o usuário com perfil de Administrador Geral da conta Tako. Só esse perfil pode solicitar as credenciais.
2. Abra a solicitação com a Tako
O Administrador Geral deve contatar a Tako por um dos dois canais:
- Falando diretamente com o CSM (Gerente de Contas) responsável pela conta; ou
- Abrindo um chamado no suporte interno do próprio painel administrativo da Tako.
Use o modelo de e-mail abaixo como base para essa solicitação.
Modelo de e-mail para o cliente enviar à Tako
Assunto: Solicitação de credenciais de API — Integração Niuco x Tako
Olá, equipe Tako,
Estamos avançando com a integração entre a Niuco e a Tako para automatizar
o mapeamento dos colaboradores da folha de pagamento em nossa plataforma.
Para isso, precisamos das credenciais de acesso à API da Tako (ambiente
de produção).
Poderiam nos fornecer os seguintes dados de acesso?
- Organization ID (identificador da organização/empresa na Tako)
- Access Key
- Access Secret
Essas credenciais serão utilizadas para:
- Gerar um token de autenticação via endpoint de login da API;
- Consultar a lista de contratos/colaboradores (nome, departamento,
centro de custo, datas de admissão/desligamento, e-mail corporativo,
gestor) para realizar o mapeamento automático dos usuários da folha
dentro da plataforma Niuco.
Caso exista alguma etapa adicional de habilitação (ex.: liberação de IP,
escopo de permissões específico para consulta de contratos/organização,
ou aprovação de um novo integrador), pedimos que nos orientem sobre o
processo.
Ficamos à disposição para qualquer esclarecimento necessário.3. Aguarde o link seguro
A equipe de segurança da Tako vai gerar um link temporário contendo organizationId, accessKey e accessSecret.
⚠️ Atenção: o link expira após o primeiro acesso. Assim que abrir, copie os três dados imediatamente para um local seguro (gerenciador de segredos, cofre de senhas, variável de ambiente). Se o link expirar antes de copiar os dados, será necessário abrir uma nova solicitação com a Tako.
4. Cadastre as credenciais na plataforma Niuco
Com os dados em mãos, o próprio cliente deve inserir as credenciais diretamente na plataforma Niuco:
- Acesse o site da Niuco e vá até Conexão de Organogramas.
- Busque pelo card da Tako e clique nele.
- Siga as etapas indicadas até chegar na tela que solicita os campos
organizationId,accessKeyeaccessSecret. - Preencha os campos com os dados recebidos no link seguro.
- Clique em Conectar.
Pronto — a conexão é validada e o cliente já pode encerrar o chamado.
Perguntas frequentes
A Niuco pode abrir esse chamado direto com a Tako?
Não. A Tako só atende solicitações de credenciais vindas do Administrador Geral da conta do próprio cliente.
O que fazer se o link expirar antes de copiarmos as credenciais?
Solicitar à Tako a geração de um novo link, repetindo o passo 2.
Preciso enviar as credenciais para a Niuco por e-mail ou chat?
Não. As credenciais são inseridas pelo próprio cliente diretamente na plataforma Niuco, na tela de conexão da Tako (item 4 do passo a passo). Não é necessário compartilhá-las com o time da Niuco por nenhum outro canal.