· 2 min read

Deteksi Nomor WhatsApp — Verifikasi Massal melalui Platform atau API | CheckNumber.AI

Panduan langkah demi langkah untuk memeriksa registrasi nomor WhatsApp via API. Termasuk contoh curl, Python, Node.js. Pemrosesan batch massal, $0,8 / 10.000 pemeriksaan.

Panduan langkah demi langkah untuk memeriksa registrasi nomor WhatsApp via API. Termasuk contoh curl, Python, Node.js. Pemrosesan batch massal, $0,8 / 10.000 pemeriksaan.

API Deteksi Nomor WhatsApp — Panduan Integrasi Langkah demi Langkah

Memverifikasi registrasi WhatsApp dalam skala besar sangat penting untuk pembersihan daftar pemasaran, deteksi penipuan, kualifikasi lead, dan validasi data CRM. Panduan ini memandu Anda mengintegrasikan API verifikasi massal WhatsApp dari CheckNumber.AI, dengan contoh kode dalam curl, Python, dan Node.js.

Cara Kerja

Pemeriksaan produksi berjalan sebagai tugas batch: unggah file, lakukan polling status, unduh hasil — bukan satu panggilan HTTP sinkron per nomor telepon. Pendekatan ini menangani verifikasi berskala besar secara efisien.

Referensi resmi: WhatsApp Checker — bulk registration.

Kirim tugas

POST https://api.checknumber.ai/v1/tasks

ParameterDeskripsi
file.txt / .csv, satu nomor E.164 per baris
task_typews — pemeriksaan registrasi WhatsApp

Contoh — curl:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="ws"'

Contoh — Python:

import requests

url = "https://api.checknumber.ai/v1/tasks"
headers = {"X-API-Key": "YOUR_API_KEY"}

with open("numbers.txt", "rb") as f:
    files = {"file": f, "task_type": (None, "ws")}
    response = requests.post(url, headers=headers, files=files)
    
print(response.json())
# Output: {"task_id": "xyz123", "status": "pending", "total": 1000}

Contoh — Node.js:

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('numbers.txt'));
form.append('task_type', 'ws');

axios.post('https://api.checknumber.ai/v1/tasks', form, {
  headers: {
    ...form.getHeaders(),
    'X-API-Key': 'YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.message));

Polling status

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

Kolom hasil

FieldDeskripsi
NumberNomor telepon E.164
whatsappyes / no — terdaftar di WhatsApp

Error Umum & Pemecahan Masalah

ErrorPenyebabSolusi
400 Bad RequestKunci API tidak ada atau format file tidak validPastikan header X-API-Key disertakan; gunakan format E.164 (mis. +41798284651)
401 UnauthorizedKunci API tidak validPeriksa kunci API Anda di dasbor
413 Payload Too LargeFile melebihi batas ukuranBagi menjadi beberapa batch; maks. 50MB per unggahan
500 Server ErrorMasalah server sementaraCoba lagi dalam 30 detik

FAQ

T: Berapa lama verifikasi massal berlangsung? J: Biasanya 5-30 detik untuk file hingga 100.000 nomor, tergantung beban antrean.

T: Berapa ukuran file minimum dan maksimum? J: Minimum 1 nomor, maksimum 50MB (biasanya ~5 juta nomor dalam format CSV).

T: Apakah kredit hanya dipotong untuk pemeriksaan yang berhasil? J: Ya. Hanya hasil yang berhasil diverifikasi yang memakai kredit. Baris yang gagal tidak dikenai biaya.

Langkah Berikutnya

Catatan integrasi

  1. Satu nomor per baris; sertakan kode negara dalam format E.164.
  2. Lakukan polling hingga status bernilai exported, lalu gunakan result_url.
  3. Lihat dokumentasi resmi.
  4. Harga: halaman harga.