Telegram koppelen: stapsgewijze handleiding
Verstuurt meldingen bij mislukte tests (één per test met NEXUS_TELEGRAM_NOTIFY=true) en de rapporten en bestanden die je wilt delen, via je eigen bot. Er is geen gedeelde bot. Deze handleiding begeleidt je vanaf het begin tot een gecontroleerde verbinding en beschrijft de fouten die je kunt tegenkomen, met hun oorzaak en oplossing.
Laatst bijgewerkt:
Houd je toegangsgegevens privé. Plak nooit een token, sleutel, wachtwoord of webhook-URL in een chat. Voer deze alleen in via Studio → Instellingen → Integraties, waar ze worden opgeslagen in het .env-bestand van je werkruimte en als stippen worden weergegeven. Hetzelfde geldt voor een AI-assistent: die kan je door deze handleiding leiden, maar heeft je token nooit nodig.
Wat je nodig hebt
- Een Telegram-account.
- Een eigen bot, eenmalig aangemaakt met @BotFather, en het bijbehorende token.
- Een telefoon of Telegram-app om de QR-code voor het koppelen te scannen.
- Voordat je dit inschakelt: Telegram kan bestanden ontvangen, zoals rapporten en pdf's, en deze komen op de servers van Telegram terecht. Overleg in een gereguleerde omgeving eerst met je complianceteam.
De toegangsgegevens verkrijgen
- Open in Telegram https://t.me/BotFather en verstuur /newbot. Geef de bot een naam en een gebruikersnaam.
- BotFather antwoordt met het bottoken (bijvoorbeeld 123456:ABC…). Kopieer dit.
- Bewaar het op je klembord. Plak het nergens anders dan in de Studio (volgende stap).
Koppelen in de Studio
- Open in de Studio Instellingen → Integraties → Telegram koppelen.
- Plak het bottoken en sla het op. De QR-code voor het koppelen verschijnt.
- Scan de QR-code met je telefoon en tik op Start in Telegram. Binnen enkele seconden toont de Studio "meldingen gaan naar chat …" en zegt de bot "Verbonden met Nexus StudioQA."
- Schakel
TELEGRAM_ENABLEDin. Schakel voor één melding per mislukte test ookNEXUS_TELEGRAM_NOTIFYin.
Controleren of het werkt
- Na het scannen stuurt de bot "Verbonden met Nexus StudioQA. Mislukte tests worden hier gemeld." naar je chat.
- De Studio toont "meldingen gaan naar chat" met de chatgegevens afgeschermd.
Veelvoorkomende fouten
| Wat je ziet | Oorzaak | Oplossing |
|---|---|---|
| "Telegram is uitgeschakeld" | TELEGRAM_ENABLED is false en moet ingeschakeld zijn om te kunnen koppelen. | Schakel TELEGRAM_ENABLED in en druk opnieuw op Telegram koppelen. |
| "Geen bottoken" | TELEGRAM_TOKEN is leeg. | Plak het token van BotFather in Instellingen → Integraties en sla het op. |
| "Telegram: Niet geautoriseerd" (of "Niet gevonden") | Het bottoken is onjuist, is ingetrokken in BotFather of is onvolledig gekopieerd. | Stuur /token naar BotFather om het token opnieuw op te halen (of maak een nieuwe bot), en sla het op. |
| "De QR-code was verlopen voordat deze werd gescand" | De QR-code is maar een paar minuten geldig. | Druk op Telegram verbinden om een nieuwe aan te maken en scan deze meteen. |
| De QR-code is gescand maar de Studio wacht nog steeds | Door het scannen werd de chat geopend, maar er is niet op Start getikt, of het Studio-venster is gesloten. | Tik op Start in de chat met de bot. Als de Studio nog steeds wacht, maak dan een nieuwe QR-code. |
| "kon Telegram niet bereiken (ENOTFOUND)" of "antwoordde niet binnen 20 s" | Deze pc kan api.telegram.org niet bereiken: door een VPN, firewall of proxy, of doordat er geen netwerkverbinding is. | Controleer het netwerk vanaf dezelfde pc en probeer het opnieuw. |
| Er komt geen melding na een fout | TELEGRAM_ENABLED is false, er is geen chat gekoppeld of meldingen per test staan uit (NEXUS_TELEGRAM_NOTIFY). | Koppel een chat en zet beide schakelaars aan. |
Instellingssleutels
| Sleutel | Wat het doet | Geldige waarde | Zo controleert u dit |
|---|---|---|---|
TELEGRAM_ENABLED | Meldingen naar Telegram sturen | true of false | Dit moet aanstaan voor de QR-code voor koppeling. |
TELEGRAM_TOKEN | Toegangscode voor de Telegram-bot (geheim, alleen op deze computer opgeslagen) | Het bottoken van BotFather, zoals 123456:ABC…, op één regel | De QR-code verschijnt alleen als Telegram het token accepteert. |
TELEGRAM_CHAT_ID | Telegram-chat voor meldingen | Wordt ingevuld via de QR-koppeling; typ dit niet zelf | De Studio toont "meldingen gaan naar chat …". |
NEXUS_TELEGRAM_NOTIFY | Telegram-melding per fout | true of false | Er komt één melding per mislukte test. |
Meer: alle integraties, de handleiding voor instellingen, problemen oplossen. Andere handleidingen: Jira Cloud, Azure Boards, Slack, Microsoft Teams, GitHub Issues.
Kom je er nog steeds niet uit? Mail naar [email protected] met de exacte foutregel die Studio toont. Stuur geen token mee.