Listar conversas
Lista os atendimentos da empresa, ordenados pela data da última atualização. Pela API não existe o filtro de visibilidade por atendente que a tela do sistema aplica. O token enxerga todos os atendimentos da empresa.
Cada atendimento traz a janela da Meta (metaWindowOpenTimestamp, metaWindowType) e o
protocolo atual (protocol), carregados por página, sem chamada extra.
curl --request GET \
--url https://api.connectadesk.com/api/v1/tickets \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.connectadesk.com/api/v1/tickets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.connectadesk.com/api/v1/tickets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.connectadesk.com/api/v1/tickets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.connectadesk.com/api/v1/tickets"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.connectadesk.com/api/v1/tickets")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.connectadesk.com/api/v1/tickets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 5120,
"status": "open",
"unreadMessages": 2,
"lastMessage": "Perfeito, vou querer o tamanho M",
"isGroup": false,
"automation": false,
"contact": {
"id": 842,
"name": "Maria Silva",
"number": "5511987654321",
"numberCountry": "BR",
"email": "maria.silva@exemplo.com.br",
"code": "CLI-00842",
"cpfCnpj": "12345678909",
"origin": "site",
"profilePicUrl": "https://cdn.exemplo.com/avatars/842.jpg",
"isGroup": false,
"instagramUsername": "maria.silva",
"lid": null,
"sourceUrl": "https://loja.exemplo.com.br/promo",
"sourceId": "23851234567890123",
"headline": "Coleção de inverno",
"mediaType": "image",
"mediaUrl": "https://cdn.exemplo.com/anuncios/inverno.jpg",
"utmSource": "instagram",
"utmMedium": "cpc",
"utmCampaign": "inverno-2026",
"utmId": "6543210987",
"fbclid": "IwAR0xYzAbC123",
"gclid": null,
"ctwaClid": null,
"tags": [
{
"id": 3,
"name": "Cliente VIP",
"color": "#6941C6"
}
],
"customFields": [
{
"key": "plano",
"value": "Ouro",
"customFieldId": 91,
"name": "Plano",
"type": "select"
}
],
"lastChannel": {
"id": 11,
"name": "Instagram Loja",
"type": "instagram"
},
"createdAt": "2026-07-14T13:22:05.412Z",
"updatedAt": "2026-08-18T09:41:17.883Z"
},
"queue": {
"id": 13,
"name": "Comercial",
"color": "#0E7490"
},
"user": {
"id": 3,
"name": "Gabriel Goulart"
},
"channel": {
"id": 11,
"name": "Instagram Loja",
"type": "instagram"
},
"tags": [
{
"id": 3,
"name": "Cliente VIP",
"color": "#6941C6"
}
],
"metaWindowOpenTimestamp": "2026-08-18T14:20:03.000Z",
"metaWindowType": 24,
"protocol": {
"id": 21877,
"userId": 3,
"channelId": 11,
"startedFrom": "receptive",
"startedFromContact": true,
"fromApi": false,
"fromAutomation": false,
"campaignSlug": null,
"rated": false,
"nps": null,
"createdAt": "2026-08-18T12:03:44.001Z",
"queuedAt": "2026-08-18T12:03:44.120Z",
"startedAt": "2026-08-18T12:05:10.300Z",
"userFirstAnswerAt": "2026-08-18T12:05:41.002Z",
"lastCustomerReplyAt": "2026-08-18T14:20:03.000Z",
"lastOperatorReplyAt": "2026-08-18T14:27:10.556Z",
"finishedAt": null,
"ratingAt": null,
"metaData": {
"pedido": "PED-48213",
"origem": "site"
}
},
"createdAt": "2026-08-18T12:03:44.001Z",
"updatedAt": "2026-08-18T14:27:10.556Z"
}
],
"meta": {
"page": 1,
"perPage": 20,
"hasMore": true
}
}Autorizações
Token da API no formato sk_live_….
Parâmetros de consulta
Número da página, começando em 1. Um valor inválido é tratado como 1.
x >= 1Quantidade de itens por página. O máximo depende do ambiente (padrão 100).
1 <= x <= 100Filtra pela situação do atendimento. Aceita vários valores separados por vírgula (ex.: open,pending).
"open,pending"
Somente atendimentos desta fila.
Somente atendimentos deste atendente responsável.
Somente atendimentos com esta tag.
Início do período, no fuso horário da empresa.
Fim do período, no fuso horário da empresa.
Define qual data o filtro de período usa: a de criação ou a da última atualização.
created, updated curl --request GET \
--url https://api.connectadesk.com/api/v1/tickets \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.connectadesk.com/api/v1/tickets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.connectadesk.com/api/v1/tickets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.connectadesk.com/api/v1/tickets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.connectadesk.com/api/v1/tickets"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.connectadesk.com/api/v1/tickets")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.connectadesk.com/api/v1/tickets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 5120,
"status": "open",
"unreadMessages": 2,
"lastMessage": "Perfeito, vou querer o tamanho M",
"isGroup": false,
"automation": false,
"contact": {
"id": 842,
"name": "Maria Silva",
"number": "5511987654321",
"numberCountry": "BR",
"email": "maria.silva@exemplo.com.br",
"code": "CLI-00842",
"cpfCnpj": "12345678909",
"origin": "site",
"profilePicUrl": "https://cdn.exemplo.com/avatars/842.jpg",
"isGroup": false,
"instagramUsername": "maria.silva",
"lid": null,
"sourceUrl": "https://loja.exemplo.com.br/promo",
"sourceId": "23851234567890123",
"headline": "Coleção de inverno",
"mediaType": "image",
"mediaUrl": "https://cdn.exemplo.com/anuncios/inverno.jpg",
"utmSource": "instagram",
"utmMedium": "cpc",
"utmCampaign": "inverno-2026",
"utmId": "6543210987",
"fbclid": "IwAR0xYzAbC123",
"gclid": null,
"ctwaClid": null,
"tags": [
{
"id": 3,
"name": "Cliente VIP",
"color": "#6941C6"
}
],
"customFields": [
{
"key": "plano",
"value": "Ouro",
"customFieldId": 91,
"name": "Plano",
"type": "select"
}
],
"lastChannel": {
"id": 11,
"name": "Instagram Loja",
"type": "instagram"
},
"createdAt": "2026-07-14T13:22:05.412Z",
"updatedAt": "2026-08-18T09:41:17.883Z"
},
"queue": {
"id": 13,
"name": "Comercial",
"color": "#0E7490"
},
"user": {
"id": 3,
"name": "Gabriel Goulart"
},
"channel": {
"id": 11,
"name": "Instagram Loja",
"type": "instagram"
},
"tags": [
{
"id": 3,
"name": "Cliente VIP",
"color": "#6941C6"
}
],
"metaWindowOpenTimestamp": "2026-08-18T14:20:03.000Z",
"metaWindowType": 24,
"protocol": {
"id": 21877,
"userId": 3,
"channelId": 11,
"startedFrom": "receptive",
"startedFromContact": true,
"fromApi": false,
"fromAutomation": false,
"campaignSlug": null,
"rated": false,
"nps": null,
"createdAt": "2026-08-18T12:03:44.001Z",
"queuedAt": "2026-08-18T12:03:44.120Z",
"startedAt": "2026-08-18T12:05:10.300Z",
"userFirstAnswerAt": "2026-08-18T12:05:41.002Z",
"lastCustomerReplyAt": "2026-08-18T14:20:03.000Z",
"lastOperatorReplyAt": "2026-08-18T14:27:10.556Z",
"finishedAt": null,
"ratingAt": null,
"metaData": {
"pedido": "PED-48213",
"origem": "site"
}
},
"createdAt": "2026-08-18T12:03:44.001Z",
"updatedAt": "2026-08-18T14:27:10.556Z"
}
],
"meta": {
"page": 1,
"perPage": 20,
"hasMore": true
}
}
