Guide: Incoming Webhooks for Telegram

Demo

Getting Started

  1. Sign in and create an incoming webhook. You'll receive a Webhook ID and API Token. Save the API Token securely — it's only shown once.
  2. Open Telegram and start a chat with @BobOpsBot, or invite it to your group chat.
  3. In your Telegram chat, send: /connect YOUR_EMAIL WEBHOOK_ID
  4. You're all set! Check out the API Reference below to start sending notifications.

API Reference

POSThttps://bobops.net/api/incoming_webhook

Quick Example

curl --request POST \ 
--url https://bobops.net/api/incoming_webhook \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{"text": "*Status all green! 🟢*"}'

Request

Headers
KeyValueDescription
AuthorizationBearer YOUR_API_TOKENProvide the API token that is generated when you create the WebhookRequired
Content-Typeapplication/jsonOnly application/json is currently supportedRequired
Body (JSON String)
KeyTypeDescription
textstringMessage content using Telegram MarkdownV2 formatRequired

Response

Status Codes
Status codeDescription
200Message sent successfully
400Invalid JSON or missing "text" field
401Invalid or missing Authorization header
404Webhook not found, not connected, or bot lacks permissions