Integrasi via Webhook

Hubungkan EverSales dengan Sistem Anda

Terakhir diperbarui: 23 Oktober 2026

Cara Kerja Integrasi

EverSales mendukung dua jenis integrasi webhook:

Inbound Webhook (Knowledge Base Dinamis): Endpoint di sistem Anda yang dipanggil AI Agent setiap percakapan untuk mengambil data terkini — harga, stok, info produk, status pesanan.

Outbound Webhook (Event Notifier): AI Agent secara otomatis mengirim notifikasi ke sistem Anda (CRM, sistem tiket, dll) saat event penting terdeteksi di percakapan.

Inbound Webhook (Knowledge Base Dinamis)

Jadikan sistem internal Anda sebagai otak tambahan untuk AI Agent. Setiap kali bot menjawab pesan pelanggan, EverSales mengambil isi endpoint Anda lalu memberikannya ke AI sebagai data terkini — harga produk, stok, jadwal, dll. Endpoint tidak menerima pertanyaan pelanggan; kembalikan data yang relevan untuk semua pertanyaan.

Request yang dikirim EverSales:

GET https://sistem-anda.com/eversales-kb
Accept: application/json, text/plain, */*

(tanpa body dan tanpa parameter — timeout 5 detik)

Respons yang diharapkan dari sistem Anda (maks 5 detik, JSON atau teks biasa, maks ±4.000 karakter dipakai):

{
  "stok": { "Nike Air 42": 3, "Nike Air 43": 0 },
  "harga": { "Nike Air": 1200000 },
  "catatan": "Gudang utama buka 09.00–17.00"
}

// Jika endpoint gagal/timeout, AI memakai isi terakhir yang berhasil diambil.

Outbound Webhook — Event yang Dikirim

AI Agent secara otomatis mengirim POST ke outbound webhook Anda saat event berikut terdeteksi. Daftarkan URL di Dashboard → Log Webhook.

Events Sales

lead.detected — Calon pembeli baru teridentifikasi dari percakapan

inquiry.received — Percakapan sales baru dimulai (pertama kali kontak)

order.intent — Pelanggan menunjukkan niat beli (kata kunci pembelian + sentimen positif)

lead_update — Status lead berubah (contacted, qualified, proposal)

deal_won — Lead ditandai won

deal_lost — Lead ditandai lost

sales.followup.needed — Percakapan sales tidak aktif (idle) dan perlu ditindaklanjuti

Events Support

complaint.received — Sentimen negatif pertama terdeteksi di percakapan support

feedback.positive — Pelanggan menunjukkan kepuasan (sentimen berubah positif)

support_escalation — AI mengoper ke agen manusia

support_resolved — Tiket support diselesaikan secara manual

resolved.auto — Percakapan support ditutup otomatis tanpa eskalasi

support.followup.needed — Percakapan support tidak aktif (idle) dan perlu ditindaklanjuti

Format Payload

Setiap outbound webhook dikirim sebagai HTTP POST dengan body JSON terstruktur:

{
  "event": "lead.detected",
  "timestamp": "2026-04-14T10:30:00Z",
  "business": "Nama Bisnis Anda",
  "data": {
    "leadId": "auto",
    "phone": "628111234567",
    "name": "Budi Santoso",
    "source": "whatsapp",
    "status": "new"
  }
}

Header Webhook

Setiap request webhook menyertakan header untuk identifikasi dan audit:

Request Headers

Content-Type: application/json

User-Agent: EverSales-Webhook/1.0

X-Event-Type — Nama event yang dikirim (contoh: lead.detected)

Contoh Verifikasi

// Cek event type di server Anda
app.post('/webhook/eversales', (req, res) => {
  const event = req.headers['x-event-type'];
  const { data } = req.body;

  if (event === 'lead.detected') {
    // Tambahkan lead ke CRM Anda
    crm.createLead(data);
  }
  res.status(200).send('OK');
});

Cara Mendaftarkan Webhook

Ada dua jenis webhook yang perlu didaftarkan di tempat berbeda:

1

Inbound Webhook (data masuk): Dashboard → Knowledge Base → Tambah Inbound Webhook

2

Outbound Webhook (event keluar): Dashboard → Settings → Webhook Logs → atur URL endpoint

3

Masukkan nama dan URL endpoint Anda

4

Simpan — AI Agent mulai mengirim event ke endpoint tersebut

5

Pantau delivery di halaman Webhook Logs (tersedia di semua paket)

Pengiriman & Log

Setiap event dikirim satu kali. Pastikan endpoint Anda cepat merespons, dan pantau kegagalannya di Webhook Logs.

Satu kali pengiriman per event — belum ada pengiriman ulang otomatis

Timeout per request: 10 detik

Status tiap pengiriman (sukses/gagal/timeout) beserta kode respons tercatat di Webhook Logs

Log pengiriman tersimpan 60 hari

Butuh Bantuan?

Hubungi tim kami jika Anda mengalami kendala dalam integrasi.

Email: [email protected]

Subject: [Integration] nama_kendala_Anda