Tugasnya: satu tempat untuk mendaratnya setiap pesan pelanggan, dari aplikasi apa pun mereka menulis, dan satu panggilan yang menjawab mereka di sana. Lima langkah, masing-masing satu permintaan.
1. Buat akun kotak masuk
curl -X POST https://makehybrid.com/inbox/v1/account \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Sekali per organisasi. Memanggilnya lagi menjawab dengan akun yang sama, jadi aman dijalankan pada setiap rilis.
2. Tambahkan kanal
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…"}}'
Obrolan situs web menjawab dengan cuplikan kode yang ditempel sebelum </body>; cuplikan itu dimuat dari domain Anda sendiri. Instagram dan TikTok ditambahkan lewat tautan masuk, Facebook Messenger lewat tautan yang dibuka pengelola halaman, dan LINE, SMS, serta WhatsApp dengan kredensial milik platform itu sendiri — referensinya memuat masing-masing.
3. Terima pesan baru
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"]}'
Simpan secret yang dikembalikannya: setiap pengiriman ditandatangani dengannya di header x-mh-signature, dan pengulangan peristiwa yang sama itu normal.
4. Balas di tempat mereka menulis
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"}'
Balasan keluar lewat kanal percakapan itu sendiri. Tambahkan "private": true dan balasan itu menjadi catatan yang hanya dilihat tim Anda.
5. Tandai selesai
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"}'
Percakapan yang sudah selesai terbuka lagi dengan sendirinya saat pelanggan menulis.
Beberapa kanal hanya mengizinkan bisnis menulis lebih dulu lewat templat yang disetujui platform — WhatsApp di luar jendela 24 jamnya adalah yang paling umum. Menjawab selalu diizinkan; memulai adalah keputusan platform.
Pertanyaan yang sering diajukan
Bisakah tim saya menjawab tanpa menulis kode?
Bisa. Layar Kotak masuk di aplikasi yang terpasang menampilkan percakapan yang sama kepada setiap anggota yang masuk, lengkap dengan balasan, catatan pribadi, penugasan, label, dan notifikasi ponsel.
Bisakah agen AI menyusun draf balasan?
Bisa. Beri agen AI milik Anda sendiri agen kotak masuk di ruang proyek, atau hubungkan asisten Anda ke /inbox/mcp, lalu minta ia menyusun draf; seseorang di ruang itu mengatakan “kirim” sebelum apa pun dikirim.