Last updated
Last updated
A teammate is a special user who represents a Tiledesk user invited to a project with a specific role. When you work with teammates very often you will not use the user_id of the Tiledesk user but rather the specific id of your teammate in the project. In the Tiledesk API the temamate is named project_user. For example, if you want to know your project_user in a specific project, all you have to do is call this API: .
The field user_available determines if the teammate is available or unavailable to accept requests. Attention: Agent availability changes only when the agent explicitly changes from the UI from available to unavailable. If an agent is available and logs out, the agent remains available as he may have decided to serve chats from another channel (eg. Tiledesk mobile app).
GET https://api.tiledesk.com/v3/:project_id/project_users
Return the team members and availability
GET https://api.tiledesk.com/v3/:project_id/project_users/:project_user_id
GET https://api.tiledesk.com/v3/:project_id/project_users/users/:user_id
POST https://api.tiledesk.com/v3/:project_id/project_users/invite
Invite an agent to a project.
PUT https://api.tiledesk.com/v3/:project_id/project_users/
PUT https://api.tiledesk.com/v3/:project_id/project_users/:project_user_id
It requires admin role
DELETE https://api.tiledesk.com/v3/:project_id/project_users/:project_user_id
Leave an agent from a project.
Presence lets you track the online and offline status of the teammates in real-time (if you use Tiledesk or ) and store the information state. Possible values: online, offline. Attention: an agent passes from online to offline only when he closed all Tiledesk messaging apps (eg Agent web chat in all tabs and mobile apps).