> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/ai-and-platform/connected-platforms/custom-api.md).

# Custom API

Hubungkan platform atau aplikasi messaging Anda ke Cekat.AI menggunakan Custom API.

Gunakan Custom Channel untuk mengirim pesan customer ke Cekat.AI dan menerima balasan agent di sistem Anda sendiri.

### Sebelum memulai

Sebelum membuat custom channel, pastikan Anda memiliki:

* API endpoint yang bisa diakses secara publik.
* Webhook endpoint untuk menerima pesan outbound.
* Metode autentikasi, seperti API key, OAuth, atau access token.

### Menghubungkan Custom Channel

<figure><img src="https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FIAJUruPjZg29ITbBklkB%2Fimage.png?alt=media&amp;token=bc7a338c-28c1-4eeb-b8d1-65207d4d275c" alt=""><figcaption></figcaption></figure>

1. Buka **Connected Platform**.
2. Klik **+ Add Inbox**.
3. Pilih **Custom Channel**.
4. Masukkan nama untuk channel tersebut.
5. Konfigurasikan webhook endpoint untuk pesan outbound.
6. Konfigurasikan autentikasi.
7. Tentukan format request.
8. Uji koneksinya.
9. Simpan konfigurasi.

### Cara kerjanya

Custom Channel menukar pesan antara sistem Anda dan Cekat.AI.

| Arah           | Deskripsi                                                                          |
| -------------- | ---------------------------------------------------------------------------------- |
| Pesan Inbound  | Aplikasi Anda mengirim pesan customer ke Cekat.AI menggunakan Custom API.          |
| Pesan Outbound | Cekat.AI mengirim balasan agent dan pembaruan percakapan ke webhook endpoint Anda. |

### Fitur yang didukung

Custom Channel mendukung:

* Pengiriman pesan dua arah (bidirectional messaging)
* Notifikasi webhook
* Pemetaan event kustom (custom event mapping)
* Autentikasi API key
* Autentikasi OAuth
* Header autentikasi kustom