Giriş yap

API, MCP ve webhook nasıl kullanılır?

Seviyorum’u kendi sistemlerinize ve yapay zekâ asistanlarınıza bağlayın: API anahtarı oluşturun, Claude ya da ChatGPT’yi MCP ile bağlayın, yeni deneyim ve sorular webhook ile anında sisteminize gelsin.

5 dakikada · 5 adımŞirket panelindeBusiness ve üzeri planlarda

Şirket API’si ile deneyimleri okuyup yanıtlayabilir, üyelerin sorularını yanıtlayabilir, ürün vitrininizi ve kuponlarınızı yönetebilir, istatistiklerinizi alabilirsiniz. Aynı işlemler MCP ile Claude, ChatGPT, Cursor gibi yapay zekâ asistanlarında araç olarak görünür. API ve MCP Business ve Kurumsal planlarda açıktır; anahtarları şirket sahibi ve yöneticileri oluşturur.

Önce videoyu izleAPI, MCP ve webhook · 30 sn
  1. 1

    API ve MCP sayfasını açın

    Panelde API ve MCP’yi açın. API anahtarları kartı mevcut anahtarlarınızı ve taban adresi (https://seviyorum.com/api/company/v1) gösterir. Bir anahtar onu oluşturan kişi adına çalışır; o kişi ekipten ayrılırsa ya da rolü değişirse anahtar durur. Sağ üstteki Belgeler ve OpenAPI tüm uç noktaları anlatır.

    API ve MCP sayfasında API anahtarları kartı: Claude Code adlı okuma anahtarı ve yeni anahtar formu vurgulanmış
  2. 2

    Bir anahtar oluşturun

    Yeni anahtar’a bir Ad yazın ve yetkiyi seçin: Okuma hiçbir şeyi değiştiremez; Okuma ve yazma ayrıca deneyimlere ve sorulara yanıt, ürün ve kupon yönetimi ve profil güncellemesi yapar. Anahtar oluştur’a basın: anahtar yalnızca bu kez gösterilir, hemen kopyalayıp güvenli bir yerde saklayın. Altındaki Deneyin örneğiyle ilk isteği gönderebilirsiniz.

    Anahtarınız hazır kutusu: gizlenmiş anahtar, Kopyala düğmesi ve curl ile Deneyin örneği vurgulanmış
  3. 3

    Yapay zekâ asistanınızı bağlayın (MCP)

    Yapay zekâ asistanları (MCP) kartında istemcinizi seçin. claude.ai, Claude Desktop ve ChatGPT’de özel bağlayıcı olarak https://seviyorum.com/mcp/hesap adresini ekleyip Seviyorum girişiyle şirketinizi seçersiniz; anahtar gerekmez. Claude Code, Cursor ve VS Code için kart hazır komutu ve yapılandırmayı verir. Asistan bir şey göndermeden önce taslağı size gösterir.

    MCP kartında Claude Code sekmesi seçili; OAuth ve API anahtarıyla bağlanma komutları vurgulanmış
  4. 4

    Webhook ekleyin

    Webhook kartına sisteminizin https adresini yazın ve almak istediğiniz Olaylar’ı seçin: yeni deneyim, üye sorusu, üye mesajı, asistanın ilettiği talep, yeni rozet ve plan değişikliği. Kaydet’ten sonra her olay imzalı bir POST isteği olarak gelir; başarısız teslimler 8 saate kadar yeniden denenir.

    Webhook kartında adres alanı doldurulmuş, altı olay seçili ve Kaydet düğmesi görünüyor; kart vurgulanmış
  5. 5

    Belgelere bakın

    seviyorum.com/api sayfası hızlı başlangıcı, kimlik doğrulamayı, tüm REST uç noktalarını, MCP ve OAuth bağlantısını ve webhook imzasının nasıl doğrulanacağını anlatır. Yapay zekâ araçları için aynı belgeler llms.txt olarak da yayında.

    Seviyorum API ve MCP belgeler sayfası: Hızlı başlangıç, OpenAPI, llms.txt bağlantıları ve REST API, MCP ve OAuth, Webhook kartları
API belgeleri

Sık sorulanlar

API ile üyelere mesaj gönderebilir miyiz?

Yalnızca var olan bir konuşmada yanıt verebilirsiniz. Yeni konuşma, kampanya, bildirim, hediye ve arama üyelere izinleri ölçüsünde ulaşır ve her zaman panelde bir kişinin tıklamasıyla başlar.

Anahtarımızı kaybettik, yeniden görebilir miyiz?

Hayır. Anahtarın yalnızca şifrelenmiş özeti saklanır ve bir kez gösterilir. Eski anahtarı İptal et ile kapatıp yenisini oluşturun.

İstek sınırı var mı?

Her anahtar ya da OAuth bağlantısı için dakikada 120 istek; anahtarsız herkese açık araçlar için IP başına dakikada 60 istek. Bir şirketin en fazla 10 etkin anahtarı olabilir.

Webhook isteğinin Seviyorum’dan geldiğini nasıl anlarız?

Her istekte Seviyorum-Signature başlığı vardır: zaman damgası ve gövdenin webhook gizli anahtarınızla (whsec_…) HMAC-SHA256 imzası. Doğrulama adımları webhook kartındaki İmza nasıl doğrulanır? bağlantısında.

Anahtarsız neler yapılabilir?

Herkese açık araçlar anahtar istemez: marka arama, marka profili ve deneyimleri, sıralamalar, kategoriler, fırsatlar ve skor kuralları. Kendi şirketinizin verileri için anahtar ya da OAuth bağlantısı gerekir.

Bunlar da işinize yarar

Tüm rehberler