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

# WhatsApp Hesap Bağlama — Facebook Embedded Signup ile Kurulum

> WhatsApp Business hesabınızı platforma bağlama adımları. Facebook Embedded Signup, hesap durumları, bağlantı kesme ve çoklu hesap yönetimi rehberi.

## Genel Bakış

WhatsApp Business entegrasyonunu kullanabilmek için öncelikle Meta WhatsApp Business hesabınızı platforma bağlamanız gerekir. Bağlantı, **Facebook Embedded Signup** akışı üzerinden gerçekleştirilir.

## Ön Koşullar

* **Enterprise** plan aktif olmalı (`whatsapp_messaging_channel` yetkisi)
* Meta Business Manager hesabı
* Facebook Embedded Signup'ı tamamlayabilecek yetkili bir Meta kullanıcısı

<Note>
  Hesap bağlama işlemi sırasında platform, Meta App ID ve yapılandırma bilgilerini otomatik olarak sağlar. Sizin ayrıca API anahtarı girmenize gerek yoktur.
</Note>

## Hesap Bağlama Adımları

<Steps>
  <Step title="WhatsApp Sayfasına Gidin">
    Sol menüden **WhatsApp** bölümüne gidin veya **Ayarlar > WhatsApp** sayfasını açın
  </Step>

  <Step title="Bağlantı Niyeti Oluşturun">
    **WhatsApp Hesabı Bağla** butonuna tıklayın. Platform otomatik olarak bir bağlantı niyeti (connection intent) oluşturur ve Meta App ID ile yapılandırma bilgilerini hazırlar
  </Step>

  <Step title="Facebook Oturum Açınız">
    Açılan pencerede Facebook hesabınızla oturum açın. Bu hesap, Meta Business Manager'da yetkili olmalıdır
  </Step>

  <Step title="İşletme Hesabınızı Seçin">
    Meta Business Manager'daki işletme hesabınızı seçin veya yeni bir WhatsApp Business Hesabı (WABA) oluşturun
  </Step>

  <Step title="Telefon Numarasını Kaydedin">
    WhatsApp için kullanacağınız telefon numarasını seçin veya yeni bir numara ekleyin
  </Step>

  <Step title="İzinleri Onaylayın">
    Platform'un WhatsApp Business hesabınıza erişim izinlerini onaylayın. Bu izinler mesaj gönderme, şablon yönetimi ve webhook abone olma yetkilerini içerir
  </Step>

  <Step title="Kurulumu Tamamlayın">
    Bağlantı tamamlandığında platform otomatik olarak:

    * Erişim anahtarını (access token) alır
    * Webhook aboneliğini oluşturur
    * Telefon numarasını kaydeder
    * Sağlık kontrolünü başlatır

    <Frame>
      <img src="https://mintcdn.com/aiagenttr/EsPj4y2_ld-gNsL8/images/whatsapp-account-connected.png?fit=max&auto=format&n=EsPj4y2_ld-gNsL8&q=85&s=8a90ca06cb8a5a5f38ebbade03915a13" alt="WhatsApp hesabı başarıyla bağlandı ekranı" width="1358" height="821" data-path="images/whatsapp-account-connected.png" />
    </Frame>
  </Step>
</Steps>

## Hesap Durumları

Bağlantı süreci sırasında hesabınız aşağıdaki durumlardan geçer:

| Durum           | Açıklama                                         | Renk       |
| --------------- | ------------------------------------------------ | ---------- |
| `connecting`    | Bağlantı işlemi başlatıldı                       | 🟡 Sarı    |
| `setup_started` | Facebook Signup tamamlandı, kurulum devam ediyor | 🟡 Sarı    |
| `ready`         | Hesap başarıyla bağlandı, mesajlaşmaya hazır     | 🟢 Yeşil   |
| `setup_failed`  | Kurulum sırasında hata oluştu                    | 🔴 Kırmızı |
| `setup_retry`   | Başarısız kurulum yeniden deneniyor              | 🟡 Sarı    |
| `disconnected`  | Hesap bağlantısı kesildi                         | ⚫ Gri      |

### Normal Akış

```
connecting → setup_started → ready
```

### Hata Akışı

