post https://{domainname}/CAServices/AgentAuthenticationV2/index.php
Agent authentication API is used to log in or log out agents from the system. This API method helps in the virtual logging in of agents where the agent will be able to receive online calls similar to the way when the agent is logged in through UI.
Prerequisites
To access this API we need to pass the following parameters.
Authorization parameters
| Parameter | Description |
|---|---|
| Username* | Agent ID |
| Password* | Agent password |
API parameters
| Parameter | Description |
|---|---|
| userName* | CloudAgent account name |
| apiKey* | Available in CloudAgent admin login |
| phoneNumber* | Phone number to which the calls are routed |
| action* | Enter "login" to log in the agent Enter "logout" to logout the agent |
Note
- This API is applicable to virtually log in or log out the agents in offline scenarios. This will NOT login the agents on the toolbar UI (whether it is Ozonetel toolbar or embedded iframe)
- A phone number is required to login the agent, but not necessary while passing a logout request.
- The action parameter value is not case-sensitive.
- Parameters with ‘*’ are considered to be mandatory parameters.
Possible Responses
| Success login response | "status": "success" "message": "Agent XXXXXX logged in successfully" |
| Success logout response | "status": success" "message": "Agent XXX logged out successfully" |
| Invalid userName | "status": "error" "message": "Invalid userName or apiKey" |
| Invalid apiKey | "status": "error" "message": "Invalid userName or apiKey" |
| Invalid AgentID | "status": "error" "message": "Invalid Authentication" |
| Agent not logged in | "status": "error" "message": "Agent XXXX is not logged in" |
| Agent already logged in | "status": "error" "message": "Agent has already logged in" |
| Invalid Agent Password | "status": "error" "message": "Invalid Authentication" |
| Another agent logged in with same phone number | "status": "error" "message": "XXXXXX logged in with the number (+91XXXXX)" |
Further Insights
By default, the domain name is https://in1-ccaas-api.ozonetel.com. Please refer here to change based on the need.