Skip to main content
GET
/
v1
/
telegram
/
messages
Listar mensagens enviadas
curl --request GET \
  --url https://api.notifique.dev/v1/telegram/messages \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "clxx_message_1",
      "instanceId": "clxx_inst_1",
      "to": "123456789",
      "toName": null,
      "type": "TEXT",
      "payload": {
        "message": "Olá!"
      },
      "status": "SENT",
      "externalId": "98765",
      "telegramPeer": "123456789",
      "metadata": null,
      "scheduledAt": null,
      "sentAt": "2026-04-12T14:00:00.000Z",
      "deliveredAt": null,
      "readAt": null,
      "failedAt": null,
      "errorMessage": null,
      "createdAt": "2026-04-12T13:59:50.000Z",
      "updatedAt": "2026-04-12T14:00:01.000Z"
    }
  ],
  "pagination": {
    "total": 42,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  }
}

Authorizations

​
Authorization
string
header
required

Authorization: Bearer sk_live_xxxxx

Query Parameters

​
page
string

Página (padrão definido pelo servidor).

​
limit
string

Itens por página.

​
fromDate
string

Início do intervalo (createdAt), ISO 8601.

​
toDate
string

Fim do intervalo (createdAt), ISO 8601.

​
instanceIds
string

Filtrar por instância(s); use vírgula para vários IDs.

​
status
string

Filtrar por status (vários separados por vírgula).

​
type
string

Filtrar por tipo de mensagem.

​
includeEvents
string

Se true, inclui a linha do tempo de eventos por mensagem.

Response

Lista em data e totais em pagination (total, page, limit, totalPages). Cada item traz id, instanceId, to, type, payload, status, datas (scheduledAt, sentAt, etc.) e, se pedido, events.

​
success
boolean
required
Example:

true

​
data
object[]
required
​
pagination
object
required