Daftar dan hubungi dukungan untuk mendapatkan 100 pemeriksaan gratis.Daftar gratis

Aktivitas Nomor

Dapatkan sinyal aktivitas tiap nomor melalui tugas berkas asinkron. Gabungkan hasil true/false dengan catatan interaksi Anda untuk meninjau kelompok audiens dan prioritas tindak lanjut.

Produk ini hanya tersedia sebagai tugas berkas asinkron. Pencarian operator waktu nyata tidak mengembalikan sinyal validitas atau aktivitas.

Dua langkah: kirim file, lalu periksa tugas

Pengiriman langsung mengembalikan ID tugas; periksa tugas dengan ID tersebut dan, setelah berhasil, respons membawa tautan unduhan file hasil. Setiap permintaan ditampilkan bersama responsnya.

1. Kirim file

ID tugas langsung dikembalikan dengan preparing bernilai true selama file disiapkan di latar belakang: baris tidak valid, duplikat, dan — untuk tugas nomor — nomor tanpa kode negara atau dari negara lain dihapus dan tidak ditagihkan. Saldo dicadangkan untuk baris yang dikirim dan diselesaikan saat tugas selesai; selisihnya dikembalikan.

Permintaan cURLPOST /api/v1/bulk-tasks
curl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=number_activity_batch \
  -F country=US \
  -F [email protected]
Respons: tugas dibuat200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "number_activity_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 509,
    "total": 509,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

2. Periksa tugas

Lakukan polling berdasarkan ID tugas. Setelah persiapan selesai, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, dengan total adalah jumlah yang diperiksa dan ditagihkan. Respons yang berhasil membawa jumlah keberhasilan dan kegagalan serta tautan unduhan file hasil; tugas yang ditolak selama persiapan berstatus failed dengan reason_detail dan dikembalikan sepenuhnya.

Permintaan cURLGET /api/v1/bulk-tasks/{id}
curl "https://api.carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Respons: tugas selesai200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "number_activity_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 509,
    "total": 500,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 6,
    "preparing": false,
    "success_cnt": 495,
    "failure_cnt": 5,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Apa yang terjadi pada tugas massal

Massal bukan sekadar real-time dalam skala besar — kirim sekali, berjalan di latar belakang, ambil kemudian. Anda tidak perlu membiarkan halaman tetap terbuka; status tugas dan hasilnya tetap tersimpan di dasbor Anda.

  1. 01Unggah file

    File .txt atau .csv dengan satu nomor per baris. File langsung dialirkan; tidak ada yang ditulis ke disk.

  2. 02Pemeriksaan awal dan pencadangan

    Masalah yang jelas (file kosong, format salah, baris terlalu sedikit) ditolak saat diunggah. Saldo kemudian dicadangkan dan file disiapkan di latar belakang: baris duplikat dan tidak valid dihapus dan aturan negara diperiksa. File yang gagal pada tahap itu berakhir sebagai tugas gagal dan dikembalikan sepenuhnya; jika tidak, hanya baris yang tersisa yang diperiksa, dan tugas diselesaikan tagihannya saat selesai.

  3. 03Berjalan di latar belakang

    Tugas berjalan dengan sendirinya — Anda boleh menutup halaman. Kegagalan langsung dilaporkan dan dikembalikan sepenuhnya.

  4. 04Unduh hasilnya

    Ambil file dari halaman pemeriksaan massal. Anda hanya membayar untuk nomor yang benar-benar mengembalikan hasil; selisihnya dikembalikan.

Kolom dalam file hasil

Unduhan berupa satu file CSV dengan tabel hasil lengkap.

Kolom file hasil

  • identifier · 12345678900 — Nomor yang dikirim dalam bentuk angka polos dengan kode negara, tanpa tanda plus atau spasi (mis. 12345678900), digunakan untuk menuliskan hasil aktivitas kembali ke daftar, data pelanggan, atau prospek. Kolom ini hanya untuk pencocokan dan penelusuran; tidak mencakup waktu aktivitas, frekuensi, atau detail interaksi.
  • activated · true — Keputusan aktivitas layanan ini: true berarti cocok, false berarti negatif yang tegas. Tidak ada tanggal, jumlah, atau rentang waktu aktivitas. Tafsirkan bersama catatan interaksi Anda; bukan prediksi respons.

