Gelen kutusundaki konuşmaları filtreleme, /inbox/v1/conversations/filter üzerinde bir POST ve MakeHybrid Inbox API içinde yer alır: WhatsApp, Instagram, Facebook, TikTok, Telegram, LINE, e-posta, SMS ve web sitenizdeki sohbet için tek bir gelen kutusu. 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 organizasyonunuzun kendi gelen kutusu hesabına ulaşır.
Bir gelen kutusu, ona eklediğiniz her kanalı barındırır; bu yüzden yanıt, müşterinin yazdığı kanala — WhatsApp, Instagram, e-posta ya da başka biri — aynı çağrıyla geri gider.
İstek
curl -X POST "https://makehybrid.com/inbox/v1/conversations/filter" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
Ç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/inbox/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 “Gelen kutusundaki konuşmaları filtreleme” 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 bugünkü açık konuşmaları tüm kanallardan listele ve en eskisine bir yanıt taslağı hazırla.
İnsanların sorduğu sorular
Bir yapay zekâ ajanı benim için “Gelen kutusundaki konuşmaları filtreleme” 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.
Bir yapay zekâ ajanı bunu yapmadan önce bir kişi onaylayabilir mi?
Yapay zekâ ajanının talimatlarına yazın: göndermek üzere olduğu şeyi söylesin ve odadaki bir kişinin “devam” demesini beklesin. Bir oda her yanıtı içindeki herkese gösterir; bu yüzden sözler, dışarıdaki kimseye ulaşmadan önce görülü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.