Menggunakan API Verifikasi SMS dengan Claude Code: Panduan Penyiapan

Claude Code dapat menambahkan verifikasi SMS ke proyek Anda: berikan skill API SMS Activate App dan simpan kunci API Anda di variabel lingkungan.

Claude Code dapat menambahkan verifikasi SMS ke proyek Anda: berikan skill API SMS Activate App kepadanya, simpan kunci API Anda di variabel lingkungan, dan tinjau setiap langkah yang mengeluarkan uang.

Dengan panduan ini, penyiapannya selesai dalam sekitar sepuluh menit. Caranya sama untuk Codex, Cursor, atau agen pemrograman lain yang dapat membaca file dan menjalankan perintah.

Apa yang dapat dilakukan agen dengan API

Dengan sebuah kunci, agen pemrograman dapat melakukan semua yang dapat dilakukan kode Anda sendiri:

  • Mencari nomor yang tersedia di suatu negara dan melihat harga Anda.
  • Membeli nomor privat untuk masa pakai 28 hari, dengan Idempotency-Key agar percobaan ulang tidak menagih dua kali.
  • Membaca SMS yang masuk ke nomor itu, dan juga panggilannya: sejak November 2026, panggilan singkat disertai teks dan kode yang dibacakan di dalamnya.
  • Melepas nomor atau mematikan perpanjangannya.
  • Menyiapkan webhook agar kode sampai ke server Anda tanpa polling.

Tugas yang umum diserahkan: uji end-to-end alur pendaftaran Anda, fungsi bantu yang menunggu kode di CI, atau penerima webhook dengan pemeriksaan tanda tangan.

Langkah 1: buat kunci dan jauhkan dari kode

  • Buat akun di halaman pendaftaran lalu isi saldo.
  • Buat kunci API pribadi di tab kunci API pada akun Anda, atau di bot Telegram.
  • Simpan kunci di shell Anda atau di penyimpanan rahasia proyek, jangan pernah di file yang di-commit oleh agen:

Kunci ini memakai saldo Anda. Claude Code membaca variabel tersebut saat menjalankan perintah, dan tidak perlu melihat nilainya di percakapan. Jika kunci pernah masuk ke file, commit, atau log, cabut kunci itu di akun Anda dan buat yang baru.

Langkah 2: berikan skill kepada Claude Code

Situs ini menyediakan file skill siap pakai untuk agen pemrograman di /api-skill.md. File itu memuat base URL, rute, batasan, dan error yang perlu ditangani. Simpan sebagai skill proyek:

Claude Code memuat skill saat sebuah tugas cocok dengan deskripsinya, misalnya “tunggu kode SMS di pengujian pendaftaran saya”. Commit file skill jika tim Anda perlu memakainya bersama. File ini tidak berisi kunci.

Agen Anda tidak mendukung skill? Buka dokumentasi API dan tekan tombol yang menyalin prompt agen. Prompt itu memuat aturan yang sama dalam satu blok teks yang dapat Anda tempel ke percakapan mana pun.

Langkah 3: tetapkan aturan proyek

Tambahkan beberapa baris ke CLAUDE.md proyek Anda agar setiap sesi mengikutinya:

Aturan kedua adalah yang paling penting. Pembelian bersifat final dan tanpa pengembalian dana setelah nomor diterbitkan, jadi seseorang harus melihat setiap pembelian sebelum terjadi. Claude Code meminta izin sebelum menjalankan perintah. Biarkan pengaturan itu aktif untuk perintah yang memanggil rute pembelian.

Langkah 4: berikan tugas

Minta hasil akhirnya, bukan panggilan API satu per satu. Contoh:

Tambahkan fixture pytest yang menyewa satu nomor AS melalui API SMS Activate App, menunggu SMS di nomor itu hingga lima menit, lalu mengembalikan kodenya. Gunakan kembali satu nomor yang diperpanjang otomatis di setiap run, alih-alih membeli nomor baru setiap kali.

Hasil yang baik terlihat seperti ini:

  • Agen mencari dengan GET /v1/public/numbers/search?country=US dan menampilkan nomor beserta harganya kepada Anda sebelum membeli.
  • Agen membeli dengan POST /v1/public/numbers dan sebuah Idempotency-Key.
  • Agen melakukan polling GET /v1/public/numbers/{id}/sms setiap 5 sampai 15 detik dengan batas waktu, atau menyiapkan webhook.
  • Agen menangani insufficientbalance, numberunavailable, dan rate_limited sebagai jawaban, bukan sebagai crash.

Jika agen menebak rute yang tidak ada di skill, arahkan ke file OpenAPI dan minta agen memeriksanya.

Langkah 5: tinjau sebelum merge

Sebelum Anda me-merge kode yang ditulis agen, periksa empat hal:

  • Tidak ada kunci di diff, keluaran pengujian, atau log CI.
  • Setiap pembelian mengirim Idempotency-Key, dan percobaan ulang memakai kunci yang sama.
  • Setiap penantian punya batas waktu dan pesan kegagalan yang jelas dengan menyebut nomornya.
  • Pengujian tidak membeli nomor baru di setiap eksekusi jika satu nomor yang diperpanjang sudah cukup.

Biaya yang perlu Anda ketahui

Setiap nomor disewa selama 28 hari dengan harga yang ditampilkan pencarian, dan diperpanjang dari saldo selama perpanjangan otomatis aktif. Sejak November 2026, panggilan masuk (per menit) dan SMS pada nomor juga dipotong dari saldo, dengan harga per negara yang dikembalikan API sebagai usagePricing. Periksa harga untuk angka terkini sebelum Anda membiarkan agen menjalankan rangkaian pengujian terjadwal.

Kapan tidak perlu memakainya

API ini menerima SMS dan panggilan, tidak mengirimnya. Gunakan untuk aplikasi, akun, dan pengujian Anda sendiri. Platform tempat Anda melakukan verifikasi, bukan kami, yang menentukan apakah nomor diterima. Karena itu, periksa nomor dengan layanan tujuan Anda sebelum membangun pipeline di atasnya: cara memeriksa nomor sebelum menyewanya.

Langkah berikutnya