{"id":22696739,"url":"https://github.com/muaath5/simplebotapi","last_synced_at":"2025-09-21T23:47:57.570Z","repository":{"id":47798162,"uuid":"389175721","full_name":"Muaath5/SimpleBotAPI","owner":"Muaath5","description":"Simple \u0026 Easy Telegram Bot API in PHP","archived":false,"fork":false,"pushed_at":"2024-10-19T22:40:48.000Z","size":107,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-26T21:23:12.592Z","etag":null,"topics":["bot","bot-api","php","php8","telegram","telegram-api","telegram-bot","telegram-bot-api"],"latest_commit_sha":null,"homepage":"http://simplebotapi.muaath.dev/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Muaath5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-24T18:44:26.000Z","updated_at":"2024-10-19T22:40:51.000Z","dependencies_parsed_at":"2022-08-23T13:50:52.543Z","dependency_job_id":null,"html_url":"https://github.com/Muaath5/SimpleBotAPI","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muaath5%2FSimpleBotAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muaath5%2FSimpleBotAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muaath5%2FSimpleBotAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Muaath5%2FSimpleBotAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Muaath5","download_url":"https://codeload.github.com/Muaath5/SimpleBotAPI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248665156,"owners_count":21142118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","bot-api","php","php8","telegram","telegram-api","telegram-bot","telegram-bot-api"],"created_at":"2024-12-10T05:10:05.987Z","updated_at":"2025-09-21T23:47:52.513Z","avatar_url":"https://github.com/Muaath5.png","language":"PHP","readme":"# Simple Bot API\n[![Licence: GPL v3.0](https://img.shields.io/badge/Licence-GPL%20v3.0-green)](LICENCE)\n[![Bot API Version: 5.6](https://img.shields.io/badge/Bot%20API%20Version-5.6-dodgerblue)](https://core.telegram.org/bots/api)\n[![PHP Unit Tests](https://github.com/Muaath5/SimpleBotAPI/actions/workflows/php.yml/badge.svg)](https://github.com/Muaath5/SimpleBotAPI/actions/workflows/php.yml)\n\n\nThis is a simple Telegram Bot API library in PHP.\nThis library should support all Bot API methods in any version update.\nI created this library to make creating bots more simpliler, No need to bunch of classes And objects after today!\n\n## Features\n- Always supports all Bot API methods\n- Auto handling for flood \u0026 chat ID migrating errors\n- Uses `stdClass` for updates\n- Uses OOP\n- Optional Settings for each bot can be saved in JSON\n- Based on cURL for speed\n- Downloadable via composer\n- Tested via GitHub Actions\n- Has examples of working bots\n- Telegram Errors as PHP Exceptions\n- Up to date\n- Documented\n\n## Installation\n[Installation Guide](https://muaath5.github.io/SimpleBotAPI/Installation)\n\n## Simple Usage\n### Creating bot\n```php\nuse SimpleBotAPI/TelegramBot;\nuse SimpleBotAPI/BotSettings;\n\n$Bot = new TelegramBot('bot_token');\n```\nMore documentation [here](https://muaath5.github.io/SimpleBotAPI/CreatingBot)\n\n### Using method\nIt should be in this format:\n```\n$Result = $Bot-\u003e{methodName}([\n    '{paramName}' =\u003e {value1},\n    '{paramName2}' =\u003e {value2}\n]);\n```\n\nLike this:\n```php\n$Bot-\u003eSendMessage([\n    'chat_id' =\u003e '@MuaathBots',\n    'text' =\u003e 'This post was sent by the bot..'\n]);\n\n$my_channel_info = $Bot-\u003egetChat([\n    'chat_id' =\u003e '@MuaathBots',\n]);\necho \"Your channel (@{$my_channel_info-\u003eusername}) ID: {$my_channel_info-\u003eid}\";\n```\n\n**Note:** There's NO PROBLEM if `methodName` was in upper or lower case.\n\n## Contibuting\nYou can contribute by:\n- Reporting a bug.\n- Suggesting a feature.\n- Improving code style.\n- Completing the TODO List.\n- Adding more examples to `examples/`.\n- Documenting undocumented topics in `docs/`.\n- Updating the library to the next version of Bot API (if needed).\n- Adding more tests in `test/` folder.\n\n## Contact me\n[![@Muaath_5 on Telegram](https://img.shields.io/badge/Telegram-@Muaath_5-blue)](https://t.me/Muaath_5)\n[![muaath1428@hotmail.com](https://img.shields.io/badge/Email-muaath1428@hotmail.com-orange)](mailto:muaath1428@hotmail.com)\n\n## Examples\nCurrently, There're three examples in `examples/` folder:\n- Echo Bot, Which sends same as you sent\n- Weclome Bot, Which sends Welcome \u0026 ID of user who joins the group\n- Contact Me Bot, Which is a Bot be same as you, You'll receive messages \u0026 Reply\n- FAQ Bot, Which has one message \u0026 buttons to swap between questions, And you can see answers.\n\nYou can see a full example [here](https://muaath5.github.io/SimpleBotAPI/FullExample)\n\n**All of these examples doesn't need any databases or files to storage, Only Settings file.**\n\n## TODO List\n- [x] API via HTTP response in webhooks method\n- [x] Using namespace for exceptions\n- [x] Documenting sending message with reply markup\n- [x] Add webhook authorization\n- [x] Auto-store for bot users\n- [x] Add JSON Storage can be used by bot\n- [x] Method that posts to all bot users\n- [X] Add logging\n- [ ] Add DB Storage can be used by bot\n- [ ] Document missed things\n\n## License\n[![Licence: GPL v3.0](https://img.shields.io/badge/Licence-GPL%20v3.0-green)](LICENCE)\nGPL-3.0, In LICENCE file.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuaath5%2Fsimplebotapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuaath5%2Fsimplebotapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuaath5%2Fsimplebotapi/lists"}