> ## 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

> Macaly agent'ı ile Telegram üzerinden sohbet edin

Macaly'nin Telegram bağlantısı, Macaly agent'ı ile telefonunuzdan sohbet etmenizi sağlar. Telegram'da bir mesaj gönderin, yanıtınızı alın ve web uygulamasını açmadan projeleriniz üzerinde çalışmaya devam edin.

## Neler yapabilirsiniz

Telegram'daki agent, web uygulamasında oluşturduğunuz projelerin aynısı üzerinde çalışır. Normalde agent'tan isteyeceğiniz her şeyi Telegram'dan da isteyebilirsiniz:

* **Yeni bir proje başlatın.** Ne oluşturmak istediğinizi anlatın, agent tıpkı web uygulamasındaki gibi işe koyulsun.
* **Mevcut projelerinizi düzenleyin.** Değişiklik, düzeltme veya yeni bölümler isteyin. Birden fazla projeniz varsa ve hangisi olduğunu söylemezseniz agent size sorar.
* **Yayınlayın ve yönetin.** Bir projeyi yayınlayın, alt alan adını değiştirin veya neyin yayında olduğunu kontrol edin.
* **Hızlı sorular sorun.** Akışınızı bozmadan yardım, fikir veya durum bilgisi alın.

Agent değişiklik yaptığında size bir önizleme bağlantısı gönderir, böylece sonucu Telegram'dan çıkmadan kontrol edebilirsiniz.

## Neler gönderebilirsiniz

Agent şu anda şunlarla çalışır:

* **Metin mesajları.** Yazın ve gönderin, o kadar.
* **Sesli mesajlar.** Macaly bunları yazıya döker ve yanıt verir. Yazmanın pratik olmadığı durumlarda işinize yarar.
* **Görseller.** Agent'ın bakması gereken ekran görüntülerini, taslakları veya referansları gönderin.
* **Dosyalar.** Agent'ın okuyup kullanabileceği PDF'ler ve belgeler.

Videolar henüz desteklenmiyor. Yanıtlar, zengin biçimlendirme veya bağlantı önizlemeleri olmadan düz metin olarak gelir.

## Nasıl kurulur

<Steps>
  <Step title="Bağlantılar ayarlarını açın">
    Macaly'de **Ayarlar → Bağlantılar** bölümüne gidin ve Telegram kartındaki **Bağlan** düğmesine tıklayın.

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

  <Step title="Telegram'ı açın">
    Macaly bir QR kodu ve bağlantı bağlantısı gösterir. QR kodunu telefonunuzla tarayın veya bağlantı kodu önceden doldurulmuş halde bilgisayarınızda ya da telefonunuzda başlatmak için **Telegram'ı aç**'a tıklayın.
  </Step>

  <Step title="Start'a basın">
    Telegram, Macaly botuyla bir sohbet açar ve `/start [KOD]` mesajını önceden doldurur. Bağlanmak için **Start**'a basın (veya mesajı gönderin).
  </Step>

  <Step title="Sohbete başlayın">
    Macaly bağlantıyı onaylar ve bağlı olduğu hesabı gösterir. Artık Telegram'dan istediğiniz zaman agent'a mesaj yazabilirsiniz.
  </Step>
</Steps>

Bağlantı kodu 15 dakika geçerlidir. Süresi dolarsa Bağlantılar ayarlarından yeni bir tane oluşturun.

## Bot komutları

Macaly ile Telegram sohbetinizde şu komutlardan herhangi birini gönderebilirsiniz:

| Komut | Ne işe yarar |
| - | - |
| `/new` | Agent ile yeni bir konuşma başlatır. |
| `/switch` | Bağlı başka bir çalışma alanına geçer (birden fazla çalışma alanı bağlıysa görünür). |
| `/status` | Bağlantınızın ve mevcut sohbetin durumunu gösterir. |
| `/unlink` | Bir çalışma alanının bu sohbetle bağlantısını keser. Birden fazla çalışma alanı bağlıysa hangisi olduğunu siz seçersiniz. |
| `/help` | Kullanılabilir komutları listeler. |

## Birden fazla çalışma alanı kullanma

Aynı Telegram hesabını birden fazla Macaly çalışma alanına bağlayabilirsiniz, aynı anda en fazla 3 tanesine. Birden fazla çalışma alanında çalışıyorsanız ve hepsine tek bir sohbetten ulaşmak istiyorsanız bu çok işe yarar.

* **Başka bir çalışma alanı bağlayın.** Diğer çalışma alanında **Ayarlar → Bağlantılar** bölümünü açın ve aynı Telegram hesabından bağlayın.
* **Aktif çalışma alanını değiştirin.** `/switch` gönderin ve listeden bir çalışma alanı seçin. Bir sonraki mesajınız orada yeni bir konuşma başlatır.
* **Hangisinin aktif olduğunu görün.** `/status` gönderin, yanıt aktif çalışma alanının adıyla başlar.

Aynı anda yalnızca bir çalışma alanı aktiftir, bu nedenle mesajlar en son geçiş yaptığınız çalışma alanına gider. Aktif çalışma alanının bağlantısını keserseniz Macaly, sohbetin çalışmaya devam etmesi için bağlı başka bir çalışma alanına otomatik olarak geçer.

## Bağlantıyı kesme

Bağlantıyı kesmek için Telegram'dan `/unlink` gönderin veya uygulamada **Ayarlar → Bağlantılar** bölümünü açıp bağlı hesabı kaldırın.

Sohbet yalnızca tek bir çalışma alanına bağlıysa bağlantı hemen kesilir. Birden fazla çalışma alanı bağlıysa `/unlink` hangisinin kaldırılacağını sorar. O sırada kullanmadığınız bir çalışma alanının bağlantısını kesmek konuşmanızı etkilemez, aktif olanın bağlantısını kesmek ise sohbeti bağlı başka bir çalışma alanına geçirir.

## Bilmekte fayda var

* **Bot kurulumu gerekmez.** Kendi Telegram botunuzu oluşturmanıza veya bir API anahtarı almanıza gerek yok. Ayarlar'dan bağlanın ve sohbete başlayın.
* **Krediler web uygulamasındaki gibi çalışır.** Agent'ın işi, web uygulamasıyla aynı oranda kredi kullanır; sesli mesaj gönderdiğinizde buna küçük bir ek miktar eklenir (transkripsiyon için).
* **Telegram hesabı başına en fazla 3 çalışma alanı.** Telegram hesabınızı birden fazla Macaly çalışma alanına (en fazla 3 tanesine) bağlayabilir ve `/switch` ile aralarında geçiş yapabilirsiniz. Her çalışma alanı üyesi de kendi hesabını bağlayabilir.
* **Sesli mesaj boyut sınırı.** Sesli mesajlar en fazla 10 MB olabilir. Daha uzun kayıtlar gönderilemez.


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