DokumentationWorkflowsApps og tjenester
Telegram node
Sender tekstbeskeder via din Telegram-bot og besvarer klik på inline-knapper, i private chats, grupper, kanaler og forumemner. Se opsætning, input og output, testforløb og løsning af typiske fejl.
9 min. læsningOpdateret
Hvad noden gør
Sender tekstbeskeder via din Telegram-bot og besvarer klik på inline-knapper, i private chats, grupper, kanaler og forumemner.
Brug Telegram som et klart afgrænset trin i et anymize-workflow.
- Behandler 1 input.
- Leverer 1 output til efterfølgende trin.
- Kører som et normalt trin i forløbet.
Opsæt noden
- 01Åbn et workflow, og tilføj Telegram fra nodekataloget.
- 02Udfyld de påkrævede felter, og knyt værdier fra tidligere trin.
- 03Kør noden med et lille testsæt, og kontrollér outputtet.
- 04Forbind det vellykkede output, og aktivér først efter en samlet test.
Handlinger og tilstande
Vælg den ønskede funktion i Operation. Panelet viser derefter de relevante indstillinger.
- Send besked
- Besvar knaptryk
Indstillinger
| Felt | Betydning | Område |
|---|---|---|
| Telegram-bot | Vælg bot-tokenet i workflow-hemmeligheder. Tokenet forbliver krypteret og gemmes aldrig i workflowet. | Beskyttet |
| Operation | Send en besked, eller bekræft et klik på en inline-knap. | Standard |
| Chat-id eller @kanal | Destinationschat. Brug @kanalnavn til kanaler; private chats og grupper bruger deres numeriske id. | Standard |
| Besked | Beskedtekst. Telegram tillader op til 4096 tegn efter parsing. | Standard |
| Formatering | Valgfrit Telegram-format. MarkdownV2-specialtegn skal escapes efter Telegrams regler. | Standard |
| Forumemne-id | Valgfrit. Sender beskeden til et bestemt forumemne i en supergruppe. | Standard |
| Svar på besked-id | Valgfrit komfortfelt, der flettes ind i reply_parameters.message_id. | Standard |
| Send lydløst | Sender uden notifikationslyd. Beskeden forbliver synlig. | Standard |
| Forhindr videresendelse og lagring | Beskytter indholdet mod videresendelse og lokal lagring, hvor Telegram understøtter det. | Standard |
| Linkvisning | Valgfrit LinkPreviewOptions-objekt med JSON-autocomplete fra tidligere noder. | Standard |
| Svarparametre | Valgfrit ReplyParameters-objekt, som flettes sikkert med besked-id-feltet. | Standard |
| Knapper eller eget tastatur | Valgfrit JSON-objekt: InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove eller ForceReply. | Standard |
| Callback-query-id | Påkrævet. Brug callback_query.id fra Telegram-triggeren. Telegram viser en indlæsningsindikator på knappen, indtil den bekræftes. | Standard |
| Beskedtekst | Valgfri besked på 0 til 200 tegn. Uden tekst stoppes kun indlæsningsindikatoren. | Standard |
| Vis som advarsel | Viser beskeden som en dialog i stedet for en kort notifikation øverst på skærmen. | Standard |
| Callback-URL | Valgfrit. Åbner en HTTPS-URL i Telegram; spil-URL'er virker kun med callback_game-knapper. | Standard |
| Cachetid (sekunder) | Valgfrit. Hvor længe Telegram-klienter må cache resultatet. Standardværdien er 0. | Standard |
| Kør én gang pr. element | Fra (standard): noden kører én gang for hele inputtet. Til: får den flere elementer (f.eks. fra „Del liste op“), kører den én gang PR. element, og {{ $json }} er så præcis dette element. Sådan arbejder du en filliste igennem post for post. | Standard |
| Hvis et element fejler | „Spring over“ skriver et `error`-felt for det fejlede element og fortsætter med resten i stedet for at miste hele kørslen på én ulæselig fil. | Standard |
| Pause mellem elementer (millisekunder) | Ventetid før hver kørsel undtagen den første. 1000 = 1 sekund pr. element. Nyttigt, hvis modparten ellers begrænser dig. Maksimalt 300000 (5 minutter). | Standard |
Input og output
| Input | Betydning | Type |
|---|---|---|
| Chat-id | Indstil værdien i nodepanelet. | text |
| Besked | Indstil værdien i nodepanelet. | text |
| Emne-id | Indstil værdien i nodepanelet. | number |
| Svar på | Indstil værdien i nodepanelet. | number |
| Knapper | Indstil værdien i nodepanelet. | json |
| Callback-query-id | Indstil værdien i nodepanelet. | text |
| Callback-besked | Indstil værdien i nodepanelet. | text |
| Vis som advarsel | Indstil værdien i nodepanelet. | boolean |
| Callback-URL | Indstil værdien i nodepanelet. | text |
| Cachetid | Indstil værdien i nodepanelet. | number |
| Output | Betydning | Type |
|---|---|---|
| Sendt | Indstil værdien i nodepanelet. | boolean |
| Besked-id | Indstil værdien i nodepanelet. | number |
| Chat-id | Indstil værdien i nodepanelet. | text |
| Sendt kl. | Indstil værdien i nodepanelet. | number |
| Telegram-besked | Hele Message-svaret fra Telegram Bot API. | json |
| Callback besvaret | Sand, når Telegram har accepteret svaret på knaptrykket. | boolean |
| Besvaret callback-query-id | Indstil værdien i nodepanelet. | text |
Noden kan behandle lister element for element. Fejlhåndtering og pause findes under avancerede indstillinger.
Eksempel og testkørsel
Send status med en inline-knap: start med et lille og genkendeligt datasæt. Kontrollér outputtet, og brug kun felter, der faktisk findes.
Eksempel på testkørsel
{
"chat_id": "-1001234567890",
"text": "<b>Deployment abgeschlossen</b>\nVersion 2.4.0 ist live.",
"parse_mode": "HTML",
"reply_markup": {
"inline_keyboard": [
[
{
"text": "Dashboard öffnen",
"url": "https://example.com/status"
}
]
]
}
}Adgang og sikkerhed
Gennemgå hvilke data der kommer ind i trinnet, og hvad outputtet indeholder.
Gem nøgler og loginoplysninger i den beskyttede forbindelsesstyring. Indsæt dem aldrig i almindelige felter, testdata eller beskrivelser.
Løs typiske fejl
- Intet output: kontrollér den seneste kørsel og felterne fra den forrige node.
- Tom variabel: åbn outputtet fra det forrige trin, og brug et felt fra de faktiske testdata.
- Listen behandles kun én gang: aktivér kørsel pr. element.