Integrasi via Webhook

Hubungkan EverSales dengan Sistem Anda

Terakhir diperbarui: 14 April 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. AI akan memanggil endpoint Anda setiap percakapan untuk mengambil data real-time — harga produk, cek stok, status pesanan, dll.

Request yang dikirim AI:

{
  "action": "kb_query",
  "topic": "sales",
  "query": "Cek stok sepatu nike ukuran 42",
  "whatsapp": "+6281234567890",
  "metadata": {
     "businessId": "biz_xxx"
  }
}

Respons yang diharapkan dari sistem Anda (maks 5 detik):

{
  "success": true,
  "data": "Stok sepatu Nike Air ukuran 42 sisa 3 pasang di gudang utama. Harga Rp1.200.000." 
}

Outbound Webhook — Event yang Dikirim

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

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 — Followup manual dikirim ke percakapan sales

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 — Followup manual dikirim ke percakapan support

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)

Retry & Reliability

EverSales menjamin delivery webhook dengan mekanisme retry otomatis.

Retry otomatis hingga 3x jika endpoint tidak merespons

Interval retry: 1 menit, 5 menit, 15 menit

Timeout per request: 10 detik

Log pengiriman tersimpan untuk 7 hari

Endpoint dianggap tidak aktif setelah 10 kali gagal berturut-turut

Butuh Bantuan?

Hubungi tim kami jika Anda mengalami kendala dalam integrasi.

Email: [email protected]

Subject: [Integration] nama_kendala_Anda