APIs › Mensagem › API Obter Mensagens por Ticket

API Obter Mensagens por Ticket

Todas

Obter as mensagens de um ticket — do atendimento inteiro, com limite e paginação.

API: Todas

Endpoint

https://apichat.agpt.com.br/api/tickets/{ticketId}/messages?limit=50&pageNumber=1

Método

GET

Autenticação

Bearer {seutokenaqui}

Payload

// sem payload — o ticketId vai no endereço e os filtros na própria URL

“ticketId”: ID do Ticket — vai no próprio endereço, no lugar de {ticketId}. Obrigatório.

É o número entre parênteses no cabeçalho da conversa. Em João da Silva (52) | #25678, o ticketId é o 52.

O 25678 é o protocolo, e não serve nesta chamada.

“limit”: quantas mensagens trazer. Padrão 50, máximo 200. Um valor maior não dá erro: ele é reduzido para 200, e a resposta informa em limit o que foi aplicado.

O limit recorta as últimas mensagens do atendimento, não as primeiras — e elas vêm em ordem cronológica, a mais antiga primeiro.

“pageNumber”: padrão 1, com as mensagens mais recentes. 2 traz o bloco anterior, e assim por diante.

As páginas andam para trás no tempo: a 1 é a mais recente. Para montar o histórico inteiro, repita a chamada com pageNumber 2, 3… enquanto a resposta trouxer "hasMore": true, e junte as páginas de trás para a frente.

Utilize o código em requisições HTTPS com ferramentas como cURL ou bibliotecas de integração.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://apichat.agpt.com.br/api/tickets/{ticketId}/messages?limit=50&pageNumber=1',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer {seutokenaqui}' //Token cadastrado na conexão
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;