Kapan menggunakan produk ini

  • Segmentasi berbasis aktivitas

    Tuliskan sinyal yang dikembalikan ke dalam tag audiens dan tinjau bersama status masuk, pembelian, atau persetujuan terbaru untuk membuat grup yang siap ditinjau untuk tindak lanjut.

    Cocokkan identifier dengan catatan asli dan simpan sumbernya untuk tinjauan manual.

    Kunci pencocokan: identifier

  • Reaktivasi

    Sebelum merencanakan reaktivasi, gunakan sinyal ini dan catatan interaksi yang sudah Anda miliki untuk menetapkan prioritas peninjauan; sinyal yang hilang tidak berarti seseorang tidak akan pernah merespons.

    Pisahkan true, false, dan hasil kosong; simpan hasil kosong dalam antrean peninjauan.

    Kolom pengelompokan: activated

  • Perencanaan audiens

    Pisahkan daftar berdasarkan sinyal, wilayah, atau tahap pelanggan sebelum menetapkan konten, frekuensi, dan ritme kontak yang berbeda untuk setiap grup, lalu terus ukur hasil bisnis Anda sendiri.

    Simpan hasil dengan tanggal tugas yang dicatat tim. Kirim tugas baru jika perlu diperbarui.

    Kolom pembaruan: identifier · activated

Apa itu Pemeriksaan aktivitas massal?

Unggah daftar nomor dari satu negara lalu unduh kolom identifier dan activated setelah selesai. Sinyal ini membantu pengelompokan, tetapi tidak menyediakan jendela pengamatan, tanggal aktif terakhir, atau jumlah aktivitas. Hasil negatif saja tidak membuktikan pelanggan tidak aktif.

Batasan produk ini

  • Baca activated sesuai produk yang dipilih: validitas/aktivasi atau aktivitas. Hasil tidak mencakup tanggal atau frekuensi aktivitas.
  • Hasil tidak membuktikan identitas atau persetujuan, dan tidak menjamin panggilan tersambung atau pesan terkirim.
  • Hasil tidak diperbarui secara otomatis. Kirim tugas baru jika Anda memerlukan pemeriksaan ulang.

Tentang Pemeriksaan aktivitas

Apa arti true, false, dan hasil kosong?

True adalah kecocokan pada pemeriksaan ini dan false adalah negatif yang tegas. Keduanya merupakan keputusan; false bukan kegagalan eksekusi atau baris gratis. Tangani hasil kosong, tidak dapat ditentukan, dan gagal secara terpisah menurut statistik tugas dan penyelesaian biaya; jangan isi sebagai false.

Apakah ini menunjukkan aktivitas beberapa hari terakhir atau menjamin pengiriman?

Tidak. Tidak ada jendela pengamatan, tanggal aktif terakhir, frekuensi, atau riwayat interaksi, dan tidak ada jaminan panggilan atau pesan tersampaikan. Gunakan dengan data bisnis dan izin menghubungi Anda.

Apakah pemeriksaan ini tersedia secara waktu nyata?

Produk ini hanya tersedia sebagai tugas berkas asinkron. Pencarian operator waktu nyata tidak mengembalikan sinyal validitas atau aktivitas.

Apa yang terjadi pada nomor yang tidak valid dalam file?

Pemeriksaan awal membuang baris yang formatnya salah, sehingga tidak pernah masuk ke jumlah yang ditagihkan. Dari nomor yang tersisa, nomor yang tidak dapat diselesaikan oleh layanan hulu juga tidak ditagihkan. Anda hanya membayar untuk nomor yang benar-benar mengembalikan hasil.

Berapa lama sebuah tugas berlangsung?

Tergantung pada jumlah nomor dan produknya. Anda dapat menutup halaman setelah mengirim; tugas berjalan di latar belakang dan hasilnya menunggu Anda di halaman pemeriksaan massal.

Apakah saya mendapatkan pengembalian dana jika gagal?

Ya. Tugas yang gagal dikembalikan sepenuhnya. Jika tugas berhasil tetapi sebagian nomor tidak mengembalikan apa pun, bagian tersebut dikembalikan secara otomatis. Selisih antara jumlah yang dicadangkan dan yang benar-benar ditagihkan selalu dikembalikan.

Produk massal lainnya

Buat akun untuk mengirim tugas massal

Pemeriksaan massal dan real-time menggunakan saldo yang sama — tidak ada yang perlu diaktifkan tambahan. Daftar dan unggah file pertama Anda di halaman pemeriksaan massal.