conversations
List conversations
Returns the first 100 available conversations by default. Use limit_offset and limit_count to paginate: the first X conversations are skipped and the following Y are returned.
Permission: Conversations Read required.
Monitoring: Optional. With Monitoring OFF, only your own conversations are returned. With Monitoring ON, you can see all team conversations (subject to your supervision scope). Supervisors see conversations of supervised users; admins see all.
get/conversations
Query parameters
filterstring[]
Type of conversation
[ "ALL" ]
limit_countinteger
Example:100
Maximum number of results to return per page. Default: server-defined.
limit_offsetinteger
Number of elements that will be ignored
Response
Successful operation — the conversation list is returned.
Example response
{
"team_id": 123456,
"user_id": 654321,
"filter": "ALL",
"limit_count_setted": 1,
"total_conversation_count": 8,
"conversation_list": [
{
"conversation_id": 222111,
"type": "INTERNAL",
"tags": [
"tag1",
"tag2"
],
"star": [
"STAR1"
],
"name": "My favorite conversation",
"purpose": "Description of my favorite conversation",
"user_list": {
"user_id": 123456,
"initial": "PM",
"color": "3CC8C8",
"firstname": "Pauline",
"lastname": "Martin",
"company": "Ringover",
"concat_name": "Pauline Martin",
"email": "pauline.martin@ringover.com",
"picture": "https://cdn77.ringover.com/img/users/default.jpg"
},
"internal": [
{
"user": {
"user_id": 654321,
"initial": "JD",
"color": "3CC8C8",
"firstname": "John",
"lastname": "Doe",
"company": "MyCompany",
"concat_name": "John Doe",
"email": "myemail@domain.com",
"picture": "https://my.image.com/default.jpg",
"is_sms_write": true,
"is_administrator": true
},
"ivr": {
"id": 657657,
"name": "MyIVR",
"scenario_id": 777777,
"color": "FFD54F"
},
"group": {
"id": 999999,
"name": "myIVR",
"color": "FFD54F"
},
"number": {
"raw": 184800000,
"country_code": "33",
"country": "FR",
"e164": "+33184800000",
"international": "+33 1 84 80 00 00",
"international_alt": "33184800000",
"national": "01 84 80 00 00",
"national_alt": "0184800000",
"rfc3966": "tel:+33-1-84-80-00-00"
},
"contact": {
"contact_id": 654321,
"is_shared": true,
"social_service_id": "00P7U000015Ei75YBX",
"firstname": "John",
"lastname": "Do",
"company": "DoeCompany",
"concat_name": "John Doe",
"color": "3CC8C8",
"initial": "JD",
"creation_date": "2018-08-12T12:12:40.53Z",
"numbers": [
331797500010
]
},
"picture": "https://my.image.com/default.jpg"
}
],
"external": [
{
"user": {
"user_id": 654321,
"initial": "JD",
"color": "3CC8C8",
"firstname": "John",
"lastname": "Doe",
"company": "MyCompany",
"concat_name": "John Doe",
"email": "myemail@domain.com",
"picture": "https://my.image.com/default.jpg",
"is_sms_write": true,
"is_administrator": true
},
"ivr": {
"id": 657657,
"name": "MyIVR",
"scenario_id": 777777,
"color": "FFD54F"
},
"group": {
"id": 999999,
"name": "myIVR",
"color": "FFD54F"
},
"number": {
"raw": 184800000,
"country_code": "33",
"country": "FR",
"e164": "+33184800000",
"international": "+33 1 84 80 00 00",
"international_alt": "33184800000",
"national": "01 84 80 00 00",
"national_alt": "0184800000",
"rfc3966": "tel:+33-1-84-80-00-00"
},
"contact": {
"contact_id": 654321,
"is_shared": true,
"social_service_id": "00P7U000015Ei75YBX",
"firstname": "John",
"lastname": "Do",
"company": "DoeCompany",
"concat_name": "John Doe",
"color": "3CC8C8",
"initial": "JD",
"creation_date": "2018-08-12T12:12:40.53Z",
"numbers": [
331797500010
]
},
"picture": "https://my.image.com/default.jpg"
}
],
"last_message": {
"message_id": 11223344,
"user": {
"user_id": 123456,
"team_id": 123456,
"initial": "PM",
"color": "3CC8C8",
"firstname": "Pauline",
"lastname": "Martin",
"company": "Ringover",
"email": "pauline.martin@ringover.com",
"picture": "https://cdn77.ringover.com/img/users/default.jpg",
"concat_name": "Pauline Martin"
},
"contact": {
"contact_id": 654321,
"is_shared": true,
"social_service_id": "00P7U000015Ei75YBX",
"firstname": "John",
"lastname": "Do",
"company": "DoeCompany",
"concat_name": "John Doe",
"color": "3CC8C8",
"initial": "JD",
"creation_date": "2018-08-12T12:12:40.53Z",
"numbers": [
331797500010
]
},
"number": {
"raw": 184800000,
"country_code": "33",
"country": "FR",
"e164": "+33184800000",
"international": "+33 1 84 80 00 00",
"international_alt": "33184800000",
"national": "01 84 80 00 00",
"national_alt": "0184800000",
"rfc3966": "tel:+33-1-84-80-00-00"
},
"buffer": "Hello World",
"direction": "IN",
"archive_date": "2019-03-11T12:20:50.52Z",
"creation_date": "2018-12-21T12:20:50.52Z",
"update_date": "2018-12-21T12:20:50.52Z"
},
"total_messages_count": 8,
"creation_date": "2018-06-12T23:23:40.99Z",
"update_date": "2019-02-12T12:20:50.52Z"
}
],
"conversation_list_count": 1
}