# Araçlar: asistanı randevu, CRM ve kendi sistemlerinize bağlamak

> Webhook aracı, MCP sunucusu ya da Postman koleksiyonuyla asistanın randevu oluşturmasını, kayıt sorgulamasını ve sisteminizde işlem yapmasını sağlayın.

Kaynak: https://bilgibankasi.kobikom.com.tr/digiai/digiai-araclar-webhook-mcp · Kategori: DigiAI Yapay Zeka Asistanı · Güncelleme: 2026-10-22 · Yayıncı: KobiKom (https://www.kobikom.com.tr)

**Başlamadan önce**

- Hesabınızda DigiAI modülünün açık olması ve DigiAI yetkiniz.
- Asistanın kaydedilmiş olması.
- Bağlanacak sistemin HTTPS adresi ve gerekiyorsa erişim anahtarı (yazılım ekibinizden alın).

Araçlar, asistanın görüşme sırasında sizin sistemlerinizde işlem yapmasını sağlar: müsait randevu saatlerini sorgulamak, randevu oluşturmak, müşteri kaydını bulmak, destek kaydı açmak gibi. Randevu ya da CRM için ayrı bir ekran yoktur; bu bağlantıların hepsi araç olarak tanımlanır.

> Ekran: Agent Düzenle — Düzenle › Araçlar. Panelde araçlar üç bölümde listelenir: KobiKom Araçları, Webhook Araçları ve MCP Sunucuları.

| Alan | Değer | Not |
| --- | --- | --- |
| (1) Araçlar | _Formdaki sekme_ |  |
| (2) Araç Ekle | _Tek bir web adresine (webhook) istek atan araç_ |  |
| (3) MCP Sunucu Ekle | _Birden çok aracı tek adresten sunan sunucu_ |  |
| (4) Postman Collection Ekle | _Postman koleksiyonundaki uçları toplu araç yapar_ |  |
| (5) KobiKom | _DigitalOffix’ten aldığınız hizmetlere göre eklenen hazır araçlar_ | Silinemez; yalnız açılıp kapatılır. |

## Webhook aracı eklemek

### 1. Aracı tanımlayın (Yönetici · DigitalOffix)

**Araç Ekle**’ye basın. **Yapılandırma** sekmesini doldurun.

> Ekran: Araç Ekle — Araçlar › Araç Ekle. Bağlantıyı Test Et düğmesi araç kaydedildikten sonra, düzenleme penceresinde görünür.

| Alan | Değer | Not |
| --- | --- | --- |
| (1) Ad | `randevu_olustur` | Küçük harf ve alt çizgi kullanın; asistan aracı bu adla tanır. |
| (2) Açıklama | _Aracın ne zaman kullanılacağı_ | Asistan aracı bu açıklamaya bakarak seçer. “Müşteri saati onaylayınca randevuyu kaydeder” gibi açık yazın. |
| (3) Method | _GET, POST, PUT, PATCH ya da DELETE_ |  |
| (4) URL | _https:// ile başlayan adres_ | HTTP adresleri kabul edilmez. |
| (5) Aktif | _Açıkken asistan bu aracı kullanabilir_ |  |
| (6) Headers | _Kimlik doğrulama: Bearer ya da API Key_ | Bearer seçerseniz değer istek gönderilirken “Bearer” ile birleştirilir. |
| (7) Body Parameters | _Asistanın göndereceği alanlar_ |  |

### 2. Parametreleri ekleyin (Yönetici · DigitalOffix)

Asistanın müşteriden alıp sisteminize göndereceği her bilgi için bir parametre ekleyin.

> Ekran: Araç Ekle — Araç Ekle › Body Parameters. GET yönteminde bu sekmenin adı Query Parameters olur.

| Alan | Değer | Not |
| --- | --- | --- |
| (1) Identifier | _Sisteminizin beklediği alan adı (ör. musteri_telefon)_ |  |
| (2) Tip | _Sabit ya da Değişken değer_ | **Sabit**: her istekte aynı değer gider (ör. şube kodu). **Değişken değer**: asistan görüşmeden doldurur. |
| (3) Açıklama | _Asistana parametreyi tanıtın_ | **Örnek** alanına bir örnek değer yazın; asistan biçimi buradan öğrenir (ör. tarih için 2026-10-22). |

### 3. Kaydedip test edin (Yönetici · DigitalOffix)

**Ekle**’ye basın. Aracı listede açıp **Bağlantıyı Test Et** ile örnek değerler girerek deneyin. Sonuçta **HTTP 200** gibi bir kod ve sisteminizin cevabı görünür.

## MCP sunucusu eklemek

Yazılım ekibiniz araçlarınızı bir MCP sunucusu olarak sunuyorsa **MCP Sunucu Ekle** ile **Server URL** adresini ve gerekiyorsa **Authorization** başlığını girin. Kaydettikten sonra **Sync** düğmesi sunucudaki araçları çeker. **Araçlar** sekmesinde her aracı ayrı ayrı açıp kapatabilir, **Test Et** ile deneyebilirsiniz. Sunucu durumu satırda yazar: Bağlı, Bağlı değil, Başarısız, Bağlanıyor ya da Erişilemiyor.

## Postman koleksiyonundan içe aktarmak

1. **Postman Collection Ekle**’ye basın ve koleksiyonun JSON dosyasını seçin (Collection v2.0 ya da v2.1).
2. **Değişkenler** bölümünde koleksiyondaki değişkenlerin (ör. temel adres, anahtar) değerlerini girin. Değişkeni çözülmemiş uç kaydedilmez.
3. **Endpointler** listesinden araç yapılacak uçları seçin. “Desteklenmiyor”, “HTTPS değil” ya da “Araç adı gerekli” rozetli uçları düzeltin ya da dışarıda bırakın.
4. **Onayla ve İçe Aktar**’a basın. Sonuçta her uç için “Oluşturuldu” ya da hata nedeni yazar.

> Asistan araçları gerçekten çalıştırır: oluşturulan randevu ya da kayıt sisteminizde gerçek kayıttır. Yeni bir aracı canlıya almadan önce [Test Et](https://bilgibankasi.kobikom.com.tr/digiai/digiai-test-et-ve-egit) ile kendi telefon numaranızı kullanarak deneyin.

> Asistanı sildiğinizde ona bağlı tüm araçlar (webhook ve MCP sunucuları) da kalıcı olarak silinir.

**İlgili KobiKom hizmetleri:** [DigiAI VoiceBot](https://www.kobikom.com.tr/digiai-voicebot), [DigiAI ChatBot](https://www.kobikom.com.tr/digiai-chatbot), [Çok Kanallı AI Asistan](https://www.kobikom.com.tr/yapay-zeka)

Destek: 0850 888 1 444 · destek@kobikom.com.tr