Send WeatherX alerts to Telegram

This one is a single click, and your email carries two of them: one for a private chat and one for a team group. A private chat sends the alerts to you alone. A group sends them to everyone in it. You never handle a token and you never meet BotFather.

Which link to press

Both links are in the same Telegram row of your WeatherX email, and both do the whole job in one press. They are not the same, so pick the one you mean:

• Connect Telegram opens a private chat with our alert account. The alerts go to you alone. Nobody else sees them.

• Add Telegram to a group opens Telegram's group picker. The alerts go to everyone in it, and everyone in it can see them.

Each link carries its own ticket, so both work: connect a private chat, and a group as well, from the same email. Each one is single use, so press each of them once.

The steps

1. In the WeatherX email, press Connect Telegram for a private chat, or Add Telegram to a group for your team. Do it on the device where Telegram is installed.

2. Telegram opens: on the alert account for a private chat, or on the group picker, where you choose the group.

3. Press Start. In a group, Telegram sends that for you as soon as you confirm the group.

4. The alert account writes one line in that chat to say it is connected. That line is the confirmation.

Do not add the alert account through Telegram's own member menu. Added that way it arrives with no ticket, so nothing is connected and the group stays silent. Use the group link in your email.

The alert account only writes. It does not answer questions and it does not read your conversation.

If you closed the window

Nothing was connected, and nothing was spent. The link works once and lasts seven days, so if the connection never finished at Telegram's end, press the button in your email again.

If the link is older than seven days, or you already used it, it will say the link is not found. Write to support@weatherx.earth and ask for a new link — we send one in a minute.

What arrives, and when

We look at your place every ten minutes. You get one message when weather is coming or has started, and one when it has passed. A quiet week is a quiet channel — nothing arrives to say that nothing is happening.

The first line is the decision: STOP means it is at the place now or within twenty minutes, PREPARE means it is coming, ALL CLEAR means it has passed.

The last line of every message points back at this page. It is a link to a manual and not a switch: opening it changes nothing, so an alert that is forwarded, quoted or read by a spam filter carries nothing anybody can act on.

What changes on our side

• The place named in your email gets one destination: the Telegram chat or group you picked.
• Alerts for that place go there from the next ten-minute cycle. Nothing else about your account moves.
• Your API key is not touched. It never travels in any of these links.
• You can have more than one destination on a place. Add another and both receive every alert.

How to stop it

Remove the alert account from the group, or block it in a private chat. Then take the destination off our side too. The Stop link in the next section does that and everything else for the place; to take off only this one and leave the rest running, ask us.

How to stop everything, without asking anybody

Your WeatherX email carries a Stop link at the bottom. Open it, and press the button on the page it shows. It stops every alert for that place and turns off every destination on it, at any hour. It needs no key and no reply.

Write to support@weatherx.earth, and ask us to take one destination off and leave the rest running.

Everything here needs your API key

Send it as an X-API-Key header. It is the key from your welcome message, and it never travels in a connect link — the two are separate on purpose.

Send yourself a real alert, now

You do not have to wait for weather. One call sends a real alert through the real senders:

POST /portal/sites/<place id>/test
X-API-Key: wx_live_…

It arrives as light rain half an hour away, and it says on its face that it is a test — in the first line of the message — so nobody can mistake it for weather. One a minute, twenty a day.

Take one destination off, and leave the rest

The Stop link above turns off everything at once. This takes off one and leaves the place watched. Ask for the list, then delete the one you mean:

GET /portal/sites/<place id>/channels
DELETE /portal/channels/<id>
X-API-Key: wx_live_…

Everything else on that place carries on receiving.

Ask for a fresh connect link

If the Telegram link has been used, or is older than seven days, or the message it came in was deleted, mint another:

POST /portal/sites/<place id>/connect/telegram
X-API-Key: wx_live_…

{"kind": "telegram", "url": "https://…", "expires_at": "…"}

Open the url in a browser and it behaves exactly like the button in your message — the key stays in the header and never travels in the link. Asking again for the same place and the same destination replaces the live link rather than adding a second one, so the newest one you were given is the one that works.

This is the one destination that answers with two links. url opens a private chat and group_url opens the group picker; they carry different tickets, so both work and you can have both at once. Asking again replaces the pair.

The message as fields, not sentences

This destination receives the alert written out as sentences, because a person reads it. A program usually wants the numbers instead — how far away, which direction, how far ahead the forecast was. That is a second destination kind, and it has its own page: alerts to your own server. A place can carry both at once.