devsurajit-codes / ZsecMail

Telegram Bot for Disposable Email Service using Cloudflare Workers

1. Token and Configuration:

   • telegramAuthToken: This is the authentication token required to communicate with the Telegram Bot API.
   • webhookEndpoint: This is the endpoint where Telegram will send updates.
   • oneSecMailApiUrl: This is the API endpoint to generate a random temporary email address.

2. Event Listener and Handler:

   • addEventListener('fetch', event => {...}): This adds an event listener for the 'fetch' event. This is a Cloudflare Worker specific API. When an HTTP request is made, this event listener will trigger the provided handler function.
   • async function handleIncomingRequest(event) {...}: This is the handler function that will process incoming HTTP requests.

3. Request Handling:

   • The handler function extracts information from the incoming request such as the URL, method, and path.
   • It checks if the request method is POST and the path matches the webhook endpoint. If so, it processes the incoming Telegram update.
   • If the request method is GET and the path is '/configure-webhook', it sets up the webhook with Telegram API by sending a request to https://api.telegram.org/bot{token}/setWebhook.
   • Otherwise, it returns a 404 Not Found response.

4. Processing Telegram Updates:

   • async function processUpdate(update) {...}: This function processes the Telegram update received from the webhook.
   • It checks if the update contains a message.
   • If the message is '/start', it sends a welcome message to the user.
   • If the message is '/generate_email', it generates a temporary email address using the oneSecMailApiUrl and sends it to the user.
   • If the message is '/fetchmail', it fetches emails for the previously generated temporary email address and sends them to the user.
   • If the message is '/info', it sends developer information to the user.

5. Sending Requests to Telegram API:

   • The function uses fetch() to send requests to the Telegram API for various actions such as sending messages, setting webhooks, etc.

6. Error Handling:

   • The code includes error handling for failed API requests and invalid user input.

7. Response Handling:

   • The handler function returns appropriate HTTP responses to the client based on the request and processing results.

This code essentially sets up a Cloudflare Worker to act as a webhook for a Telegram bot. It handles incoming updates from Telegram, processes them based on predefined commands, and interacts with the Telegram API to send responses back to users.