# n8n Sales Assistant MVP

Bu paket, Instagram DM, WhatsApp ve web chat mesajlarini tek bir n8n mimarisinde toplayan MVP kurulumunu hazirlar.

## Durum Ozeti

- Yerel n8n kurulumu yapildi.
- Yerel owner hesabi olusturuldu.
- 4 workflow n8n'e import edildi.
- `OPENAI_API_KEY` yerel n8n surecine baglandi.
- CyberPanel uzerinde proje icin website alani olusturuldu.
- Proje README, index sayfasi, workflow JSON'lari ve schema dosyalari canli siteye yuklendi.
- Canli site: `http://chatotomasyon.178.105.119.141.nip.io/`
- Test chat ortami hazirlandi: `http://chatotomasyon.178.105.119.141.nip.io/test-chat.html`
- Gecici notlar sekmesi hazirlandi: `http://chatotomasyon.178.105.119.141.nip.io/notlar.html`
- Bot bilgi tabani Lockman Real Estate web sitesi bilgileriyle guncellendi.

## Yerel n8n Bilgileri

- URL: `http://127.0.0.1:5678`
- Gecici admin e-posta: `admin.local@n8n.test`
- Gecici admin parola: `CodexN8n2026!`

Not: Bu bilgiler yerel gelistirme kurulumu icindir. Canli ortama gecmeden once parola degistirilmeli ve kalici servis tanimi yapilmalidir.

## Dosyalar

- [conversation-orchestrator.json](/C:/Users/PC/Documents/Codex/2026-06-18/n8n-otomasyonu-yapman-istiyorum-instagram-whatsapp/outputs/workflows/conversation-orchestrator.json)
- [instagram-inbound.json](/C:/Users/PC/Documents/Codex/2026-06-18/n8n-otomasyonu-yapman-istiyorum-instagram-whatsapp/outputs/workflows/instagram-inbound.json)
- [whatsapp-inbound.json](/C:/Users/PC/Documents/Codex/2026-06-18/n8n-otomasyonu-yapman-istiyorum-instagram-whatsapp/outputs/workflows/whatsapp-inbound.json)
- [webchat-inbound.json](/C:/Users/PC/Documents/Codex/2026-06-18/n8n-otomasyonu-yapman-istiyorum-instagram-whatsapp/outputs/workflows/webchat-inbound.json)
- [knowledge-base.sample.json](/C:/Users/PC/Documents/Codex/2026-06-18/n8n-otomasyonu-yapman-istiyorum-instagram-whatsapp/outputs/schemas/knowledge-base.sample.json)
- [webchat-contract.json](/C:/Users/PC/Documents/Codex/2026-06-18/n8n-otomasyonu-yapman-istiyorum-instagram-whatsapp/outputs/schemas/webchat-contract.json)

## Kurulum Sirasi

1. n8n icinde once `conversation-orchestrator.json` workflow'unu import edin.
2. Ardindan 3 inbound workflow'unu import edin.
3. `ORCHESTRATOR_WORKFLOW_ID` alanlarini, import edilen orchestrator workflow ID'si ile guncelleyin.
4. Asagidaki credentials ve degiskenleri tanimlayin:
   - `OPENAI_API_KEY`
   - `META_GRAPH_ACCESS_TOKEN`
   - `META_PHONE_NUMBER_ID`
   - `META_INSTAGRAM_BUSINESS_ACCOUNT_ID`
   - `WEBCHAT_REPLY_ENDPOINT`
   - `GOOGLE_SHEETS_LEADS_SPREADSHEET_ID`
   - `GOOGLE_SHEETS_KB_SPREADSHEET_ID`
   - `GOOGLE_CALENDAR_ID`
   - `TEAM_NOTIFICATION_WEBHOOK`
5. Google Sheets tarafinda 2 sayfa hazirlayin:
   - `knowledge_base`
   - `leads`
6. Calendar credential'i baglayin ve randevu workflow node'larinda kullanin.

## CyberPanel Tasima Notu

Hedef:

- CyberPanel paneli uzerinden `chatotomasyon.178.105.119.141.nip.io` alanini olusturmak
- n8n'i sunucuya tasimak
- workflow'lari canli instance'a almak

Tamamlananlar:

- CyberPanel oturumu HTTP/API uzerinden acildi.
- Website olusturma istegi basarili calisti.
- Domain: `chatotomasyon.178.105.119.141.nip.io`
- Linux kullanicisi: `chato2003`
- Website path: `/home/chatotomasyon.178.105.119.141.nip.io/public_html`
- Kurulum durumu: `Successfully Installed.`

Canli site:

- `http://chatotomasyon.178.105.119.141.nip.io/`
- `https://chatotomasyon.178.105.119.141.nip.io/` SSL durumuna gore kullanilabilir.

