SuperMailbox · panduan integrasi CRM

Hubungkan SuperMailbox ke CRM Anda

Setiap pengguna CRM mendapat koneksi OAuth yang aman ke kotak surat pilihannya. CRM dapat menemukan percakapan pelanggan, menampilkan konteks email yang telah diverifikasi, serta menyiapkan atau mengirim balasan melalui server MCP SuperMailbox.

Cara kerja koneksi

01

Hubungkan kotak surat

Pengguna menghubungkan Gmail, Outlook, atau kotak surat lain yang didukung ke SuperMailbox. Login penyedia email terpisah dari otorisasi CRM.

02

Otorisasi CRM

CRM membuka OAuth SuperMailbox di browser. Pengguna masuk, meninjau klien dan cakupan yang diminta, lalu menyetujui koneksi.

03

Gunakan alat MCP

CRM memanggil server MCP jarak jauh dengan token akses pengguna. Pengguna memilih kotak surat yang diizinkan dan CRM bekerja sesuai izin tersebut.

Pengaturan koneksi

Gunakan klien atau SDK MCP yang mendukung Streamable HTTP jarak jauh dan penemuan OAuth. Klien harus menangani otorisasi browser dan mengirim token akses bersama permintaan MCP.

URL server MCP
https://api.supermailbox.app/mcp
Otorisasi
OAuth 2.0 · Authorization Code · PKCE S256
Cakupan izin
openid email mail.accounts.read mail.messages.read mail.send

Minta hanya akses yang diperlukan alur kerja Anda. CRM yang membaca korespondensi pelanggan dan mengirim balasan dapat meminta:

Temukan dan verifikasi percakapan

  • Panggil list_mail_accounts agar pengguna memilih kotak surat yang tersedia. canSend hanyalah petunjuk; izin mengirim diperiksa kembali saat tindakan dijalankan.
  • Cari kandidat melalui search_emails atau search_threads_by_recipient. Pencarian penerima hanya mengembalikan metadata; ambil dan verifikasi thread sebelum mengaitkannya ke catatan CRM.
  • Hasil pencarian dapat dibatasi atau tidak lengkap. Perhatikan coverage dan completeness; hasil parsial kosong tidak membuktikan bahwa pesan tidak ada.
  • ID kotak surat, pesan, dan thread bersifat buram serta terikat pada izin pengguna saat ini. Cari dan validasi ID dengan koneksi pengguna yang sama.

Siapkan dan kirim balasan dengan aman

  • Sebelum pengguna mengonfirmasi, tampilkan kotak surat, penerima, dan isi balasan yang dipilih di CRM.
  • send_email dan reply_to_email mengembalikan operasi yang mengantre. Periksa get_mail_action dengan ID operasi yang sama dan izin yang diperlukan hingga status akhir.
  • Tanda terima antrean bukan bukti email terkirim. Jika status pengiriman tidak pasti, periksa operasi yang sama; jangan mengulang otomatis dengan ID baru.

Keamanan dan kontrol akses

  • Gunakan alur OAuth authorization-code dengan PKCE S256 melalui penemuan yang didukung klien MCP. Simpan rahasia dan token di server; jangan paparkan ke kode browser atau log.
  • Buat koneksi terpisah untuk setiap pengguna CRM. Jangan bagikan token atau ID kotak surat buram antar pengguna.
  • Minta mail.send hanya jika CRM perlu mengirim email. Pengguna dapat mencabut koneksi CRM di pengaturan aplikasi terhubung SuperMailbox.