Bir web sitesi ziyaretçisinin mesajlarını okuma, /webchat/v1/conversations/{id}/messages üzerinde bir GET ve MakeHybrid Website chat API içinde yer alır: organizasyonunuzun web sitelerindeki kendi sohbeti; ekibiniz ya da yapay zekâ ajanlarınız yanıtlar. Her istek kendi anahtarınızı bir X-API-KEY başlığında taşır — LinkedIn API’sinde kullandığınız anahtarın aynısı — ve yalnızca kendi sohbetlerinize ulaşır.
Sohbet size aittir ve başka bir gelen kutusu hizmeti tarafından değil, bizim tarafımızdan tutulur: bir ziyaretçinin konuşmasına yalnızca anahtarınızla ulaşılır ve ziyaretçilere yanıt veren bir yapay zekâ ajanı bunu hiçbir araç kullanmadan yapar.
İstek
curl -X GET "https://makehybrid.com/webchat/v1/conversations/$ID/messages" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Yola ne giriyor
- id — bu ailedeki daha önceki bir çağrının döndürdüğü bir id.
Çalışmadığında ne dönüyor
- 401 — anahtar yok, yanlış ya da iptal edilmiş.
- 402 — plan ödenmemiş. Deneme bitince MakeHybrid API planı bunu döner.
- 404 — ya o şey orada değil ya da organizasyonunuza ait değil. İkisi bilerek aynı yanıtı verir, böylece id’ler yoklanamaz.
- 429 — çok fazla istek ya da platform bizden yavaşlamamızı istiyor. Yeniden denemeden önce biraz bekleyin.
- 502 veya 503 — platform az önce yanıt vermedi. Biraz sonra yeniden deneyin.
Her hata aynı biçimde JSON: {"type":"errors/<code>","status":<n>,"detail":"..."} — yani tek bir işleyici hepsini kapsar ve detail bir insana gösterilmek üzere yazılmıştır.
Bunun yerine bir asistana sorun
Bu işlem aynı zamanda bir MCP aracı. https://makehybrid.com/webchat/mcp/<your API key> adresini Claude’a, ChatGPT’ye ya da MCP konuşan herhangi bir asistana yapıştırın ve ne istediğinizi gündelik sözcüklerle söyleyin — asistan çağrıyı seçer, id’leri doldurur ve yanıtı size okur. https://makehybrid.com/mcp/<your API key> adresindeki hepsi bir arada ajanda da bu araç var; LinkedIn API’sinin ve diğer tüm kanalların yanı sıra.
Proje odasında
Proje odasında, kendi yapay zekâ ajanınız için “Kullanabilir” altında bu API’nin ajanını işaretleyin; ajan, konuşma gerektirdikçe “Bir web sitesi ziyaretçisinin mesajlarını okuma” işlemini bir araç olarak çağırır. Odadaki herkes neyi sorduğunu ve ne geldiğini görür. Gündelik sözcüklerle isteyin; burada ajanın adı @scout:
- @scout henüz kimsenin yanıtlamadığı web sohbeti konuşmalarını listele ve her biri için kontrol edebileceğim bir yanıt taslağı hazırla.
İnsanların sorduğu sorular
Bir yapay zekâ ajanı benim için “Bir web sitesi ziyaretçisinin mesajlarını okuma” işlemini çağırabilir mi?
Evet. MCP konuşan her asistan, yukarıdaki adres üzerinden çağırabilir; bu API’nin ajanı işaretli bir proje odasındaki kendi yapay zekâ ajanınız da. Bir odanın yerleşik ajanları çağıramaz: onlar tavsiye verir ve anahtarınız onlarda değildir.
Oda dışında, kendi kodumdan da çalışır mı?
Evet. Yukarıdaki istek, bir yapay zekâ ajanının aracının çağırdığı işlemin aynısıdır; yanıt da hatalar da aynıdır ve hangi yoldan girerseniz girin anahtarınız aynı kanallara ulaşır.
Kendi markam altındaki bir odada da çalışır mı?
Evet. Beyaz etiketli bir adreste API, başvuru belgesi ve yapay zekâ ajanı ürününüzün adını taşır ve aynı kanallara aynı kurallarla ulaşır.
Hangi planda
MakeHybrid API planına dahildir; LinkedIn API’siyle aynı anahtar kullanılır: koltuk başına ayda 9 $, on koltuktan sonra 7 $ ve binden sonra 5 $. En çok sahip olduğunuz türden kaç tane varsa o kadar koltuğa ihtiyacınız var — LinkedIn hesapları, WhatsApp numaraları, X hesapları ya da gelen kutusu hesapları — ve 30 günlük deneme bir koltuğu kapsar.