> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Koneksi API

> Ubah API HTTP apa pun menjadi fungsi yang dapat dipanggil agen Anda di tengah percakapan — tempel perintah cURL dan biarkan panduan menangani sisanya.

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 mendefinisikan endpoint sekali di
**Connections → APIs** (`/dashboard/api-connections`); agen yang telah
dilampiri koneksi kemudian dapat memanggilnya kapan pun percakapan
memerlukannya.

Ada dua cara untuk membuatnya: tempel sesuatu yang dapat dianalisis wizard,
atau siapkan 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 teks yang Anda tempel — URL,
    metode, header, dan skema parameter yang diturunkan dari parameter kueri
    serta isi permintaan yang ditemukan. Header yang Anda tempel (termasuk
    header autentikasi) diterapkan ke konfigurasi endpoint.
  </Step>

  <Step title="Konfirmasikan bidang yang disorot">
    Konfigurasi yang disimpulkan terbuka dengan bidang tebakan disorot
    untuk ditinjau. Sesuaikan nama, deskripsi, dan tipe parameter agar
    agen memahami kapan dan bagaimana memanggil fungsi — deskripsi
    adalah yang dibaca model.
  </Step>

  <Step title="Validasi & Simpan">
    Penyimpanan terlebih dahulu menjalankan permintaan pengujian 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 teks yang Anda tempel, wizard akan memberi tahu Anda —
sertakan endpoint `http(s)` lengkap lalu coba lagi.

## Penyiapan manual

Klik **Siapkan 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`), **header**
  kustom, dan skema parameter (**Tambahkan properti** untuk setiap
  argumen yang dapat diberikan agen).
* **JSON** — definisi yang sama sebagai JSON mentah, untuk menempelkan atau menyempurnakan
  spesifikasi alat secara langsung.

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

<Tip>
  Berikan deskripsi parameter dalam bahasa sederhana ("Alamat email pelanggan,
  misalnya [jane@example.com](mailto: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 **Kesalahan** — nama fungsinya, dan agen mana yang menggunakannya.
Dari menu tindakan baris, Anda dapat:

* **Edit** — buka kembali konfigurasi.
* **Kloning** — duplikat sebagai titik awal (salinan dimulai sebagai
  Belum diuji).
* **Riwayat revisi** — lihat versi sebelumnya dan pulihkan salah satunya ke
  editor.
* **Transfer** — salin atau pindahkan koneksi ke organisasi lain yang
  Anda miliki. Pemindahan menghapusnya dari sini; agen yang menggunakannya mungkin perlu
  dikonfigurasi ulang.
* **Hapus** — permanen; agen yang menggunakan koneksi harus
  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 mana yang
menggunakan setiap koneksi, sehingga Anda dapat langsung mengetahui dampak suatu perubahan.

## Langkah selanjutnya

<CardGroup cols={2}>
  <Card title="Integrasi alat 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 Google, Slack, HubSpot, Salesforce, dan Cal.com siap pakai.
  </Card>

  <Card title="Tambahkan server MCP" icon="server" href="/id/guides/mcp-servers">
    Ekspos seluruh server alat kepada agen Anda.
  </Card>

  <Card title="Referensi API integrasi" icon="book" href="/api-reference/integrations">
    Setiap kolom pada resource integrasi.
  </Card>
</CardGroup>