---
title: "Koneksi API"
description: "Ubah API HTTP apa pun menjadi fungsi yang dapat dipanggil agen Anda di tengah percakapan: tempelkan perintah cURL, lalu panduan akan membuat definisi alat, parameter, dan autentikasi."
---

Koneksi API adalah fungsi HTTP kustom yang dapat dipanggil agen Anda selama
percakapan — mencari pesanan, membuat tiket, mengambil status akun
dari backend Anda sendiri. Anda menentukan endpoint sekali di bawah
**Koneksi → API** (`/dashboard/api-connections`); agen yang memiliki
koneksi terlampir kemudian dapat memanggilnya kapan pun percakapan
memerlukannya.

Ada dua cara untuk membuatnya: tempel sesuatu yang dapat dianalisis oleh Wizard,
atau atur koneksi secara manual.

## Jalur cepat: tempel dan analisis

<Steps>
  <Step title="Klik Koneksi API baru">
    Dialog terbuka di Wizard. Tempel contoh **perintah cURL**,
    **spesifikasi OpenAPI/Swagger**, **ekspor Postman**, **antarmuka
    TypeScript**, atau **skema Zod** ke dalam kotak.
  </Step>
  <Step title="Klik Analisis">
    ThunderPhone menyimpulkan seluruh koneksi dari tempelan Anda — URL,
    metode, header, dan skema parameter yang diturunkan dari parameter
    kueri serta isi permintaan yang ditemukan. Header yang Anda tempel
    (termasuk header autentikasi) dibawa ke konfigurasi endpoint.
  </Step>
  <Step title="Konfirmasikan bidang yang disorot">
    Konfigurasi yang disimpulkan terbuka dengan bidang yang diperkirakan
    disorot untuk ditinjau. Sesuaikan nama, deskripsi, dan jenis parameter
    agar agen memahami kapan dan bagaimana memanggil fungsi — deskripsi
    adalah yang dibaca oleh model.
  </Step>
  <Step title="Validasi & Simpan">
    Penyimpanan terlebih dahulu menjalankan permintaan uji langsung terhadap endpoint Anda. Jika
    permintaan gagal, koneksi tidak disimpan — perbaiki URL, header
    autentikasi, atau isi lalu coba lagi. Jika berhasil, koneksi disimpan
    dengan lencana **Tervalidasi**.
  </Step>
</Steps>

Jika Wizard tidak dapat menemukan URL permintaan dalam tempelan Anda, Wizard akan memberi tahu Anda —
sertakan endpoint `http(s)` lengkap lalu coba lagi.

## Pengaturan manual

Klik **Atur secara manual →** di Wizard (atau **Ingin AI menyimpulkan ini?
Coba Wizard →** untuk kembali). Pembuat manual memiliki dua editor:

- **Visual** — bidang formulir untuk nama tampilan, nama fungsi, permintaan
  **URL**, **metode** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), kustom
  **header**, dan skema parameter (**Tambahkan properti** untuk setiap
  argumen yang dapat diberikan agen).
- **JSON** — definisi yang sama sebagai JSON mentah, untuk menempelkan atau menyempurnakan
  spesifikasi tool secara langsung.

Panel **Uji Permintaan** (opsional) memungkinkan Anda mengirim permintaan yang dikonfigurasi
sebelum menyimpan serta menampilkan status, latensi, dan pratinjau respons.
**Validasi & Simpan** selalu menjalankan pengujian ini dan hanya menyimpan jika berhasil.

Nilai header hanya dapat ditulis. Setelah disimpan, nilai tersebut dienkripsi dan tidak pernah ditampilkan
lagi, baik di dashboard maupun API. Saat Anda mengedit koneksi, header yang disimpan menampilkan namanya dengan titik sebagai pengganti nilainya serta catatan **Disimpan**:
biarkan apa adanya untuk mempertahankan nilai yang disimpan, atau masukkan nilai baru untuk menggantinya. Permintaan pengujian dan panggilan langsung menggunakan nilai yang disimpan. **Kloning** menyalin nilai yang disimpan
ke koneksi baru.

<Tip>
  Berikan parameter deskripsi dalam bahasa sederhana ("Alamat email pelanggan,
  misalnya jane@example.com"). Agen memilih argumen dari deskripsi ini
  secara real time, di tengah panggilan.
</Tip>

## Kelola koneksi Anda

Setiap baris koneksi menampilkan status validasinya — **Tervalidasi**,
**Belum diuji**, atau **Error** — nama fungsinya, serta agen yang menggunakannya.
Dari menu tindakan baris, Anda dapat:

- **Edit** — membuka kembali konfigurasi.
- **Kloning** — menduplikasinya sebagai titik awal (salinan dimulai
  Belum diuji).
- **Riwayat revisi** — melihat versi sebelumnya dan memulihkan salah satunya ke
  editor.
- **Transfer** — menyalin atau memindahkan koneksi ke organisasi lain yang
  Anda ikuti. Pemindahan menghapusnya di sini; agen yang menggunakannya mungkin
  perlu dikonfigurasi ulang.
- **Hapus** — permanen; agen yang menggunakan koneksi perlu
  dikonfigurasi ulang.

## Lampirkan ke agen

Tambahkan koneksi ke agen di bagian koneksi API pada pembuat
([Buat agen](/id/guides/build-an-agent)). Daftar menampilkan agen yang
menggunakan setiap koneksi, sehingga Anda dapat langsung mengetahui dampak suatu perubahan.

## Langkah selanjutnya

<CardGroup cols={2}>
  <Card title="Integrasi tool melalui API" icon="code" href="/id/guides/build-tool-integration">
    Buat dan kelola koneksi yang sama secara terprogram.
  </Card>
  <Card title="Hubungkan aplikasi" icon="cable" href="/id/guides/connect-apps">
    Koneksi siap pakai untuk Google, Slack, HubSpot, Salesforce, dan Cal.com.
  </Card>
  <Card title="Tambahkan server MCP" icon="server" href="/id/guides/mcp-servers">
    Ekspos seluruh server tool kepada agen Anda.
  </Card>
  <Card title="Referensi API integrasi" icon="book" href="/api-reference/integrations">
    Setiap bidang pada resource integrasi.
  </Card>
</CardGroup>