REST & Webhook Specification v1.4

CariLeads API & Webhook Reference

Integrasikan sistem CRM, aplikasi kasir, atau alur kerja otomatisasi Anda secara langsung ke dalam engine WhatsApp Sender dan Google Maps Lead Scraper CariLeads.

Otentikasi & API Key

Semua permintaan API wajib menyertakan kunci otentikasi pada HTTP Header.

Anda dapat memperoleh API Key rahasia Anda pada halaman Dashboard Settings. Jangan pernah membagikan API Key Anda di repositori publik seperti GitHub.

Header: Authorization: Bearer YOUR_API_KEYBase URL: https://api.carileads.biz.id

Send WhatsApp Message

Kirimkan pesan teks atau media secara terprogram menggunakan nomor WhatsApp aktif Anda.

POST/v1/messages/send

Request Parameters (JSON Body)

Field	Type	Required	Description
phone	string	Yes	Nomor WhatsApp tujuan dengan kode negara (contoh: `628123456789`)
message	string	Yes	Isi pesan teks yang ingin dikirimkan. Mendukung formatting `bold` dan `_italic_`
delay_ms	number	No	Jeda waktu sebelum pesan dikirim (default: `2000` ms / 2 detik)

// Contoh cURL Request

curl -X POST https://api.carileads.biz.id/v1/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "6281234567890",
    "message": "Halo, ini pesan konfirmasi pesanan dari CariLeads!",
    "delay_ms": 3000
  }'

Scrape Google Maps API

Ekstrak data kontak bisnis, alamat, rating, dan nomor WhatsApp secara otomatis.

POST/v1/scraping/google-maps

// Response JSON Payload

{
  "success": true,
  "data": [
    {
      "title": "Klinik Aesthetic Glow Jakarta",
      "address": "Jl. Senopati No. 45, Kebayoran Baru, Jakarta Selatan",
      "phone": "+62 811-9876-5432",
      "is_whatsapp_valid": true,
      "rating": 4.9,
      "reviews_count": 218
    }
  ],
  "total_extracted": 50,
  "quota_remaining": 450
}