Listar mensagens Telegram

curl --request GET \
  --url https://api.notifique.dev/v1/telegram/messages \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.notifique.dev/v1/telegram/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.notifique.dev/v1/telegram/messages"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notifique.dev/v1/telegram/messages"

	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))

}

{
  "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
  }
}

GET

messages

Listar mensagens Telegram

curl --request GET \
  --url https://api.notifique.dev/v1/telegram/messages \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.notifique.dev/v1/telegram/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.notifique.dev/v1/telegram/messages"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notifique.dev/v1/telegram/messages"

	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))

}

{
  "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
  }
}

Autorizações

Authorization

string

header

obrigatório

Authorization: Bearer sk_live_xxxxx

Parâmetros de consulta

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.

Resposta

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

obrigatório

Exemplo:

true

data

object[]

obrigatório

Show child attributes

pagination

object

obrigatório

Show child attributes

Eventos dos Webhooks Enviar mensagem no Telegram