List Telegram messages

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

List Telegram messages

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

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 instance(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 message.

includeEvents

string

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

Response

List 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

Show child attributes

pagination

object

required

Show child attributes

Webhook Events Send Telegram message