{"id":13504846,"url":"https://github.com/lloople/bot-mr-dear","last_synced_at":"2025-05-12T17:15:37.657Z","repository":{"id":47993181,"uuid":"147031350","full_name":"Lloople/bot-mr-dear","owner":"Lloople","description":"Interact with your Oh Dear! sites chatting with this bot. ","archived":false,"fork":false,"pushed_at":"2022-12-10T20:35:31.000Z","size":1906,"stargazers_count":19,"open_issues_count":16,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-05-12T17:15:30.700Z","etag":null,"topics":["bot","botman","chatbot","laravel","oh-dear","php","telegram-bot"],"latest_commit_sha":null,"homepage":"https://ohdear.app","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Lloople.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-01T20:40:54.000Z","updated_at":"2022-10-30T12:55:43.000Z","dependencies_parsed_at":"2023-01-26T10:01:04.899Z","dependency_job_id":null,"html_url":"https://github.com/Lloople/bot-mr-dear","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lloople%2Fbot-mr-dear","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lloople%2Fbot-mr-dear/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lloople%2Fbot-mr-dear/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lloople%2Fbot-mr-dear/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lloople","download_url":"https://codeload.github.com/Lloople/bot-mr-dear/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253785011,"owners_count":21963903,"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","botman","chatbot","laravel","oh-dear","php","telegram-bot"],"created_at":"2024-08-01T00:00:52.262Z","updated_at":"2025-05-12T17:15:37.631Z","avatar_url":"https://github.com/Lloople.png","language":"PHP","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"\u003cp align=\"center\"\u003e\u003cimg height=\"188\" width=\"198\" src=\"https://raw.githubusercontent.com/Lloople/bot-mr-dear/master/public/img/ohdear_avatar.png\"\u003e\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eMr. Dear\u003c/h1\u003e\n\nI'm here to help you manage your sites on [Oh Dear! App](https://ohdear.app) by chat. Also I can text you if something is going wrong (Let's hope it'll be no need to 😉)\n\n## Interacting with the bot\n\n### Commands\n\n- `/sites` - I'll show you a list with your current sites and their most recent status result.\n- `/newsite {url}` - We will begin a delightful conversation in order to add a new site to your collection.\n- `/deletesite {url or id}` - I get it, you don't want to see that site anymore, but first we will confirm you really want to do this.\n- `/site {url or id}` - I'll be glad to show you all the information regarding to a specific site.\n- `/downtime {url or id}` - Let's see how many times your site was down for the last month.\n- `/uptime {url or id}` - I'll tell you the percentage your site was up on the last month.\n- `/brokenlinks {url or id}` - Check out your website's broken links in a second.\n- `/mixedcontent {url or id}` - Check out your website's mixed content.\n\n### Action Buttons\n\nSince the moment you ask me about your sites (`/sites`) I'll show you the name of your sites along with\nan indicator to see quickly if it's online (✅ or 🔴) in form of a button. You can click it to see more \ninformation about your site and another group of buttons to check other common actions like Broken Links,\nDowntime, etc... \n\n### Webhooks\n\nDuring the `/start` process, the bot will ask you for your API token in order to interact with your sites, but also\nyour `webhook signing secret`. This information can be found at the end of the [Notifications page](https://ohdear.app/team-settings/notifications).\n\nWith this key configured, the bot can warn you if there's any problem with your site. Currently notifications supported are:\n- Uptime Check Failed\n- Broken Links Found\n\n## Installation\n\nThis bot is currently functional at [MrDear_bot](http://t.me/MrDear_bot) on Telegram, so you don't have to do anything to\nget up and running.\n\nHowever, there's a chance you want to host it yourself. If that's your case, just follow the few steps described below.\n\n```\ncomposer install\nphp artisan migrate\ncp .env.example .env\n```\n### Registering the bot\n\nAfter that, you will need to [create your own Telegram Bot](https://core.telegram.org/bots#3-how-do-i-create-a-bot).\n\nOnce you have obtained the access token, place it in your `.env` file like `TELEGRAM_TOKEN=token`.\n\nTelegram needs to send the incoming messages to your bot. In order to configure that, you can use the following command\n\n```\nphp artisan botman:telegram:register\n```\n\nThe default url will be `yourdomain.com/botman`. It must be `HTTPS`\n\n\u003e If you're developing in a local environment, take in mind using [Laravel Valet](https://laravel.com/docs/5.7/valet) feature `valet share`. It uses ngrok\n\u003e under the hood to make your project accessible from the outside. \n\nThat's it. You can now talk to your bot through Telegram.\n\n### Troubleshooting\n\nIf your is not running as you've expected you have a few tools to help you see what's going on:\n\n- If you're using `valet share` for local development you already have a custom dashboard to check incoming requests at http://127.0.0.1:4040 by ngrok.\n- To see the full error, check the `storage/logs/laravel.log` file. Take in mind that Telegram re-sends a failed request up to 4 more times.\n- To debug the application, you can use [Beyond Code](https://github.com/beyondcode) package called `laravel-dump-server`. It's already installed\nin this project, you just need to run `php artisan dump-server` and put some `dump($var)` in your code to see it in the terminal.\n## Security Vulnerabilities\n\nIf you discover a security vulnerability within this bot, please send an e-mail to David Llop at d.lloople@icloud.com. All security vulnerabilities will be promptly addressed.\n\n## License\n\nMr. Dear is free software distributed under the terms of the MIT license.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flloople%2Fbot-mr-dear","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flloople%2Fbot-mr-dear","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flloople%2Fbot-mr-dear/lists"}