> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> Keskustele Macaly-agentin kanssa Telegramissa

Macalyn Telegram-yhteyden avulla voit keskustella Macaly-agentin kanssa puhelimellasi. Lähetä viesti Telegramissa, saat vastauksen ja voit jatkaa projektiesi parissa avaamatta verkkosovellusta.

## Mitä voit tehdä

Telegram-agentti työskentelee samojen projektien parissa, joita rakennat verkkosovelluksessa. Kaiken, minkä muuten pyytäisit agentilta, voit pyytää myös Telegramista:

* **Aloita uusi projekti.** Kerro, mitä haluat rakentaa, ja agentti ryhtyy töihin aivan kuten verkkosovelluksessa.
* **Muokkaa olemassa olevia projektejasi.** Pyydä muutoksia, korjauksia tai uusia osioita. Jos sinulla on useita projekteja etkä kerro, mistä on kyse, agentti kysyy.
* **Julkaise ja hallitse.** Julkaise projekti, vaihda sen aliverkkotunnus tai tarkista, mikä on julkaistu.
* **Kysy nopeita kysymyksiä.** Saat apua, ideoita tai tilapäivityksiä työskentelysi keskeytymättä.

Kun agentti tekee muutoksia, se lähettää sinulle esikatselulinkin, jolla voit tarkistaa tuloksen poistumatta Telegramista.

## Mitä voit lähettää

Agentti ymmärtää tällä hetkellä seuraavat:

* **Tekstiviestit.** Kirjoita ja lähetä.
* **Ääniviestit.** Macaly litteroi ne ja vastaa. Kätevä, kun kirjoittaminen ei sovi tilanteeseen.
* **Kuvat.** Lähetä kuvakaappauksia, malleja tai referenssejä, joita agentin pitäisi katsoa.
* **Tiedostot.** PDF-tiedostoja ja dokumentteja, jotka agentti voi lukea ja hyödyntää.

Videoita ei vielä tueta. Vastaukset tulevat pelkkänä tekstinä ilman rikasta muotoilua tai linkkien esikatseluja.

## Käyttöönotto

<Steps>
  <Step title="Avaa Yhteydet-asetukset">
    Siirry Macalyssa kohtaan **Asetukset → Yhteydet** ja napsauta Telegram-kortissa **Yhdistä**.

    <img src="https://mintcdn.com/macaly-41b1d3e9/dOzNT7eRKWZWpaZK/images/integrations_telegram_01.png?fit=max&auto=format&n=dOzNT7eRKWZWpaZK&q=85&s=33014b19133bc9434e1335a8af1d97c4" alt="Asetusten Yhteydet-sivun Telegram-kortti" width="2400" height="1600" data-path="images/integrations_telegram_01.png" />
  </Step>

  <Step title="Avaa Telegram">
    Macaly näyttää QR-koodin ja yhteyslinkin. Skannaa QR-koodi puhelimellasi tai napsauta **Avaa Telegram**, niin Telegram avautuu tietokoneellasi tai puhelimellasi yhteyskoodi valmiiksi täytettynä.
  </Step>

  <Step title="Paina Start">
    Telegram avaa keskustelun Macaly-botin kanssa, ja viesti `/start [CODE]` on valmiiksi täytetty. Yhdistä painamalla **Start** (tai lähettämällä viesti).
  </Step>

  <Step title="Aloita keskustelu">
    Macaly vahvistaa yhteyden ja näyttää tilin, johon se on yhdistetty. Voit nyt lähettää agentille viestejä Telegramista milloin tahansa.
  </Step>
</Steps>

Yhteyskoodi on voimassa 15 minuuttia. Jos se vanhenee, luo uusi Yhteydet-asetuksista.

## Botin komennot

Voit lähettää mitä tahansa näistä Telegram-keskustelussasi Macalyn kanssa:

| Komento | Mitä se tekee |
| - | - |
| `/new` | Aloittaa uuden keskusteluketjun agentin kanssa. |
| `/switch` | Vaihtaa toiseen yhdistettyyn workspaceen (näkyy, kun yhdistettyjä on useampi kuin yksi). |
| `/status` | Näyttää yhteytesi ja nykyisen keskustelun tilan. |
| `/unlink` | Katkaisee workspacen yhteyden tähän keskusteluun. Jos yhdistettyjä on useita, valitset itse, minkä. |
| `/help` | Listaa käytettävissä olevat komennot. |

## Useiden workspacejen käyttö

Voit yhdistää saman Telegram-tilin useampaan Macaly-workspaceen, enintään kolmeen kerrallaan. Tästä on hyötyä, jos työskentelet useissa workspaceissa ja haluat tavoittaa ne kaikki samasta keskustelusta.

* **Yhdistä toinen workspace.** Avaa toisessa workspacessa **Asetukset → Yhteydet** ja yhdistä se samalta Telegram-tililtä.
* **Vaihda aktiivista workspacea.** Lähetä `/switch` ja valitse workspace listasta. Seuraava viestisi aloittaa siellä uuden keskustelun.
* **Katso, mikä on aktiivinen.** Lähetä `/status`. Vastauksen alussa on aktiivisen workspacen nimi.

Vain yksi workspace on aktiivinen kerrallaan, joten viestit menevät siihen workspaceen, johon vaihdoit viimeksi. Jos katkaiset aktiivisen workspacen yhteyden, Macaly vaihtaa keskustelun automaattisesti toiseen yhdistettyyn workspaceen, jotta se toimii edelleen.

## Yhteyden katkaiseminen

Voit katkaista yhteyden lähettämällä Telegramista `/unlink` tai avaamalla sovelluksessa **Asetukset → Yhteydet** ja poistamalla yhdistetyn tilin.

Jos keskustelu on yhdistetty vain yhteen workspaceen, yhteys katkeaa heti. Jos yhdistettyjä on useita, `/unlink` kysyy, minkä haluat poistaa. Jos katkaiset yhteyden workspaceen, jota et juuri käytä, keskustelusi ei muutu. Jos katkaiset aktiivisen workspacen yhteyden, keskustelu vaihtuu toiseen yhdistettyyn workspaceen.

## Hyvä tietää

* **Botin määrittämistä ei tarvita.** Sinun ei tarvitse luoda omaa Telegram-bottia tai hankkia API-avainta. Yhdistä Asetuksista ja aloita keskustelu.
* **Krediitit toimivat samoin kuin verkkosovelluksessa.** Agentin työ kuluttaa krediittejä samalla hinnalla kuin verkkosovelluksessa, ja ääniviestit maksavat lisäksi pienen summan (litterointi).
* **Enintään 3 workspacea Telegram-tiliä kohden.** Voit yhdistää Telegram-tilisi useaan Macaly-workspaceen (enintään kolmeen) ja vaihtaa niiden välillä komennolla `/switch`. Jokainen workspacen jäsen voi myös yhdistää oman tilinsä.
* **Ääniviestin kokoraja.** Ääniviestit voivat olla enintään 10 Mt. Pidemmät tallenteet eivät mene perille.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.