https://github.com/danog/tg-dialog-id

A library to work with Telegram bot API dialog IDs.
https://github.com/danog/tg-dialog-id

bot-api telegram telegram-bot telegram-bot-api telegram-id

Last synced: 12 days ago
JSON representation

A library to work with Telegram bot API dialog IDs.

• Host: GitHub
• URL: https://github.com/danog/tg-dialog-id
• Owner: danog
• License: apache-2.0
• Created: 2024-05-10T12:08:08.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2025-06-28T15:40:43.000Z (17 days ago)
• Last Synced: 2025-06-28T16:16:10.382Z (17 days ago)
• Topics: bot-api, telegram, telegram-bot, telegram-bot-api, telegram-id
• Language: PHP
• Homepage:
• Size: 15.6 KB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# tg-dialog-id

[![codecov](https://codecov.io/gh/danog/tg-dialog-id/branch/master/graph/badge.svg)](https://codecov.io/gh/danog/tg-dialog-id)

[![Psalm coverage](https://shepherd.dev/github/danog/tg-dialog-id/coverage.svg)](https://shepherd.dev/github/danog/tg-dialog-id)

[![Psalm level 1](https://shepherd.dev/github/danog/tg-dialog-id/level.svg)](https://shepherd.dev/github/danog/tg-dialog-id)

[![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Fdanog%2Ftg-dialog-id%2Fmaster)](https://dashboard.stryker-mutator.io/reports/github.com/danog/tg-dialog-id/master)

![License](https://img.shields.io/github/license/danog/tg-dialog-id)

A library to work with Telegram bot API dialog IDs.  

Created by Daniil Gentili (https://daniil.it).  

This library was initially created for [MadelineProto](https://docs.madelineproto.xyz), an async PHP client API for the telegram MTProto protocol.  

## Installation

```bash

composer require danog/tg-dialog-id

```

## Usage

```php

 bot API dialog ID

expect(DialogId::fromSupergroupOrChannelId(1234567890) === -1001234567890);

// Converts an MTProto chat ID => bot API dialog ID

expect(DialogId::fromChatId(123456789) === -123456789);

// Converts an MTProto user ID => bot API dialog ID

expect(DialogId::fromUserId(123456789) === 123456789);

// Converts an MTProto secret chat ID => bot API dialog ID

expect(DialogId::fromSecretChatId(123456789) === -1999876543211);

// Converts a bot API dialog ID => MTProto supergroup/channel ID

expect(DialogId::toSupergroupOrChannelId(-1001234567890) === 1234567890);

// Converts a bot API dialog ID => MTProto chat ID

expect(DialogId::toChatId(-123456789) === 123456789);

// Converts a bot API dialog ID => MTProto user ID

expect(DialogId::toUserId(123456789) === 123456789);

// Converts a bot API dialog ID => MTProto secret chat ID

expect(DialogId::toSecretChatId(-1999876543211) === 123456789);

expect(DialogId::getType(101374607) === DialogId::USER);

expect(DialogId::getType(-123456789) === DialogId::CHAT);

expect(DialogId::getType(-1001234567890) === DialogId::CHANNEL_OR_SUPERGROUP);

expect(DialogId::getType(-1999898625393) === DialogId::SECRET_CHAT);

expect(DialogId::isUser(1099511627775) === true);

expect(DialogId::isChat(-999_999_999_999) === true);

expect(DialogId::isSupergroupOrChannel(-1997852516352) === true);

expect(DialogId::isSecretChat(-2002147483648) === true);

expect(DialogId::isUser(101374607) === true);

expect(DialogId::isChat(-101374607) === true);

expect(DialogId::isSupergroupOrChannel(-1001234567890) === true);

expect(DialogId::isSecretChat(-1999898625393) === true);

// Converts a bot API dialog ID => MTProto ID automatically depending on type

expect(DialogId::toMTProtoId(-1001234567890) === 1234567890);

expect(DialogId::toMTProtoId(-123456789) === 123456789);

expect(DialogId::toMTProtoId(123456789) === 123456789);

expect(DialogId::toMTProtoId(-1999876543211) === 123456789);

echo "OK!".PHP_EOL;

```

## API Documentation

Click [here »](https://github.com/danog/tg-dialog-id/blob/master/docs/index.md) to view the API documentation.