Not:

- `nip.io`, IP adresini otomatik cozen wildcard DNS servisidir. Bu nedenle `chatotomasyon.178.105.119.141.nip.io` dogrudan `178.105.119.141` IP adresine cozulur.
- CyberPanel website alani kuruldu; ancak gercek n8n prosesinin sunucuda servis olarak calismasi icin SSH veya CyberPanel terminal/Node app/Docker yetkisi gerekir.
- Mevcut asamada siteye proje dokumani ve workflow paketleri yuklenir.

Canliya yuklenen dosyalar:

- `/public_html/index.html`
- `/public_html/test-chat.html`
- `/public_html/api/chat.php`
- `/public_html/api/notes.php`
- `/public_html/notlar.html`
- `/public_html/README.md`
- `/public_html/workflows/conversation-orchestrator.json`
- `/public_html/workflows/instagram-inbound.json`
- `/public_html/workflows/whatsapp-inbound.json`
- `/public_html/workflows/webchat-inbound.json`
- `/public_html/schemas/knowledge-base.sample.json`
- `/public_html/schemas/webchat-contract.json`

## Test Chat Ortami

Canli test URL:

- `http://chatotomasyon.178.105.119.141.nip.io/test-chat.html`

Bu test ortami web chat kanalini simule eder:

- Kullanici mesajini `/api/chat.php` endpoint'ine gonderir.
- PHP backend OpenAI Responses API ile Turkce satis asistani cevabi uretir.
- Telefon, fiyat, randevu, geri arama ve insan devri niyetleri yakalanir.
- Test lead kayitlari sunucuda `/home/chatotomasyon.178.105.119.141.nip.io/data/leads.jsonl` dosyasina yazilir.
- Konusma bazli musteri bilgisi `/home/chatotomasyon.178.105.119.141.nip.io/data/conversations/*.json` dosyalarinda tutulur.
- Randevu olusunca `/home/chatotomasyon.178.105.119.141.nip.io/data/appointments.jsonl` dosyasina yazilir.
- Test edildi: fiyat sorusu ve telefonlu randevu talebi icin API basarili JSON cevap dondurdu.

## Lockman Real Estate Bilgi Tabani

Bot su kaynaklardan ozet bilgiyle cevap verir:

- Ana sayfa: `https://lockmanrealestate.com/`
- Hakkimda: `https://lockmanrealestate.com/hakkimda/`
- Devam eden projeler: `https://lockmanrealestate.com/devam-eden-projeler/`
- Iletisim: `https://lockmanrealestate.com/iletisim/`
- Ornek proje detaylari: Kusadasi Koyada, Izmir Dikili, Izmir Merkez, Incek Iz

Kapsam:

- Lokman Demirbacak kimdir
- Gayrimenkul yatirim danismanligi yaklasimi
- Devam eden proje listesi
- Proje bazli lokasyon, teslim, fiyat/odeme plani ve genel ozellikler
- Iletisim bilgileri

Gecici notlar:

- `http://chatotomasyon.178.105.119.141.nip.io/notlar.html`
- Konusma bilgileri ve randevular bu sayfada listelenir.

OpenAI anahtari tarayiciya verilmez. Anahtar sunucuda public_html disindaki `/home/chatotomasyon.178.105.119.141.nip.io/chat-config.php` dosyasindan okunur.

## Google Sheets Sekmeleri

### knowledge_base

| category | question | answer | tags | cta |
| --- | --- | --- | --- | --- |
| product | Urun X nedir? | Urun X ... | urunx,genel | Telefon birakmak ister misiniz? |

### leads

| conversation_id | channel | user_id | name | phone | product_interest | intent | callback_request | appointment_status | summary | raw_message | created_at | updated_at |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |

## Kanal Beklentileri

### Instagram DM

- Meta webhook payload'i n8n `instagram-inbound` workflow'una gelecek.
- Reply icin Graph API kullanilir.
- Ilk surum sadece DM icindir.

### WhatsApp

- WhatsApp Cloud API webhook'u `whatsapp-inbound` workflow'una gelir.
- Reply icin `messages` endpoint'i kullanilir.

### Web Chat

- Ozel widget backend'i `webchat-inbound` webhook'una POST atar.
- Orchestrator sonucu, `WEBCHAT_REPLY_ENDPOINT` adresine geri gonderilir.
- Beklenen payload sekli `webchat-contract.json` icindedir.

## Operasyon Notlari

- Bilgi tabani disinda kalan cevaplarda bot uydurma yapmaz, insan devri bayragi acilir.
- Telefon numarasi regex ile kontrol edilir; gecerli degilse bot tekrar ister.
- Tekrarlayan `message_id` kayitlari `dedupe_key` ile elenir.
- Bot yanit dili varsayilan olarak Turkce'dir.