API HR Talenta for ClockIn and ClockOut, so you don't need to open the app and clockin/clockout

1. npm
2. nodejs (version 18 or higher - required for native fetch and FormData support)
3. yarn

Just run yarn install or npm install

NEW: The application now features automatic location detection! You only need to configure the Cookie value, as latitude and longitude will be automatically detected from your device location.

At minimum you need to specify the Cookie variable. For fallback purposes, you should also configure Latitude and Longitude.
You could copy from config.js.tmpl to config.js then change it according your value.
Then you could run using script defined in package.json

If you're experiencing 403 signature errors, you can test the fix with:

npm run test-fix

or

yarn test-fix

This will help diagnose any remaining authentication issues and verify the signature fix is working.

OPTION 1: Automatic (Recommended)

Use the new fetchCookies function to automatically get cookies:

const talenta = require('talenta-api');
const cookies = await talenta.fetchCookies('[email protected]', 'yourpassword');

OPTION 2: Manual

1. you need to login with this url https://account.mekari.com/users/sign_in?app_referer=Talenta and sign in
2. after login on the browser press F12
3. the new window/new window on bottom screen will popup and switch to Application tab, pick Cookie->https://hr.talenta.co and then scroll down until get the Cookie with name PHPSESSID or _identity
4. copy the value
5. prepare the value for program with PHPSESSID=<value> or _identity=<value>
6. open the file config.js (copy from config.js.tmpl) and change the variable cookiesTalenta to PHPSESSID=<value> or _identity=<value>
7. and good news the cookie will last forever

NEW FEATURE: The application now automatically detects your location using your device's geolocation capabilities! This means you no longer need to manually configure latitude and longitude in most cases.

How it works:

• When you run clockin/clockout, the app will automatically try to detect your current location
• If location detection succeeds, it will use your actual coordinates
• If location detection fails (e.g., no browser access, permission denied), it will fallback to the configured coordinates in config.js

Benefits:

• No manual coordinate configuration needed
• More accurate location based on your actual device location
• Automatic fallback ensures the app always works

Note: With the new auto-location detection, you may not need to manually configure coordinates. However, you should still set fallback coordinates in case auto-detection fails.

1. its easy, just go to google map
2. right click on the location
3. and select the first menu, your latitude and longitude will be copied and separated with "," like this

-6.861928521923624, 107.63578698474662
Latitude          , Longitude

4. open the file config.js (copy from config.js.tmpl) and change the variable latitude and longitude following with the value copied from google map

after everything complete you just need to run this to clockin

yarn run clockin

or

yarn run clockout

to clockout

It is just by adding timeClockIn and timeClockOut within config.js file. The time format is hh:mm. It is important to note, that you have to define both variables, otherwise, the scheduler won't work.

To start the scheduler, simply run

yarn scheduler:start

And to stop the scheduler, run,

yarn scheduler:stop

If you want to change the time for your clockIn and clockOut, you have to stop and restart the scheduler.

Functions: clockIn and clockOut
Parameters

{ lat: '-6.000', long: '107.000', cookies: 'PHPSESSID=<value>', desc: 'message' }

NEW FEATURE: You can now automatically fetch cookies using your Talenta credentials!

Function: fetchCookies
Parameters

fetchCookies(email, password)

Example usage:

const talenta = require('talenta-api');

// Fetch cookies automatically
const cookies = await talenta.fetchCookies('[email protected]', 'yourpassword');

// Use the cookies with clockIn/clockOut
await talenta.clockIn({
  lat: '-6.000',
  long: '107.000', 
  cookies: cookies,
  desc: 'Hello I am In'
});

Benefits:

• No more manual cookie extraction from browser
• Automated authentication flow
• Fresh cookies every time
• Simplifies the setup process

Testing the feature:

npm run test-fetch-cookies

or

yarn test-fetch-cookies