SMS Gateway

Interact with a local sms-gate.app instance to send and receive SMS through an Android device.

Setup

Requires environment variables:

• - SMS_GATE_URL — Your gateway URL (e.g., http://192.168.50.69:8080)
• INLINECODE2 — HTTP Basic Auth username
• INLINECODE3 — HTTP Basic Auth password

Quick Start

Send an SMS:
CODEBLOCK0

Check delivery status:
CODEBLOCK1

List recent messages:
CODEBLOCK2

Operations

Sending SMS

Use scripts/send_sms.py:
CODEBLOCK3

Phone numbers can include + prefix (will be normalized). Delivery report is true by default.

Checking Status

Use scripts/check_status.py with the message ID returned from send:
CODEBLOCK4

States: Pending → Sent → Delivered (or Failed)

Listing Messages

Use scripts/list_messages.py:
CODEBLOCK5

Shows both sent (📤) and received (📥) messages with their current state.

Managing Webhooks

Use scripts/manage_webhooks.py:

CODEBLOCK6

API Reference

See references/api.md for complete endpoint documentation.

Common Patterns

Send with status check:
CODEBLOCK7

Health check:
CODEBLOCK8

Receiving SMS (Incoming)

The sms-gate.app API doesn't store message content - it only delivers via webhooks. To receive incoming SMS:

Option 1: Webhook Server + ngrok (Recommended)

1. Start the webhook receiver:
CODEBLOCK9

2. Expose via ngrok:
CODEBLOCK10

3. Configure webhook:
CODEBLOCK11

Now incoming SMS will be printed to the webhook server console.

Option 2: Local Network (Same WiFi)

If Pixel 3 and Mac are on same network:
CODEBLOCK12

Notes

• - The Android device must have SMS capability and be on the same network (or accessible via tunnel like Cloudflare)
• Webhooks require HTTPS for remote access (ngrok provides this)
• Message content is only available via webhooks, not stored in /messages API
• Message IDs are URL-safe strings returned after sending