Team
Last updated
Was this helpful?
Last updated
Was this helpful?
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: .
id
String
The unique identifier for the teammate which is given by Tiledesk.
role
String
The teammate role. Values: owner, agent, admin, user, guest
user_available
Boolean
Dermine if the teammate is available or unavailable to accept requests
id_user
Object
The user object referenced by the teammate
max_served_chat
Number
Number of chats that agent is allowed to take at one time (Only Enterprise)
number_assigned_requests
Number
Number of active request for the teammate (Only Enterprise)
isBusy
Boolean
Determine if the teammate is busy (Only Enterprise)
attributes
Object
The custom attributes which are set for the teammate.
tags
Array
A list of tags objects associated with the teammate.
settings
Object
The setting configurations of the teammate.
presence
Object
The presence info of the teammate.
isAuthenticated
Boolean
Returns true if is strongly authenticated (custom-auth or email/password), false otherwise (anonymous).
isBusy
Boolean
Returns true if is teammate is busy, false otherwise. See Tiledesk Smart Assignment for more info.
createdAt
String
The time (ISO-8601 date string) when the teammate was created.
updatedAt
String
The time (ISO-8601 date string) when the teammate was updated.
createdBy
String
The unique identifier of the row creator
id_project
String
The unique identifier of the project
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
project_id
string
the Project Id is a unique code assigned to your project when you create it in Tiledesk.
Authorization
string
Authorization token. Basic Auth or JWT. Minumun role: agent
GET
https://api.tiledesk.com/v3/:project_id/project_users/:project_user_id
project_id
string
the Project Id is a unique code assigned to your project when you create it in Tiledesk.
project_user_id
string
The teammate identifier.
Authorization
string
Authorization token. Basic Auth or JWT. Minumun role: agent
GET
https://api.tiledesk.com/v3/:project_id/project_users/users/:user_id
project_id
string
the Project Id is a unique code assigned to your project when you create it in Tiledesk.
user_id
string
The user identifier.
Authorization
string
Authorization token. Basic Auth or JWT. Minumun role: agent
POST
https://api.tiledesk.com/v3/:project_id/project_users/invite
Invite an agent to a project.
project_id
string
The project_id is a unique code assigned to your project when you create it in Tiledesk
Authorization
string
Authorization token. Basic Auth or JWT. Minumun role: admin
Content-Type
string
use "application/json" value
string
the agent email address
role
string
the agent role. Accepted values: agent, admin
firstname
string
the firstname of the agent
lastname
string
the lastname of the agent
user_available
boolean
the initial agent status. Available (true) or unavailable (false).
PUT
https://api.tiledesk.com/v3/:project_id/project_users/
project_id
string
The project_id is a unique code assigned to your project when you create it in Tiledesk
Authorization
string
Authorization token. Basic Auth or JWT. Minumun role: agent
Content-Type
string
use "application/json" value
role
string
The teammate role. Permitted values: admin, agent.
user_available
boolean
The teammate availability. True for available, false for unavailable.
Default is true
max_served_chat
number
The number of concurrent chats the teammate can take at once.
attributes
object
The teammate custom attributes
settings
object
The teammate settings object
PUT
https://api.tiledesk.com/v3/:project_id/project_users/:project_user_id
It requires admin role
project_id
string
The project_id is a unique code assigned to your project when you create it in Tiledesk
project_user_id
string
The teammate identifier.
Authorization
string
Authorization token. Basic Auth or JWT. Minumun role: admin
Content-Type
string
use "application/json" value
role
string
The teammate role. Permitted values: admin, agent.
user_available
boolean
The teammate availability. True for available, false for unavailable.
Default is true
max_served_chat
number
The number of concurrent chats the teammate can take at once.
attributes
object
The teammate custom attributes
settings
object
The teammate settings object
DELETE
https://api.tiledesk.com/v3/:project_id/project_users/:project_user_id
Leave an agent from a project.
project_id
string
The project_id is a unique code assigned to your project when you create it in Tiledesk
project_user_id
string
The teammate identifier.
Authorization
string
Authorization token. Basic Auth or JWT. Minumun role: admin
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).