Facebook Integration

The Facebook gateway utilizes an isolated **Dual-Path Strategy** to publish to both Feeds and Stories reliably without transient API failures.

Required Request Headers

• x-fb-id: The destination Facebook Page ID.
• x-fb-token: Page Access Token with pages_manage_posts and pages_read_engagement permissions.

JSON Payload Parameters

cURL Example

curl -X POST https://usmm.global-desk.top/v1/fb/post \
  -H "x-fb-id: 1048574904996709" \
  -H "x-fb-token: EAAZ..." \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "New seismic alert issued in the Philippines.",
    "media": [{ "source": "https://example.com/map.jpg", "type": "image/jpeg" }],
    "options": { "publishToFeed": true, "publishToStory": true }
  }'

X (Twitter) Integration

Publish tweets directly using X API v2. If the caption exceeds 280 characters, it will automatically be split into a tweet thread.

Required Request Headers

• x-x-token: A stringified JSON configuration of your OAuth v2 credentials:

{
  "consumerKey": "YOUR_CONSUMER_KEY",
  "consumerSecret": "YOUR_CONSUMER_SECRET",
  "accessToken": "YOUR_ACCESS_TOKEN",
  "accessSecret": "YOUR_ACCESS_SECRET"
}

JSON Payload Parameters

cURL Example

curl -X POST https://usmm.global-desk.top/v1/x/post \
  -H 'x-x-token: {"consumerKey":"...","consumerSecret":"...","accessToken":"...","accessSecret":"..."}' \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Earthquake swarm detected. Thread 1/2.",
    "media": [{ "source": "https://example.com/graph.jpg", "type": "image/jpeg" }]
  }'

Slack Formatting Integration

The Slack gateway converts standard custom HTML blocks into Slack's rich **Block Kit** layout automatically.

Required Request Headers

• x-slack-token: The Incoming Webhook URL of your Slack channel workspace.

Supported HTML Tag Conversions

cURL Example

curl -X POST https://usmm.global-desk.top/v1/slack/post \
  -H "x-slack-token: https://hooks.slack.com/services/..." \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "
🚨 Alert
Earthquake detected
",
    "priority": 5
  }'

API Reference

Use the unified gateway parameters to routing requests dynamically to all platforms at once using POST /v1/post.

Unified Payload Fields