> For the complete documentation index, see [llms.txt](https://docs.watzap.id/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.watzap.id/help/integrations/menambahkan-nomor-wa-untuk-api.md).

# Menambahkan Nomor WA untuk API

Hubungkan nomor WhatsApp ke tab API supaya bisa dipakai Rest API WatZap dan integrasi seperti Scalev, WooCommerce, OrderOnline, atau n8n.

**Nomor API** adalah nomor WhatsApp yang terhubung di tab **API** pada menu **WhatsApp**. Nomor inilah yang mengirim pesan otomatis dari Rest API WatZap dan dari aplikasi yang Kamu integrasikan, misalnya Scalev, WooCommerce, OrderOnline, atau n8n.

Caranya mirip dengan [menghubungkan nomor Broadcast](https://docs.watzap.id/help/connect-to-whatsapp/cara-connect-nomor-whatsapp.md): buat slot nomor baru, lalu scan QR Code dari WhatsApp di HP.

{% hint style="info" %}
Nomor di tab API hanya untuk API dan integrasi, tidak bisa dipakai untuk Broadcast. Bedanya dijelaskan di [Perbedaan Nomor Broadcast dan API](https://docs.watzap.id/help/connect-to-whatsapp/perbedaan-nomor-broadcast-dan-api.md).
{% endhint %}

## Sebelum mulai

1. **HP dengan WhatsApp aktif** untuk nomor yang akan dihubungkan (WhatsApp biasa atau WhatsApp Business), dengan koneksi internet yang stabil.
2. **Slot nomor API yang masih kosong.** Sisa slot terlihat di tab API, misalnya `1 of 3 slots`.

## Langkah menambahkan nomor API

{% stepper %}
{% step %}

### Buka menu WhatsApp

Di dashboard WatZap, klik menu **WhatsApp** di bagian **WA UNOFFICIAL** pada menu samping. Angka di sebelahnya (misalnya `5 of 10`) adalah jumlah nomor yang sudah terdaftar dari jatah nomor paket Kamu.

![Menu WA UNOFFICIAL → WhatsApp](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FEqlCZfM81qUw75P1oYW1%2Fapi-01-menu-whatsapp.png?alt=media)
{% endstep %}

{% step %}

### Pindah ke tab API

Halaman ini punya tiga tab: **Broadcast**, **API**, dan **Warm Up**. Klik tab **API**. Tabelnya berisi kolom **WhatsApp Number**, **Number Key**, **Connected at**, dan **Options**.

![Tab API di halaman nomor WhatsApp](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FWQurvcUcfjY1I2TflZR2%2Fapi-02-tab-api.png?alt=media)

{% hint style="info" %}
Bisa juga langsung membuka `https://app.watzap.id/manage-numbers?type=api`.
{% endhint %}
{% endstep %}

{% step %}

### Klik New Number

1. **Slot**: `1 of 3 slots` artinya 1 nomor API sudah dipakai dari 3 slot API paket Kamu.
2. **New Number**: klik untuk membuat slot nomor API baru.

![Sisa slot dan tombol New Number](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FCPfTfeSj5Cthfj54Syx2%2Fapi-03-new-number.png?alt=media)

Kalau slot sudah penuh, yang muncul adalah pesan **API Slot Limited** atau **You have reached the limit.** dengan tombol upgrade. Lihat bagian [Masalah umum](#masalah-umum) di bawah.
{% endstep %}

{% step %}

### Klik Generate QR Code

Jendela **Connect to WhatsApp** terbuka.

1. **Langkah di HP**: ringkasan cara scan yang akan Kamu lakukan di langkah berikutnya.
2. **Generate QR Code**: klik untuk menampilkan QR Code.

![Jendela Connect to WhatsApp dan tombol Generate QR Code](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FXr1ASclEYAvY9iPQrHVm%2Fapi-04-modal-connect.png?alt=media)

{% hint style="warning" %}
Menutup jendela ini (ikon **×**) sebelum scan akan membatalkan slot yang baru dibuat. Klik **New Number** lagi bila ingin mengulang.
{% endhint %}
{% endstep %}

{% step %}

### Scan QR Code dari HP

Di HP, buka **WhatsApp** → menu titik tiga di kanan atas (di iPhone: **Settings**) → **Linked Devices** (Perangkat tertaut) → **Link a Device** (Tautkan perangkat), lalu arahkan kamera ke QR Code di layar.

1. **QR Code** yang harus di-scan.
2. **Hitung mundur**: QR berlaku sekitar 60 detik (`Scan QR Code within ... seconds`).

![QR Code siap di-scan (QR pada contoh ini sengaja diburamkan)](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F6MqB8Pe6KF2OrL7Cismn%2Fapi-05-scan-qr.png?alt=media)

Kalau waktunya habis, muncul tombol **Re-Generate QR Code**. Klik untuk membuat QR baru.
{% endstep %}

{% step %}

### Tunggu notifikasi WhatsApp is Connected

Setelah scan berhasil, muncul notifikasi **WhatsApp is Connected**. Halaman dimuat ulang dan nomor tampil di tab API.

Baris nomor API berisi:

1. **Status**: **Online** berarti nomor terhubung dan siap mengirim. **Offline** berarti belum terhubung atau terputus.
2. **Number Key**: kunci nomor ini untuk Rest API. Klik ikon salin untuk menyalinnya.
3. **Options**: **Connect** untuk scan ulang nomor yang Offline (atau **Disconnect** bila Online), dan menu **⋮** untuk opsi lainnya.

![Baris nomor API: status, Number Key, dan Options](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F2551eINp3GvbQoJ7ub3w%2Fapi-06-baris-nomor-api.png?alt=media)
{% endstep %}
{% endstepper %}

## Setelah nomor terhubung

* **Rest API**: siapkan **Number Key** (kolom di atas) dan **API Key** akun Kamu. Panduannya: [Mendapatkan Number Key untuk API](https://docs.watzap.id/help/integrations/mendapatkan-number-key-untuk-api.md) dan [Mendapatkan API Key di Member Area](https://docs.watzap.id/help/integrations/mendapatkan-api-key-di-member-area.md).
* **Integrasi aplikasi**: nomor API yang Online otomatis muncul sebagai pilihan nomor pengirim, misalnya di **Assigned Number** pada [Integrasi dengan Scalev.id](https://docs.watzap.id/help/integrations/integrasi-dengan-scalev.id.md).
* **Menu ⋮** di baris nomor API berisi **Assign for Broadcast** (pindah ke tab Broadcast), **Assign for Warm Up**, **Send Test Message** (saat Online), dan **Delete Number**.

## Sudah punya nomor di tab Broadcast?

Nomor di tab **Broadcast** bisa dipindah ke API tanpa membuat slot baru. Buka tab **Broadcast**, klik **⋮** di baris nomornya, lalu pilih **Assign for API**.

![Menu ⋮ → Assign for API di tab Broadcast](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FKWrMHDY5rSALwQdEmz4v%2Fapi-07-assign-for-api.png?alt=media)

Kalau nomor itu sedang **Online**, muncul pesan **Please re-scan the number**: nomor akan diputus dulu, lalu Kamu perlu scan QR Code lagi. Klik **Re-scan QR Code** untuk melanjutkan.

## Masalah umum

<details>

<summary>QR Code tidak muncul atau tidak bisa di-scan</summary>

Klik **Generate QR Code** sekali lagi, atau **Re-Generate QR Code** bila QR sudah kedaluwarsa. Pastikan HP terhubung internet dan aplikasi WhatsApp sudah versi terbaru. Panduan lengkapnya: [Solusi Gagal Scan QR Code](https://docs.watzap.id/help/connect-to-whatsapp/solusi-gagal-scan-qr-code.md).

</details>

<details>

<summary>Muncul pesan "API Slot Limited" atau "You have reached the limit."</summary>

Slot nomor API atau total nomor WhatsApp di paket Kamu sudah habis. Klik tombol upgrade di pesan tersebut, atau kosongkan slot dengan menghapus nomor yang tidak dipakai. Lihat [Cara Disconnect dan Hapus Nomor WA](https://docs.watzap.id/help/connect-to-whatsapp/cara-disconnect-dan-hapus-nomor-wa.md).

</details>

<details>

<summary>Ada baris nomor 62999999999 berstatus Offline</summary>

Itu slot nomor yang sudah dibuat tapi belum berhasil di-scan. Klik **Connect** di baris tersebut untuk scan ulang, atau hapus lewat **⋮ → Delete Number**.

</details>

<details>

<summary>Nomor API tiba-tiba Offline</summary>

Koneksi WhatsApp di HP terputus, atau perangkat tertaut dihapus dari HP. Klik **Connect** di baris nomor tersebut, lalu scan QR Code lagi.

</details>