```
connecting → setup_started → setup_failed → setup_retry → ready
```

<Info>
  `setup_failed` durumundaki hesaplar için platform otomatik olarak yeniden deneme yapar. Sorun devam ederse **Sorun Giderme** bölümüne bakın.
</Info>

## Onboarding Türleri

Platform iki farklı onboarding türünü destekler:

### Tam Onboarding (Full)

Yeni bir WhatsApp Business Hesabı oluşturarak sıfırdan başlama. Tüm yapılandırma platform üzerinden yapılır.

### Birlikte Kullanım (Coexistence)

Mevcut bir WhatsApp Business Hesabını platforma bağlarken, diğer uygulamalarla birlikte çalışma. Bu modda:

* Mevcut konuşma geçmişi senkronize edilebilir
* Diğer uygulamalardan gelen mesajlar da alınır (SMB echo)
* Durum senkronizasyonu otomatik olarak yapılır

## Hesap Bilgileri

Bağlantı tamamlandıktan sonra aşağıdaki bilgilere erişebilirsiniz:

| Alan                       | Açıklama                                    |
| -------------------------- | ------------------------------------------- |
| **WABA ID**                | WhatsApp Business Account kimlik numarası   |
| **Business ID**            | Meta Business hesap kimlik numarası         |
| **Namespace**              | Mesaj şablonları için kullanılan ad alanı   |
| **Erişim Anahtarı Durumu** | Access token'ın geçerlilik durumu           |
| **Telefon Numarası**       | Kayıtlı WhatsApp telefon numarası           |
| **Doğrulanmış İsim**       | Meta tarafından doğrulanmış işletme adı     |
| **Kalite Puanı**           | Telefon numarasının mesajlaşma kalite puanı |

## Hesap Bağlantısını Kesme

<Warning>
  Hesap bağlantısını kestiğinizde **tüm aktif mesajlaşma oturumları kapatılır** ve WhatsApp üzerinden mesaj gönderme/alma durur. Bu işlem geri alınamaz.
</Warning>

<Steps>
  <Step title="WhatsApp Hesap Sayfasına Gidin">
    Ayarlar > WhatsApp bölümünde bağlı hesabınızı seçin
  </Step>

  <Step title="Bağlantı Kes Butonuna Tıklayın">
    Hesap detay sayfasında **Bağlantı Kes** butonuna tıklayın
  </Step>

  <Step title="Onaylayın">
    Açılan onay penceresinde işlemi teyit edin. Platform:

    * Webhook aboneliğini iptal eder
    * Sistem kullanıcısını siler
    * Tüm aktif oturumları kapatır
    * Erişim anahtarını geçersiz kılar
  </Step>
</Steps>

<Warning>
  Meta hesabınız veya WABA'nız tehlikeye girdiğini düşünüyorsanız, Meta Business Manager'dan uygulama erişimini hemen iptal edin ve ardından platformda hesabı yeniden bağlayın.
</Warning>

## Çoklu Hesap Yönetimi

Bir organizasyon birden fazla WhatsApp Business hesabı bağlayabilir. Her hesap farklı bir telefon numarası ve WABA ile ilişkilendirilir.

**Kullanım senaryoları:**

* Farklı departmanlar için ayrı WhatsApp numaraları
* Farklı ülkeler için yerel numaralar
* Test ve üretim ortamları için ayrı hesaplar

## Sonraki Adımlar

<CardGroup cols={2}>
  <Card title="Telefon Numarası Sağlığı" icon="heart-pulse" href="/docs/whatsapp/phone-number-health">
    Bağlı numaranızın sağlık durumunu izleyin
  </Card>

  <Card title="Mesaj Şablonları" icon="file-lines" href="/docs/whatsapp/message-templates">
    Şablon mesajları yönetin
  </Card>

  <Card title="Ajan Yapılandırması" icon="gear" href="/docs/whatsapp/agent-configuration">
    AI Agent'ınızı WhatsApp kanalına bağlayın
  </Card>

  <Card title="Sorun Giderme" icon="wrench" href="/docs/whatsapp/troubleshooting">
    Bağlantı sorunları için çözümler
  </Card>
</CardGroup>