Engage

Getting started
Changelog
Supported message types by channel
Message Schemas
Response Operations
Callbacks
Authorization
- Authorizationpost
Conversations
Messages
- Append messagepost
- Delete message(s)delete
Participants
Groups
Teams
Skills
- Fetch list of skillsget
Users
User_Presence
Business Hours
Holiday Lists
Overrides Lists

Engage

Getting started
Changelog
Supported message types by channel
Message Schemas
Response Operations
Callbacks
Authorization
- Authorizationpost
Conversations
Messages
- Append messagepost
- Delete message(s)delete
Participants
Groups
Teams
Skills
- Fetch list of skillsget
Users
User_Presence
Business Hours
Holiday Lists
Overrides Lists

Fetch user presence

get https://api-us-site-1.imiengage.io/api/v1/teams/{teamId}/users/{userId}/presence

This endpoint allows you to fetch the user's presence in a team

Note:

This endpoint will be rate limited in the future - 10 requests/user/hour
The response reflects the user's presence in real time

Best practices:

Always check for user's login status first before evaluating presence - use the `isLoggedIn`` param to do this. You can either use an && operator or 'nested if' to validate both conditions
Make sure that the user's aliasId are unique to a user and do not overlap with other users within the tenant

time	status	user agent
Retrieving recent requests…

Loading…

URL Expired

The URL for this request expired after 30 days.

Path Params

teamId

string

required

Unique idenitifier of the Team

userId

string

required

Unique identifier of the user

Responses

Response body

object

status

string

Determines whether the operation was a success or failure

code

integer

A numeric code that maps to the description of the outcome of the operation requested

description

string

Description of the outcome of the operation requested

value

object | null

Operation specific payload

Has additional fields

Headers

object

tid

string

Unique transaction ID returned in response to a request - need to be stored by the consumer for debugging/support

Response body

object

status

string

required

Determines whether the operation was a success or failure

failed

code

integer

required

A numeric code that maps to the description of the outcome of the operation requested

description

string

required

Description of the outcome of the operation requested

value

object | null

required

Operation specific payload

Has additional fields

Headers

object

tid

string

Unique transaction ID returned in response to a request - need to be stored by the consumer for debugging/support

Response body

object

status

string

required

Determines whether the operation was a success or failure

failed

code

integer

required

A numeric code that maps to the description of the outcome of the operation requested

description

string

required

Description of the outcome of the operation requested

value

object | null

required

Operation specific payload

Has additional fields

Headers

object

tid

string

Unique transaction ID returned in response to a request - need to be stored by the consumer for debugging/support

Response body

object

status

string

required

Determines whether the operation was a success or failure

failed

code

integer

required

A numeric code that maps to the description of the outcome of the operation requested

description

string

required

Description of the outcome of the operation requested

value

object | null

required

Operation specific payload

Has additional fields

Headers

object

tid

string

Unique transaction ID returned in response to a request - need to be stored by the consumer for debugging/support

Response body

object

status

string

required

Determines whether the operation was a success or failure

failed

code

integer

required

A numeric code that maps to the description of the outcome of the operation requested

description

string

required

Description of the outcome of the operation requested

value

object | null

required

Operation specific payload

Has additional fields

Headers

object

tid

string

Unique transaction ID returned in response to a request - need to be stored by the consumer for debugging/support

Updated over 1 year ago

(TBD) Fetch list of users

(TBD) Create a single user

Did this page help you?

Language

Credentials

OAuth2

Bearer

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api-us-site-1.imiengage.io/api/v1/teams/teamId/users/userId/presence \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated over 1 year ago

(TBD) Fetch list of users

(TBD) Create a single user

Did this page help you?

