İş şu: hangi uygulamadan yazarsa yazsın her müşteri mesajının düştüğü tek bir yer ve onlara orada yanıt veren tek bir çağrı. Beş adım, her biri tek bir istek.
1. Gelen kutusu hesabını oluşturun
curl -X POST https://makehybrid.com/inbox/v1/account \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Kuruluş başına bir kez. Yeniden çağırmak aynı hesabı döndürür, bu yüzden her dağıtımda çalıştırmak güvenlidir.
2. Kanalları ekleyin
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Website","channel":{"type":"web_widget","website_url":"https://acme.com"}}'
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Telegram","channel":{"type":"telegram","bot_token":"123456:ABC…"}}'
Web sohbeti, </body> öncesine yapıştıracağınız kod parçasıyla yanıt verir; kendi alan adınızdan yüklenir. Instagram ve TikTok bir oturum açma bağlantısıyla, Facebook Messenger bir sayfanın yöneticisinin açtığı bir bağlantıyla, LINE, SMS ve WhatsApp ise platformun kendi kimlik bilgileriyle eklenir — başvuru belgesi her birini anlatır.
3. Yeni mesajları alın
curl -X POST https://makehybrid.com/inbox/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"url":"https://acme.com/hooks/inbox","events":["inbox.message_created"]}'
Döndürdüğü sırrı saklayın: her teslimat onunla x-mh-signature başlığında imzalanır ve aynı olayın tekrar gelmesi normaldir.
4. Yazdıkları yerden yanıtlayın
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"content":"Thanks, we are on it.","message_type":"outgoing"}'
Yanıt, sohbetin kendi kanalından çıkar. "private": true ekleyin, yalnızca ekibinizin gördüğü bir not olur.
5. Çözün
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/toggle_status \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"status":"resolved"}'
Çözülmüş bir sohbet, müşteri yazınca kendiliğinden yeniden açılır.
Bazı kanallar, bir işletmenin ilk yazmasına yalnızca platformun onayladığı bir şablonla izin verir — 24 saatlik pencerenin dışındaki WhatsApp en yaygın örnektir. Yanıtlamaya her zaman izin vardır; başlatmak platformun kararıdır.
İnsanların sorduğu sorular
Ekibim kod yazmadan yanıt verebilir mi?
Evet. Kurulu uygulamanın Gelen kutusu ekranı, oturum açmış her üyeye aynı sohbetleri yanıtlar, özel notlar, atama, etiketler ve telefon bildirimleriyle gösterir.
Bir yapay zekâ ajanı yanıtları taslak olarak yazabilir mi?
Evet. Bir proje odasında kendi yapay zekâ ajanınıza gelen kutusu ajanını verin ya da asistanınızı /inbox/mcp adresine bağlayın ve taslak yazmasını isteyin; bir şey gönderilmeden önce odadaki bir kişi “tamam” der.