Kanallar

SupportBot kanal-agnostiktir: Chatwoot'a bağlanan her kanalın mesajları aynı bot hattından geçer. Web widget'ı kurulumla hazır gelir; WhatsApp ve Instagram, Chatwoot yapılandırmasıyla eklenir — kod değişikliği gerekmez.

Nasıl Çalışır?

Her kanal Chatwoot'ta bir "inbox"tır (gelen kutusu). Hangi kanaldan gelirse gelsin mesaj, bot köprüsü üzerinden yapay zekaya ulaşır; bot yanıtı aynı kanaldan döner. İnsan devri (bot çözemedi → temsilciye aktar) tüm kanallarda aynı şekilde çalışır.

Bot yanıtları düz metindir (markdown yok) — WhatsApp/Instagram görüntülemesiyle birebir uyumludur.

Web Widget'ı

Kurulumla otomatik gelir ("Web Sohbet" inbox'ı). Siteye ekleme ve görünüm için: Site Widget'ı.

WhatsApp (Cloud API)

Ortam değişkeni gerekmez; tamamı Chatwoot üzerinden yapılır:

1. Meta Business'ta WhatsApp Cloud API erişimi alın (telefon numarası ID + kalıcı token).
2. Chatwoot → Inboxes → Add Inbox → WhatsApp → "WhatsApp Cloud" seçin; telefon numarası ID, Business hesabı ID ve token'ı girin.
3. Meta webhook doğrulaması için Chatwoot'un verdiği callback URL'ini ve doğrulama token'ını Meta panelinde tanımlayın.
4. Bitti — bot bağlama otomatiktir (aşağıya bakın).

Instagram / Messenger

Meta app kimliği gerekir; bir kez .env'e yazılır:

1. developers.facebook.com'da bir app oluşturun (Instagram Graph API + Messenger izinleri).

2. infra/.env dosyasında ilgili değişkenleri doldurun:

   • Messenger için: FB_APP_ID, FB_APP_SECRET, FB_VERIFY_TOKEN
   • Instagram için: INSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET, INSTAGRAM_VERIFY_TOKEN

3. Chatwoot'u yeniden başlatın:

   cd infra
   docker compose up -d chatwoot chatwoot-sidekiq
   

   Chatwoot'un Instagram/Messenger inbox seçenekleri açılır.

4. Chatwoot → Add Inbox → Instagram (veya Messenger) ile hesabı bağlayın.

Bot'un Kanallara Bağlanması

Yeni bir inbox eklediğinizde bota elle bağlamanız gerekmez:

• Bir sonraki docker compose up'ta kurulum görevi, botu hesaptaki tüm inbox'lara otomatik bağlar.

• Beklemeden hemen bağlamak için:

  docker compose up -d --no-deps init-chatwoot-provision
  

İstisna tutmak isterseniz (örn. yalnızca insan temsilcilerin bakacağı bir VIP hattı): inbox id'lerini infra/.env içindeki BOT_BIND_EXCLUDE_INBOX_IDS değişkenine virgülle yazın (örn. 3,5). Bu inbox'lara bot bağlanmaz ve Chatwoot arayüzünden botunu kaldırdığınız bir inbox'a yeniden bağlanılmaz.

Sorun Giderme

Belirti	Kontrol
WhatsApp mesajı geliyor ama bot yanıt vermiyor	Inbox'un bota bağlandığından emin olun (yukarıdaki provizyon komutu); Panel → Webhook Olayları'ndan akışı izleyin.
Instagram inbox seçeneği görünmüyor	INSTAGRAM_* değişkenleri dolu mu, chatwoot + chatwoot-sidekiq yeniden başlatıldı mı?
Meta webhook doğrulaması başarısız	Callback URL'i chat.<alan-adınız> üzerinden erişilebilir mi, doğrulama token'ı birebir aynı mı?