- Introduction
- CamAttendance Integration – How does it work?
- Ways to do integration with CamAttendance
Introduction
Integration helps different applications communicate and share data. CamAttendance offers adequate flexibility to integrate CamAttendance device to your HRMS/Attendance system. Every time an employee checks-in or checks-out, data gets stored onto a CamAttendance Cloud platform, which uses webhooks and other various ways to communicate and transfer that data to your HRMS/Attendance system. Thus, integration enables your system to receive data instantaneously.
CamAttendance Integration – How Does it Work?
CamAttendance integration enables your HRMS/Attendance system to receive data immediately whenever an employee checks-in or checks-out. The device synchronizes data onto CamAttendance Cloud. This data is then transferred to your HRMS/Attendance system. There are five ways for the clients to obtain data.
- Webhooks
- FTP Server Configuration
- Scheduled Jobs
- API Integration
- Database Integration
(Refer to below diagram for integration approach)
Ways to do integration with CamAttendance
- Webhooks: A webhook (also called a web callback or HTTP push API) is a way for an app to provide other applications with real-time information. A webhook delivers data to other applications as it happens, meaning you get data immediately.KENT CamAttendance cloud using webhooks, pushes the employees / attendance data (real time) into client’s environment where Webhook APIs at client side interprets the data and automatically updates the same in the client’s database.
Endpoint URL: This is where user needs client’s webhook URL. This will be provided by the client.
Sample Webhook URL: https://yourapp.com/recievedata/
When an employee get recognized in CamAttendance device, a Webhook event gets triggered from CamAttendance system which sends employee / attendance information to client’s environment in JSON (Refer to below sample of JSON file).
Sample JSON file
[{"empId": "9999999","employeeName": "First Name Last Name","time": timestamp,"type": 1,-- 1 for recognized employee and 0 for unknown"imageUrl": "",-- In case of Unknown"accountId": 01,-- System generated"companyId": CO01, "mode": "",-- System generated"locationName": "44",-- System generated ID of location"deviceName": "ABC",--Device name"departmentName": "",--Name of Employee’s department"deviceId": "XXXXXXXX"--Device ID}]
An API at client side reads the information sent by Cam Attendance system and updates the relevant details in the HRMS / Attendance system of the client. This happens on a real time basis.
2. FTP/SFTP Server Configuration: FTP (File Transfer Protocol) is a standard network protocol used to transfer files between a client and server on a computer network.
Built on a client-server model architecture, it is able to transfer data by having the server connect back to the client, after the port command is sent by the client.
3. Scheduled jobs: A job scheduler runs at CamAttendance device which will copy employee / attendance details (excel / .CSV file format) in a designated shared path provided by the client. (Access / login credentials to be provided by the client prior to configuring this setup).
Pre- Requisite: Access to Sharespace at client’s server where export of Excel / .CSV files from CamAttendance can be copied.
4. API Integration: Through API Integration, the data can be pulled via API calls. As soon as an employee checks-in or checks-out, the data gets stored onto the CamAttendance Cloud from where it can be pulled using the API Calls. API calls are secured using the secret tokens.
5. Database Integration: Database integration enables our technical team to access the database of the clients so that we send the transactions data directly to the client’s database, which can be synchronized/viewed with the client’s HRMS/payroll system.
Prerequisites for database integration
- Server IP of database
- User id and password of database
- Table name
- Database name
See also: