Postback pesanan

Saat pelanggan membuat pesanan di situs Anda, minta server Anda mengirimkannya ke SealReply. Pesanan yang dibuat dalam 30 hari setelah chat dengan pengunjung yang sama dikaitkan ke percakapan terakhir pengunjung tersebut:

• Kartu Tindak lanjut di kartu pelanggan menampilkan semua pesanan pelanggan ini; yang tanpa chat dalam 30 hari sebelumnya ditandai "Tanpa chat".
• Laporan → Hasil mendapat kartu "Memesan setelah chat (dari situs Anda)", berisi jumlah pesanan dan nominal per mata uang.

Angka ini dihitung terpisah dari transaksi yang ditandai berhasil oleh tim Anda. Angka ini menunjukkan bahwa pengunjung memesan setelah chat, bukan bahwa chat tersebut yang mendatangkan pesanan.

Sebelum memulai

1. Di halaman Developer pada konsol, buat kunci API dengan scope conversations:write (lihat Autentikasi dan batasan). Simpan kunci tersebut di server Anda.
2. Salin ID situs di bagian bawah kartu Verifikasi identitas pengunjung pada halaman situs Anda di Situs.
3. Pilih cara mengenali pengunjung:
   • external_id: ID pengguna milik situs Anda sendiri. Ini memerlukan verifikasi identitas yang sudah diaktifkan, dengan ID yang sama dikirim ke widget. Disarankan.
   • visitor_id: ID pengunjung SealReply, dari webhook atau API percakapan.

Tamu yang memesan tanpa masuk tidak bisa dikenali. Pesanan mereka tetap disimpan, tetapi tidak dihitung sebagai pesanan setelah chat.

Mengirim pesanan

POST https://api.sealreply.com/v1/site-orders
Authorization: Bearer sr_live_…
Content-Type: application/json

{
  "site_id": "0192f000-0000-7000-8000-000000000201",
  "order_id": "A-1001",
  "amount": "59.90",
  "currency": "USD",
  "placed_at": "2026-11-04T09:30:00Z",
  "external_id": "42"
}

Field	Arti
site_id	ID situs
order_id	Nomor pesanan Anda, unik di situs tersebut, maksimal 100 karakter
amount	Nominal dalam bentuk string, maksimal dua desimal, misalnya "59.90"
currency	Kode mata uang tiga huruf, misalnya USD atau EUR
placed_at	Waktu pesanan dibuat (opsional); jika tidak diisi, dipakai waktu sekarang, dan paling jauh satu hari ke depan
external_id atau visitor_id	Salah satunya, lihat di atas

Pesanan baru mengembalikan 201. Mengirim nomor pesanan yang sama lagi mengembalikan 200 dan memperbaruinya (misalnya nominalnya berubah); pesanan tidak pernah dihitung dua kali. conversation_id dalam respons adalah percakapan yang dikaitkan dengan pesanan tersebut, atau null dengan from_chat bernilai false jika tidak ada.

Menarik kembali pesanan

Saat pesanan dibatalkan atau di-refund penuh, tarik kembali pesanan tersebut dan laporan berhenti menghitungnya:

DELETE https://api.sealreply.com/v1/site-orders/A-1001?site_id=0192f000-0000-7000-8000-000000000201
Authorization: Bearer sr_live_…

Nomor pesanan yang tidak dikenal mengembalikan 404.

Catatan

• Jika percakapannya dihapus belakangan (secara manual, atau karena melewati masa penyimpanan), pesanannya tetap dihitung di laporan.
• Percakapan uji tidak pernah dicocokkan.
• Maksimal 5.000 request per jam per ruang kerja, untuk pengiriman dan penarikan kembali digabung.
• Semua field tercantum di Referensi API.