Sign inSign up

mmuzaf/sms-rest-forwarder

By mmuzaf

Updated 5 months ago

Lightweight Go service that receives SMS, forwards them to Telegram, and shows at HTML inbox.

Image
Developer tools
Web servers
0

1.1K

mmuzaf/sms-rest-forwarder repository overview

sms-rest-forwarder

A lightweight Go service that accepts incoming SMS messages over HTTP, forwards them to a Telegram bot, and exposes a simple HTML inbox.

Features

  • POST /sms — receive SMS messages as JSON
  • GET /healthcheck — service health status
  • GET / — HTML inbox, messages sorted newest first
  • Forwards each message to a Telegram chat
  • Persists all messages locally in a JSON file
  • HTML template embedded in the binary — no external assets at runtime
  • Runs in Docker with a named volume for persistent storage

Endpoints

POST /sms

Accepts an SMS message as a JSON object.

POST /sms
Content-Type: application/json
Request body
FieldTypeRequiredDescription
fromstringYesOriginating phone number (e.g. "+1234567890")
bodystringYesText content of the SMS
received_atstringNoISO 8601 timestamp of when the SMS was received. Defaults to the current server time if omitted.
Example
{
  "from": "+1234567890",
  "body": "Your verification code is 4521",
  "received_at": "2024-01-15T10:30:00Z"
}

Tag summary

Content type

Image

Digest

sha256:c4c836845

Size

7.3 MB

Last updated

5 months ago

docker pull mmuzaf/sms-rest-forwarder