Engage
Getting started
Changelog
Supported message types by channel
Message Schemas
API message schema
AMB message schema
WhatsApp message schema
Email message schema
Livechat message schema
FBM message schema
SMS message schema
Response Operations
Callbacks
Authorization
Authorizationpost
Conversations
Fetch conversation notesget
Fetch conversation transcriptget
Transfer conversationpost
Update conversationpatch
Create conversationpost
Search conversationpost
Messages
Delete message(s)delete
Append messagepost
Participants
Fetch list of current participantsget
Remove participantdelete
Add participantpost
Groups
(TBD) Delete a Groupdelete
(TBD) Update a Grouppatch
(TBD) Fetch a Group's detailsget
(TBD) Create a Grouppost
(TBD) Fetch list of Groupsget
Teams
Fetch a team's working hoursget
(TBD) Delete a Teamdelete
(TBD) Update a Teampatch
(TBD) Fetch a Team's detailsget
(TBD) Create a Teampost
(TBD) Fetch list of Teamsget
Skills
Fetch list of skillsget
Users
Update a single userpatch
(TBD) Fetch a user's detailsget
(TBD) Create users in bulkpost
Update user's presence in a teampost
(TBD) Create a single userpost
Fetch user presenceget
(TBD) Fetch list of usersget
User_Presence
Business Hours
(TBD) Delete a Business Hours object by IDdelete
(TBD) Update a Business Hours object by IDpatch
(TBD) Fetch a Business Hours object by IDget
(TBD) Create a Business Hours objectpost
Fetch the list of Business Hoursget
Holiday Lists
(TBD) Delete a Holiday List by IDdelete
(TBD) Update Holiday List by IDpatch
(TBD) Fetch Holiday List by IDget
(TBD) Create a Holiday Lists objectpost
(TBD) Fetch the list of Holiday Listsget
Overrides Lists
(TBD) Delete an individual Overrides List by IDdelete
(TBD) Update an individual Overrides List by IDpatch
(TBD) Fetch an individual Overrides List by IDget
(TBD) Create an Override Listpost
(TBD) Fetch list of Overrides Listsget

Engage
Getting started
Changelog
Supported message types by channel
Message Schemas
API message schema
AMB message schema
WhatsApp message schema
Email message schema
Livechat message schema
FBM message schema
SMS message schema
Response Operations
Callbacks
Authorization
Authorizationpost
Conversations
Fetch conversation notesget
Fetch conversation transcriptget
Transfer conversationpost
Update conversationpatch
Create conversationpost
Search conversationpost
Messages
Delete message(s)delete
Append messagepost
Participants
Fetch list of current participantsget
Remove participantdelete
Add participantpost
Groups
(TBD) Delete a Groupdelete
(TBD) Update a Grouppatch
(TBD) Fetch a Group's detailsget
(TBD) Create a Grouppost
(TBD) Fetch list of Groupsget
Teams
Fetch a team's working hoursget
(TBD) Delete a Teamdelete
(TBD) Update a Teampatch
(TBD) Fetch a Team's detailsget
(TBD) Create a Teampost
(TBD) Fetch list of Teamsget
Skills
Fetch list of skillsget
Users
Update a single userpatch
(TBD) Fetch a user's detailsget
(TBD) Create users in bulkpost
Update user's presence in a teampost
(TBD) Create a single userpost
Fetch user presenceget
(TBD) Fetch list of usersget
User_Presence
Business Hours
(TBD) Delete a Business Hours object by IDdelete
(TBD) Update a Business Hours object by IDpatch
(TBD) Fetch a Business Hours object by IDget
(TBD) Create a Business Hours objectpost
Fetch the list of Business Hoursget
Holiday Lists
(TBD) Delete a Holiday List by IDdelete
(TBD) Update Holiday List by IDpatch
(TBD) Fetch Holiday List by IDget
(TBD) Create a Holiday Lists objectpost
(TBD) Fetch the list of Holiday Listsget
Overrides Lists
(TBD) Delete an individual Overrides List by IDdelete
(TBD) Update an individual Overrides List by IDpatch
(TBD) Fetch an individual Overrides List by IDget
(TBD) Create an Override Listpost
(TBD) Fetch list of Overrides Listsget

200OK

400Bad request

401Unauthorized

404Not found

500Internal server error