> 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/mendapatkan-number-key-untuk-api.md).

# Mendapatkan Number Key untuk API

Number Key adalah kunci tiap nomor di tab API. Lihat dan salin Number Key di menu WhatsApp, lalu pakai bersama API Key untuk Rest API WatZap.

**Number Key** adalah kunci unik milik setiap nomor WhatsApp di tab **API**. Saat memanggil Rest API WatZap, Number Key menentukan nomor mana yang mengirim pesan. Pasangannya adalah **API Key**, yaitu kunci akun Kamu.

{% hint style="info" %}
Number Key hanya ditampilkan dan dipakai untuk nomor di tab **API**. Nomor di tab **Broadcast** dan **Warm Up** tidak bisa dipakai untuk Rest API. Belum punya nomor API? Ikuti [Menambahkan Nomor WA untuk API](https://docs.watzap.id/help/integrations/menambahkan-nomor-wa-untuk-api.md).
{% endhint %}

## Langkah melihat Number Key

{% stepper %}
{% step %}

### Buka menu WhatsApp

Di dashboard WatZap, klik menu **WhatsApp** di bagian **WA UNOFFICIAL** pada menu samping.

![Menu WA UNOFFICIAL → WhatsApp](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FtIFNLtWQQgfjSPGGsc9g%2FB6-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**.

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

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

{% step %}

### Salin Number Key

1. **Number Key**: kolom kedua tabel di tab API. Kolom ini hanya muncul di tab API.
2. **Kode Number Key** nomor tersebut. Klik ikon salin di sebelahnya. Ikon berubah menjadi tanda centang dan muncul keterangan **Copied**, artinya Number Key sudah tersalin.

![Kolom Number Key dan ikon salin (Number Key pada contoh ini sengaja diburamkan)](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fu8h3RaI35dHbXNAB5BQz%2FB6-03-number-key.png?alt=media)

Tempel Number Key itu ke pengaturan API atau aplikasi yang Kamu integrasikan.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Perlakukan Number Key dan API Key seperti kata sandi. Jangan membagikannya di tempat umum.
{% endhint %}

## Memakai Number Key di Rest API

Kirim Number Key di parameter `number_key`, bersama API Key di parameter `api_key`. Contoh isi permintaan kirim pesan teks:

```json
{
  "api_key": "API_KEY_KAMU",
  "number_key": "NUMBER_KEY_KAMU",
  "phone_no": "6281200001234",
  "message": "Halo, ini pesan dari WatZap"
}
```

* **API Key** didapat di Member Area. Panduannya: [Mendapatkan API Key di Member Area](https://docs.watzap.id/help/integrations/mendapatkan-api-key-di-member-area.md).
* Nomor pemilik Number Key harus berstatus **Online** di tab API. Kalau **Offline**, pesan gagal dikirim. Klik **Connect** di baris nomor itu lalu scan QR Code lagi.

## Memakai nilai ALL

Kalau Kamu punya lebih dari satu nomor API yang **Online**, isi `number_key` dengan `ALL`:

```json
{
  "api_key": "API_KEY_KAMU",
  "number_key": "ALL",
  "phone_no": "6281200001234",
  "message": "Halo, ini pesan dari WatZap"
}
```

Dengan `ALL`, setiap permintaan dikirim dari **satu** nomor API yang dipilih acak di antara nomor API Online milik akun Kamu. Respons API menyertakan `number_key` dan `sender_number` dari nomor yang dipakai, sehingga Kamu tetap tahu pesan terkirim dari nomor mana.

{% hint style="info" %}
Nilai `ALL` dipakai untuk kirim pesan teks (`send_message`). Untuk kirim gambar atau file, isi `number_key` dengan Number Key nomor tertentu.
{% endhint %}

## Masalah umum

<details>

<summary>Kolom Number Key tidak terlihat</summary>

Kamu masih berada di tab **Broadcast** atau **Warm Up**. Pindah ke tab **API**. Kalau tab API menampilkan **Connect your first API Number**, berarti belum ada nomor API. Tambahkan dulu lewat [Menambahkan Nomor WA untuk API](https://docs.watzap.id/help/integrations/menambahkan-nomor-wa-untuk-api.md).

</details>

<details>

<summary>Number Key berubah setelah nomor dipindah</summary>

Setiap kali nomor dipindah ke tab API (lewat **Assign for API**) atau ditambahkan ulang, nomor itu mendapat Number Key baru. Salin lagi Number Key terbaru dari tab API, lalu perbarui pengaturan API atau integrasi Kamu.

</details>

<details>

<summary>Respons API "License Not Found"</summary>

Number Key tidak dikenali: salah ketik, nomornya sudah dihapus, atau sudah dipindah ke tab lain. Kalau memakai `ALL`, pesan ini juga muncul bila tidak ada satu pun nomor API yang Online. Cek lagi tab API dan pastikan minimal satu nomor berstatus **Online**.

</details>

<details>

<summary>Pesan tetap gagal terkirim</summary>

Lihat panduan [Solusi Kendala Kirim Pesan via API](https://docs.watzap.id/help/integrations/solusi-kendala-kirim-pesan-via-api.md).

</details>
