> 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-api-key-di-member-area.md).

# Mendapatkan API Key di Member Area

API Key adalah kunci akun WatZap untuk Rest API dan integrasi aplikasi. Lihat dan salin API Key di menu INTEGRATIONS → API Key, lengkap dengan Base URL dan daftar endpoint.

**API Key** adalah kunci akses akun WatZap Kamu. API Key dipakai saat memanggil Rest API WatZap dan saat menghubungkan aplikasi lain, misalnya [OrderOnline.id](https://docs.watzap.id/help/integrations/integrasi-dengan-orderonline.id.md), [Google Form](https://docs.watzap.id/help/integrations/integrasi-dengan-google-form.md), atau [Plugin WatZap di WordPress](https://docs.watzap.id/help/integrations/memasang-plugin-watzap-di-wordpress.md).

Untuk mengirim pesan dari nomor di tab **API**, API Key dipakai bersama **Number Key**. API Key menunjukkan akun Kamu, sedangkan Number Key menentukan nomor pengirimnya. Panduannya ada di [Mendapatkan Number Key untuk API](https://docs.watzap.id/help/integrations/mendapatkan-number-key-untuk-api.md).

{% hint style="info" %}
Menu lama **API Key & Apps** sekarang dipisah menjadi dua menu di bagian **INTEGRATIONS**: **API Key** dan **Apps**.
{% endhint %}

## Sebelum mulai

1. **Paket Personal, Plus, atau Premium yang masih aktif.** Di paket Free dan paket lama (Lite, Pro, Business), kolom API Key buram dan tidak bisa disalin. Lihat [Paket yang bisa memakai API Key](#paket-yang-bisa-memakai-api-key).
2. **Untuk kirim pesan lewat Rest API:** paket **Plus** atau **Premium**, dan minimal satu nomor di tab API. Caranya: [Menambahkan Nomor WA untuk API](https://docs.watzap.id/help/integrations/menambahkan-nomor-wa-untuk-api.md).

## Langkah menyalin API Key

{% stepper %}
{% step %}

### Buka menu API Key

Di menu samping, gulir ke bagian **INTEGRATIONS**, lalu klik **API Key**.

![Menu INTEGRATIONS → API Key](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FjYVSqBVUaOzSE1XyUVAH%2FM1-1-01-menu-api-key.png?alt=media)

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

{% step %}

### Kenali kolom API Key

Kolom **API Key** ada di kiri atas halaman.

1. **Kolom API Key**. Isinya disembunyikan (`••••••••••••••••`).
2. **Ikon mata** untuk menampilkan API Key.
3. **Copy** untuk menyalin API Key.

![Kolom API Key, ikon mata, dan tombol Copy](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F4hxoXBWx6FwnltOIjGxE%2FM1-1-02-kolom-api-key.png?alt=media)
{% endstep %}

{% step %}

### Tampilkan API Key (opsional)

Klik ikon mata kalau Kamu ingin mencocokkan API Key dengan yang sudah terpasang di aplikasi lain.

1. API Key tampil di kolom.
2. Ikonnya berubah menjadi mata dicoret. Klik lagi untuk menyembunyikan API Key.

![API Key ditampilkan (API Key pada contoh ini sengaja diburamkan)](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FyP2yTjx1V1H03XLo1iTb%2FM1-1-03-tampil-api-key.png?alt=media)
{% endstep %}

{% step %}

### Salin API Key

Klik **Copy**. Tulisannya berubah menjadi **Copied!** selama sekitar 2 detik, artinya API Key sudah tersalin. Kamu tidak perlu menampilkan API Key dulu untuk menyalinnya.

![Tombol Copy berubah menjadi Copied!](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FHMLX2HOW2ppxqZ8YEYGv%2FM1-1-04-copied.png?alt=media)

Tempel API Key ke aplikasi yang Kamu integrasikan, atau ke parameter `api_key` saat memanggil Rest API.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Perlakukan API Key seperti kata sandi. Siapa pun yang memegang API Key dan Number Key Kamu bisa mengirim pesan atas nama akun Kamu. Jangan membagikannya di grup, forum, atau kode yang bisa dilihat publik.
{% endhint %}

## Isi kartu di halaman API Key

Selain API Key, kartu di bagian atas halaman berisi data lain yang sering dibutuhkan saat integrasi:

![Kartu kredensial di halaman API Key (data asli diburamkan)](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F1cZ1mWj1O1uCi1gGKdXe%2FM1-1-05-kartu-kredensial.png?alt=media)

1. **API Key**: kunci akun Kamu, dikirim di parameter `api_key`.
2. **Access Token**: token akses WhatsApp Business API (WABA) Official. Terisi setelah WABA terhubung. Kalau belum, kolom ini menampilkan **WABA belum terhubung** dengan tombol **Connect**.
3. **WABA ID**: ID akun WABA Official. Seperti keterangan di bawah kolomnya, WABA ID dipakai sebagai `number_key` pada `set_webhook`, `get_webhook`, dan `unset_webhook`.
4. **Phone Number ID**: ID nomor WABA yang terhubung. Di bawahnya tampil nama dan nomor WABA, batas kirim (**Limit**), serta kualitas nomor (**Quality**).
5. **Base URL**: alamat dasar Rest API WatZap, yaitu `https://api.watzap.id/v1/`. Nama endpoint ditambahkan di belakangnya, misalnya `https://api.watzap.id/v1/send_message`.
6. **Documentation**: klik **API Documentation** untuk membuka dokumentasi API lengkap di tab baru.

Kolom 2 sampai 4 hanya relevan kalau Kamu memakai WABA Official. Untuk menghubungkannya, lihat [Cara Connect Nomor WABA Official](https://docs.watzap.id/help/waba-official/cara-connect-nomor-waba-official.md).

## Daftar endpoint di halaman API Key

Di bawah kartu kredensial ada daftar endpoint API yang dikelompokkan per tab: **Messaging**, **Resources**, **Management**, **Inbox & Automation**, **Email** (Beta, hanya muncul di akun yang sudah punya akses Email), dan **Legacy**. Tab selain **Legacy** berisi endpoint untuk WABA Official.

Endpoint untuk nomor di tab API (yang memakai Number Key) ada di tab **Legacy**:

1. Klik tab **Legacy** (berlabel **WA Unofficial**).
2. Bagian **Messages** berisi `/send_message` (kirim teks), `/send_image_url` (kirim gambar dari URL), dan `/send_file_url` (kirim file dari URL). Klik barisnya untuk melihat parameter dan contoh isi permintaan.

![Tab Legacy berisi endpoint WA Unofficial](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FkocdYZbCY0kbcBX53Iin%2FM1-1-06-tab-legacy.png?alt=media)

Di bawahnya ada bagian **Groups & Webhooks** untuk kirim pesan ke grup serta mengatur webhook.

{% hint style="warning" %}
Tombol **Try it out** lalu **Execute** di setiap endpoint mengirim permintaan sungguhan. Kalau isinya memakai API Key, Number Key, dan nomor tujuan yang benar, pesan benar-benar terkirim.
{% endhint %}

## Paket yang bisa memakai API Key

| Paket                                | Melihat & menyalin API Key        | Kirim pesan lewat Rest API (Number Key) |
| ------------------------------------ | --------------------------------- | --------------------------------------- |
| **Free**                             | Tidak (kolom buram)               | Tidak                                   |
| **Personal**                         | Ya                                | Tidak, kecuali lewat integrasi tertentu |
| **Plus / Premium**                   | Ya                                | Ya                                      |
| **Paket lama** (Lite, Pro, Business) | Tidak (tampil seperti paket Free) | Tidak                                   |

Di paket **Personal**, API Key tetap bisa dipakai untuk integrasi seperti [Google Form](https://docs.watzap.id/help/integrations/integrasi-dengan-google-form.md) serta WPForms dan Contact Form 7 lewat [Plugin WatZap di WordPress](https://docs.watzap.id/help/integrations/memasang-plugin-watzap-di-wordpress.md). Pemanggilan Rest API langsung (`send_message`, `send_image_url`, `send_file_url`, `validate_number`, dan endpoint grup) dari paket Personal dijawab `Need Upgrade Package`.

Di paket **Free**, kolom API Key dan data WABA tampil buram, dan daftar endpoint diganti tulisan **Upgrade your plan to access the API documentation**.

![Tampilan halaman API Key di paket Free](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FkJbtvOYytsyuLw4Az83N%2FM1-1-07-paket-free.png?alt=media)

Klik kolom yang buram untuk memunculkan jendela **Not available in your plan**:

1. **Back** untuk menutup jendela.
2. **Change Plan** untuk membuka halaman upgrade paket.

![Jendela Not available in your plan](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F7SllYLSRzzDwtWf8ya3e%2FM1-1-08-popup-upgrade.png?alt=media)

Panduan upgrade: [Cara Mengganti Paket Langganan](https://docs.watzap.id/help/subscription/cara-mengganti-paket-langganan.md).

## Mengganti API Key

API Key dibuat otomatis oleh WatZap, dan halaman **API Key** tidak punya tombol untuk membuat ulang (regenerate) API Key. Kalau API Key Kamu terlanjur tersebar ke orang lain, hubungi tim WatZap lewat tombol **Need Help?** di bagian atas dashboard.

## Langkah berikutnya

* Salin Number Key nomor pengirim: [Mendapatkan Number Key untuk API](https://docs.watzap.id/help/integrations/mendapatkan-number-key-untuk-api.md).
* Belum punya nomor API: [Menambahkan Nomor WA untuk API](https://docs.watzap.id/help/integrations/menambahkan-nomor-wa-untuk-api.md).
* Memakai JavaScript/Node.js: [WatZap SDK (JavaScript)](https://docs.watzap.id/help/integrations/watzap-sdk.md).
* Pesan gagal terkirim: [Solusi Kendala Kirim Pesan via API](https://docs.watzap.id/help/integrations/solusi-kendala-kirim-pesan-via-api.md).

## Masalah umum

<details>

<summary>Kolom API Key buram dan tidak bisa disalin</summary>

Paket Kamu belum mendukung API Key, misalnya paket Free atau paket lama (Lite, Pro, Business). Klik kolomnya, lalu pilih **Change Plan**, atau ikuti [Cara Mengganti Paket Langganan](https://docs.watzap.id/help/subscription/cara-mengganti-paket-langganan.md).

</details>

<details>

<summary>Menu API Key malah membuka halaman Account Settings</summary>

Masa aktif paket Kamu sudah habis, sehingga WatZap mengarahkan Kamu ke bagian paket langganan. Perpanjang dulu paketnya: [Cara Perpanjang Paket Langganan](https://docs.watzap.id/help/subscription/cara-perpanjang-paket-langganan.md).

</details>

<details>

<summary>Respons API "Invalid Secret Key"</summary>

API Key yang dikirim tidak dikenali. Biasanya karena salah ketik, terpotong, atau ikut tersalin spasi. Salin ulang dengan tombol **Copy** di halaman API Key, lalu tempel lagi.

</details>

<details>

<summary>Respons API "Need Upgrade Package"</summary>

Pengiriman pesan lewat Rest API butuh paket **Plus** atau **Premium**. Penjelasan kode respons lainnya ada di [Solusi Kendala Kirim Pesan via API](https://docs.watzap.id/help/integrations/solusi-kendala-kirim-pesan-via-api.md).

</details>
