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

  1. 01Åbn et workflow, og tilføj Telegram fra nodekataloget.
  2. 02Udfyld de påkrævede felter, og knyt værdier fra tidligere trin.
  3. 03Kør noden med et lille testsæt, og kontrollér outputtet.
  4. 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

FeltBetydningOmråde
Telegram-botVælg bot-tokenet i workflow-hemmeligheder. Tokenet forbliver krypteret og gemmes aldrig i workflowet.Beskyttet
OperationSend en besked, eller bekræft et klik på en inline-knap.Standard
Chat-id eller @kanalDestinationschat. Brug @kanalnavn til kanaler; private chats og grupper bruger deres numeriske id.Standard
BeskedBeskedtekst. Telegram tillader op til 4096 tegn efter parsing.Standard
FormateringValgfrit Telegram-format. MarkdownV2-specialtegn skal escapes efter Telegrams regler.Standard
Forumemne-idValgfrit. Sender beskeden til et bestemt forumemne i en supergruppe.Standard
Svar på besked-idValgfrit komfortfelt, der flettes ind i reply_parameters.message_id.Standard
Send lydløstSender uden notifikationslyd. Beskeden forbliver synlig.Standard
Forhindr videresendelse og lagringBeskytter indholdet mod videresendelse og lokal lagring, hvor Telegram understøtter det.Standard
LinkvisningValgfrit LinkPreviewOptions-objekt med JSON-autocomplete fra tidligere noder.Standard
SvarparametreValgfrit ReplyParameters-objekt, som flettes sikkert med besked-id-feltet.Standard
Knapper eller eget tastaturValgfrit JSON-objekt: InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove eller ForceReply.Standard
Callback-query-idPåkrævet. Brug callback_query.id fra Telegram-triggeren. Telegram viser en indlæsningsindikator på knappen, indtil den bekræftes.Standard
BeskedtekstValgfri besked på 0 til 200 tegn. Uden tekst stoppes kun indlæsningsindikatoren.Standard
Vis som advarselViser beskeden som en dialog i stedet for en kort notifikation øverst på skærmen.Standard
Callback-URLValgfrit. Å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. elementFra (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

InputBetydningType
Chat-idIndstil værdien i nodepanelet.text
BeskedIndstil værdien i nodepanelet.text
Emne-idIndstil værdien i nodepanelet.number
Svar påIndstil værdien i nodepanelet.number
KnapperIndstil værdien i nodepanelet.json
Callback-query-idIndstil værdien i nodepanelet.text
Callback-beskedIndstil værdien i nodepanelet.text
Vis som advarselIndstil værdien i nodepanelet.boolean
Callback-URLIndstil værdien i nodepanelet.text
CachetidIndstil værdien i nodepanelet.number
OutputBetydningType
SendtIndstil værdien i nodepanelet.boolean
Besked-idIndstil værdien i nodepanelet.number
Chat-idIndstil værdien i nodepanelet.text
Sendt kl.Indstil værdien i nodepanelet.number
Telegram-beskedHele Message-svaret fra Telegram Bot API.json
Callback besvaretSand, når Telegram har accepteret svaret på knaptrykket.boolean
Besvaret callback-query-idIndstil 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.