wmeKit HVR

Setup guide

From the first email to a report in your Discord, Slack or Telegram. About ten minutes.

1. Create a feed

Sign in and open Feeds. Create one per High Volume query you receive, e.g. “South Africa”. Each feed gets its own address, such as in+south-africa-k3m9x2qp@hvr.wmekit.com. Treat it like a password: anyone who knows it can send mail to the feed. You can change it later under Settings.

2. Forward the reports from Gmail

The reports come from Waze’s High Volume Alerts team. In the Gmail account that receives them:

  1. Settings → Forwarding and POP/IMAP → Add a forwarding address, and enter the feed’s address.
  2. Gmail sends a confirmation email to that address. It shows up in the feed (on its page and in the Inbox tab) with the confirmation code and link. Click the link, or enter the code in Gmail.
  3. Create a filter: Subject "High Volumes report" (check the sender of one of your reports and add it under From to be precise), then choose Forward it to the feed’s address. Don’t forward everything, only these reports.

Prefer to forward by hand? Use Gmail’s Forward button on a report email. Reports are read from the email’s HTML table or from a PDF attachment, so forwarded copies and PDFs both work. A PDF can cut off the right-hand columns (lane guidance, hazards, restrictions, events, tolls); those are only available when the HTML email is forwarded.

Once reports arrive, you can lock the feed down under Settings → Allowed senders (e.g. your Gmail address) so mail from anyone else is refused.

3. Add channels

In the feed’s Channels tab, add where reports should go. Each channel can filter which editors it lists.

  • Discord: Server Settings → Integrations → Webhooks → New Webhook, pick the channel, then Copy Webhook URL. For a forum channel or a thread, also enter the thread ID.
  • Slack: create an app at api.slack.com/apps, turn on Incoming Webhooks, add one for your channel, and copy its URL.
  • Telegram: create a bot with @BotFather and copy its token, then add the bot to your group or channel (as an admin for channels). The chat ID is the channel’s @username, or a number like -1001234567890 for private groups (forward a message from the group to @userinfobot to see it). For a forum topic, also enter the topic ID.

Use Send test to post the latest report (or a sample) right away.

4. Day to day

  • Reports lists every day received; open one to see the full table and where it was posted, or to send it again.
  • Editors totals up any date range and shows each editor’s history.
  • Inbox shows every email the feed received, including ones that weren’t reports, with the reason. Owners can import a report PDF or a saved .eml file there to backfill older reports.
  • Settings: add members (viewers see reports; owners also manage channels and settings), pause automatic posting, or change the address.