takv.im'i asistanına bağla

Nasıl bağlanır

1. Asistanının ayarlarında özel bağlayıcı ya da MCP sunucusu ekleme bölümünü aç. Bölümün adı her asistanda biraz farklıdır.
2. Adres olarak şunu yapıştır:
   https://takv.im/mcp
3. Asistan seni takv.im'e gönderir. Giriş yap ve "İzin ver" düğmesine bas.

Neler yapabilir

• Müşterileri listele: Randevu almış müşterileri listeler, en son randevusu olan başta. Ad ya da e-postaya göre arama yapabilir. Sayfa başına 20 kişi döner.
• Müşteri kartını getir: Bir müşterinin özetini, gruplarını ve son 20 randevusunu döndürür. Notlar yalnızca hesap sahibi customers:notes iznini verdiyse döner, aksi hâlde yalnızca not sayısı görünür.
• Müşteri gruplarını listele: Müşteri gruplarını (etiketleri), numaralarını ve kaç kişi olduklarını döndürür.
• Müşteriye not ekle: Mevcut bir müşterinin kartına yeni bir not ekler. Eski notları değiştirmez ya da silmez. Yeni müşteri oluşturamaz.
• Müşteri grubu oluştur: Yeni bir müşteri grubu (etiket) oluşturur. Aynı adlı grup varsa onu döndürür.
• Müşteriyi gruba ekle: Mevcut bir müşteriyi mevcut bir gruba ekler. Müşteriyi gruptan çıkaramaz.
• Profili getir: Profil bilgilerini döndürür: ad, başlık, hakkında yazısı, panel rengi (ve seçilebilecek renkler), saat dilimi, görüşme türleri görünümü, karşılama penceresi, fotoğraf ve sayfa adresi.
• Profili güncelle: Profilin yalnızca gönderilen alanlarını değiştirir. Gönderilmeyen alanlar olduğu gibi kalır. Panel rengi yalnızca listedeki tonlardan biri olabilir (ad ya da hex).
• Karşılama penceresini güncelle: Randevu sayfasına ilk gelen ziyaretçiye gösterilen karşılama penceresinin metnini ve YouTube videosunu değiştirir. Boş yazı göndermek ilgili alanı temizler. Gönderilmeyen alan olduğu gibi kalır.
• Profil fotoğrafını değiştir: Profil fotoğrafını değiştirir. image_url (https ile herkese açık, doğrudan görsel dosyasına giden adres, yönlendirme izlenmez) ya da image_base64 (en fazla 2 MB) verilir, ikisi birden verilmez. JPG, PNG, WEBP ve GIF olur.
• Görüşme türlerini listele: Bütün görüşme türlerini (aktif ve pasif) ayarları, fiyatı ve adresiyle döndürür.
• Görüşme türünü getir: Bir görüşme türünü özel soruları dahil döndürür.
• Görüşme türü oluştur: Yeni görüşme türü oluşturur (yalnızca name zorunlu, kalanı varsayılan: birebir, 30 dk, Google Meet, ücretsiz). Fiyat yazmak panelle aynı kurallara tabidir.
• Görüşme türünü güncelle: Bir görüşme türünün yalnızca gönderilen alanlarını değiştirir (fiyat, süre, yayın durumu dahil). Gönderilmeyen alanlar olduğu gibi kalır.
• Görüşme türünü sil: Bir görüşme türünü siler. O türdeki geçmiş randevu kayıtları da silinir. Ödemesi alınmış ya da yaklaşan randevusu olan tür silinmez (is_active=false ile yayından kaldır). Onay için confirm_name alanına türün tam adı yazılmalı.
• Özel soru ekle: Bir görüşme türüne, randevu alırken misafire sorulacak özel soru ekler.
• Özel soruyu güncelle: Bir özel sorunun yalnızca gönderilen alanlarını değiştirir.
• Özel soruyu sil: Bir özel soruyu siler.
• Müsaitliği getir: Haftalık çalışma saatlerini (0 = Pazartesi ... 6 = Pazar) ve yaklaşan tarih istisnalarını (izin günü, özel saat) döndürür.
• Haftalık çalışma saatlerini ayarla: Haftalık çalışma saatlerinin TAMAMINI verilen listeyle değiştirir. Listede olmayan gün kapalı olur. Önce get_availability ile mevcut saatlere bak.
• Tarih istisnası ekle: Belirli bir tarih için izin günü (closed=true) ya da özel çalışma saati ekler. Aynı tarihte istisna varsa önce silinmelidir.
• Tarih istisnasını sil: Bir tarih istisnasını siler.
• Geri bildirim gönder: Kullanıcının takv.im ekibine iletmek istediği bir hata, istek ya da soruyu kaydeder. Yalnızca kullanıcı isterse ve onun anlattığı şeyi gönder, göndermeden önce metni ona göster. Müşteri adı, e-posta ya da not metni ekleme.

Neler yapamaz

Müşteriyi, notu, grubu ve randevuyu silemez, müşteriyi gruptan çıkaramaz. Yeni müşteri ya da randevu oluşturamaz, randevuyu iptal edemez. Ödemelere, Shopier bağlantısına, e-posta ve şifreye erişemez.

Silme yalnızca görüşme türü, görüşme türünün özel sorusu ve müsaitlik istisnası için vardır. Bunun için ayrı bir izin istenir ve izin ekranında varsayılan olarak kapalıdır. Bir görüşme türü silinince o türdeki geçmiş randevu kayıtları da silinir. Ödemesi alınmış ya da yaklaşan randevusu olan tür silinmez.

Müşteri notları

Notları okumak ayrı bir izindir (customers:notes) ve izin ekranında varsayılan olarak kapalıdır. Notlara sağlık gibi hassas bilgi yazdıysan bu izni verme. Not eklemek bu izne bağlı değildir.

Fiyat verme

Asistan görüşme türüne fiyat yazabilir. Paneldeki kurallar aynen geçerlidir: ücretli randevu için Shopier bağlı olmalı ve tutar en düşük sınırın üstünde olmalı.

Gizliliğin

Asistan müşterilerinin adını, e-postasını ve notlarını okuyunca bu bilgiler asistanı sunan şirkete gider. Bu yüzden yalnızca güvendiğin bir asistanı bağla. İstediğin an Ayarlar sayfasındaki Güvenlik bölümünden bağlantıyı kesebilirsin.

Geliştiriciler için

• Kendi uygulamanı yazmak istiyorsan Geliştiriciler sayfasına bak.
• Adres: https://takv.im/mcp (Streamable HTTP, durumsuz)
• Giriş: OAuth 2.1, izin kodu ve PKCE (S256), otomatik istemci kaydı
• İzinler: bookings:read, customers:read, customers:notes, customers:write, account:read, account:write, account:delete, feedback:write
• Keşif: oauth-protected-resource ve oauth-authorization-server