REMOTERADOCS
Guides

Job alerts

Turn a filtered search into a named alert and deliver new matches to Telegram chats or a signed webhook.

An alert is a saved search that runs when new jobs arrive. Each alert has its own filters, name, enabled state, and delivery destination.

Create an alert from the feed

Filter the feed until the result count and sample jobs look right. Include the country where you work if eligibility matters.

Choose Set as Telegram Alert above the search field. If you are signed out, sign in; the selected filters are kept through the sign-in flow.

Give the alert a name that explains the decision, such as Senior Rust · EU · $120k+. Review the filter summary and choose a destination.

Save it. New matching jobs now go to that destination. Open the alert from Alerts to edit, pause, or delete it.

You can also create an alert from scratch. The editor has the same structured search and filter controls as the feed.

Choose a destination

Your Telegram DM

Choose Connect Telegram, open the bot, and tap Start. Your private chat can include personal information such as your profile-match score.

The bot also supports /status, /stop, /resume, /settings, and /help. Stopping the bot pauses delivery without deleting your alert definitions.

A Telegram group or channel

Choose Add group or Add channel, then add the Remotera bot from Telegram. The person adding it must be an administrator of that chat and have a linked Remotera account.

Group and channel destinations are shared. Their messages omit personal match scores and account-specific links.

To run a public job board or private team feed under your own identity, continue with Your own jobs channel. It covers the channel setup, per-destination message builder, custom format, reusable blocks, branding boundary, testing, and shared-channel privacy.

A webhook

Choose Add webhook and enter a public HTTPS endpoint. Mark it shared if the payload will be shown to other people—for example through a Slack or Discord bridge—so personal data is stripped.

The signing secret is shown once. Save it immediately. Each JSON request uses:

X-Remotera-Timestamp: <unix-seconds>
X-Remotera-Signature: sha256=<hex-hmac>

Verify an HMAC-SHA256 of <timestamp>.<raw-body> with the secret. Reject old timestamps to prevent replay. The payload event is job.matched; test deliveries use test.

Webhook endpoints must remain publicly resolvable, answer within ten seconds, and return a 2xx status. Redirects are not followed.

Which filters carry over

Alerts support the filters that can decide whether a new job qualifies:

  • arrangement, role, seniority, employment type, and entry-level status;
  • skills and any/all matching;
  • country eligibility or worldwide-only;
  • language, industry, company size, company, and keywords;
  • minimum or maximum salary and salary-disclosed-only;
  • matching exclusions.

Sort order, hide-viewed state, and personal match threshold do not belong to an alert. They rank or hide an existing list; they do not define a new job.

Filters across categories combine with and. Values inside a category are usually alternatives. If an alert is noisy, edit one condition rather than creating a near-duplicate.

What a notification includes

The default Telegram message includes the title, company, pay, arrangement, eligibility summary, a short role summary, the filters that matched, and links to view or apply. A personal destination can also show profile match.

Open a destination's Settings page to see which alerts feed it, send a test, and customize its message template. The preview uses sample data so you can inspect the actual layout before saving.

Pause safely

  • Disable one alert to stop only that search.
  • Pause a destination to stop everything routed there.
  • Disconnect Telegram to stop DM delivery while keeping alert definitions.
  • Removing a destination disables alerts that used it; it does not silently reroute them somewhere else.

If messages stop, check the destination status first, then confirm that the alert is enabled and its filters still match current jobs.

See Filters for search behavior and Privacy and data for the difference between personal and shared destinations.

On this page