CHAINHULK Developers
Website Workspace
Dokumentasi/Mengirim pesan

Mengirim pesan

Antrekan pesan sekali, lalu pantau hasilnya.

Antrekan balasan

curl -X POST \
  https://app.chainhulk.com/api/v1/workspaces/WORKSPACE_ID/conversations/CONVERSATION_ID/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: 18463df4-d675-43c5-b9c4-261f95f94705" \
  -H "Content-Type: application/json" \
  -d '{"content":"Terima kasih, kami bantu periksa."}'

202 berarti pesan dan pekerjaan pengiriman sudah tersimpan, bukan bukti pesan sudah terkirim. Permintaan identik dengan kunci yang sama mengembalikan pesan yang sama. Mengubah isi dengan kunci yang sama mengembalikan 409.

Status pengiriman

  • queued — menunggu pengiriman.
  • sending — percobaan pengiriman dimulai.
  • sent — provider mengonfirmasi pengiriman.
  • delivered atau read — receipt tersedia dari provider.
  • unknown — hasil pengiriman belum dapat dipastikan.
  • failed — permintaan ditolak atau tidak dapat dikirim.
  • cancelled — antrean dibatalkan sebelum pengiriman.

Hasil belum diketahui

Timeout dapat terjadi sesudah provider menerima pesan. Status unknown tidak otomatis dicoba ulang. Tinjau hasil dan tunggu receipt yang dapat merekonsiliasi pesan sebelum membuat pengiriman baru.

Membatalkan antrean

POST /api/v1/workspaces/{workspace_id}/messages/{message_id}/cancel

Pembatalan berhasil hanya jika belum ada percobaan yang sedang berlangsung, berhasil, atau belum diketahui hasilnya.