Send news alerts to Slack, Telegram or Discord

The fastest way to make a news API useful to a team is to route it straight into chat. Here's how to pipe filtered, de-duplicated breaking-news alerts into Slack, Telegram or Discord in a few lines — no polling loop.

1. Subscribe to what matters

Register a webhook filtered to your beat, so you only get high-urgency items for your countries and topics. Matching articles POST to your endpoint within ~60 seconds of ingestion, HMAC-signed:

POST /v1/webhook?url=https://your.app/hook&min_score=7&country=ua&topic=defense

Each payload already carries urgency, political_lean, country_tags, topic_tags and a cluster_id — nothing to enrich on your side.

2. Forward to chat

Your endpoint just reshapes the payload into the chat platform's incoming-webhook format:

# Slack / Discord incoming webhook
POST https://hooks.slack.com/services/XXX
{ "text": "🚨 [9] Ukraine · defense — " }

# Telegram bot
POST https://api.telegram.org/bot<TOKEN>/sendMessage
{ "chat_id": "-100...", "text": "🚨 [9] " }

Map urgency to an emoji or channel (route 9–10 to a louder channel), and you've got a triaged newsroom feed.

3. Alert once per event, not forty times

One story becomes many headlines. Track incoming cluster_ids and skip ones you've already posted, so the channel gets one message per event with cluster_size as a "how big" hint. Background in the event-clustering guide.

Prefer a stream or a pull?

If you can't expose a public endpoint, hold an SSE connection open instead, or poll /v1/breaking on a timer — same data, your choice of transport. Trade-offs in the real-time delivery guide. Full parameters in the API docs.