API OTP untuk Agen AI

Segala yang dibutuhkan agen AI Anda untuk mengirim dan memverifikasi OTP — jalankan dalam hitungan menit.

API EngageLab OTP memungkinkan agen AI Anda untuk mengirim dan memverifikasi kata sandi satu kali (OTP) melalui API multisaluran terpadu: SMS, WhatsApp, Email, dan Suara. Secara terprogram, tanpa memerlukan interaksi manusia apa pun.

Prasyarat: Buat API Key dan Templat

Dua langkah pengaturan satu kali diperlukan sebelum agen Anda dapat mengirim OTP — keduanya harus diselesaikan oleh manusia di konsol EngageLab.

1. Buat API Key
Daftar akun EngageLab dan buat API Key di konsol OTP. Ini memberi Anda dev_key dan dev_secret, yang digunakan oleh agen Anda untuk mengautentikasi semua permintaan API.

2. Buat dan setujui Templat
Setiap pesan OTP dikirim menggunakan templat yang telah disetujui sebelumnya. Buat templat di konsol, konfigurasikan saluran pengiriman Anda (SMS, WhatsApp, Email, atau Suara), panjang kode, dan periode validitas. Templat melalui proses peninjauan sebelum dapat digunakan. Setelah disetujui, teruskan Template ID ke agen Anda sebagai parameter.

Agent Skills — Bagaimana cara memasang EngageLab OTP Agent Skills?

Agent Skills memberi Cursor, Claude Code, dan Windsurf pengetahuan untuk menangani OTP secara otomatis: mengirim kode, memverifikasinya, memproses webhooks.

Satu perintah untuk dipasang, lalu cukup minta ke agen Anda:

              
              # Skill for sending OTPs
npx skills add https://github.com/DevEngageLab/engagelab-skills/tree/main/engagelab-otp/skills/engagelab-otp-send

# Skill for verifying OTPs
npx skills add https://github.com/DevEngageLab/engagelab-skills/tree/main/engagelab-otp/skills/engagelab-otp-verify

# Skill for configuring and handling webhooks/callbacks
npx skills add https://github.com/DevEngageLab/engagelab-skills/tree/main/engagelab-otp/skills/engagelab-otp-webhook

            

Lihat selengkapnya tentang cara menggunakan Skills EngageLab OTP dengan agen AI Anda: → Agent Skills

Docs untuk Agen — Format apa yang dapat dibaca agen saya?

Beri agen Anda akses langsung ke Referensi API selengkapnya. Setiap halaman membahas sebuah Endpoint tunggal yang dilengkapi parameter permintaan, sistem format respons, dan kode kesalahan — segala hal yang agen butuhkan untuk memanggil API EngageLab OTP tanpa konteks tambahan:

• Send OTP
• Verify OTP
• Create Template
• Get All Template Lists
• Get Template Details
• Delete Template

Mulai Cepat — Kirim dan Verifikasi OTP Pertama Anda

Salinlah berbagai contoh kode di bawah ini pada Cursor atau Claude Code untuk mengatur penerapan platform OTP secara otomatis:

Node.js

              
              const { OTPClient } = require('engagelab-otp');

const otp = new OTPClient(
  process.env.ENGAGELAB_DEV_KEY,
  process.env.ENGAGELAB_DEV_SECRET
);

// Platform-generated OTP — the simplest way
const { message_id } = await otp.send('+6591234567', 'your-template-id', {}, 'en');
const { verified }   = await otp.verify(message_id, userTypedCode);

            

Python

              
              import os
from engagelab_otp import OTPClient

otp = OTPClient(
    os.environ["ENGAGELAB_DEV_KEY"],
    os.environ["ENGAGELAB_DEV_SECRET"],
)

# Platform-generated OTP — the simplest way
result = otp.send("+6591234567", "your-template-id", {"name": "Alice"}, language="en")
check  = otp.verify(result["message_id"], user_typed_code)
if check["verified"]:
    print("Success!")

            

EngageLab menyediakan dua Endpoint utama untuk alur kerja OTP:

Langkah-langkah yang akan diikuti agen Anda

1. Mendeteksi bahasa proyek dari file konfigurasi (package.json, requirements.txt, dll.)
2. Pasang SDK — npm install engagelab-otp atau pip install engagelab-otp
3. Mengimplementasikan Autentikasi — HTTP Basic Auth dengan menggunakan base64(dev_key:dev_secret)
4. Mengimplementasikan Webhooks — Untuk tahap produksi, terapkan Endpoint Callback agar bisa memantau status pengiriman

Untuk kode kesalahan yang paling lengkap, silakan merujuk kepada Referensi API untuk perihal setiap Endpoint. (mis. Kesalahan Pengiriman OTP).

Baru di EngageLab OTP? Ikuti panduan pengaturan konsol langkah demi langkah untuk mendaftar, membuat sebuah templat, dan dapatkan API Key Anda sebelum menjalankan kode di atas.

SDK Resmi — Node.js & Python

EngageLab adalah penyedia API OTP global yang menawarkan SDK resmi bagi platform Node.js dan Python untuk bisa membantu platform dalam mengintegrasikan berbagai pengiriman OTP, verifikasi, serta beragam callback webhook tanpa perihal kendala apa pun.

Lihatlah petunjuk instalasinya juga berbagai contoh lainnya bagi SDK Node.js dan Python: → SDKs

Pertanyaan Umum (FAQ)

Bagaimana cara sebuah agen AI mengirim OTP tanpa harus melakukan interaksi antara sesama manusia?

API EngageLab OTP dapat diprogramkan sepenuhnya, agen Anda memanggil /v1/messages untuk dikirimkan dan juga ke /v1/verifications secara diverifikasi. Tanpa UI, pun tak ada bentuk langkah manual yang akan dilakukan.

Apa yang nanti bakal terjadi bilamana pada bagian dalam dari OTP kedaluwarsa lalu agen mencobanya lagi?

Menelepon pihak penanggung API dikirim kembali dengan penerima yang persis sejenis itu, bisa menerbitkan sebuah kode model terbaru serta diiringi pengembalian yang dapat ditunjukan terhadap salah satu message_id. Sejumlah tipe pemakaian di bawah bentuk berjenis kode yang telah mengalami hal kedaluwarsa nantinya juga dibatalkan dengan otomatis. → Kesalahan Send OTP · Kesalahan Verify OTP

Bagaimana dengan status penyebaran saya dapat terkirim, juga terkait proses dari pemantauan OTP dan status verifikasinya yang dilancarkan mengikuti skema real-time ini?

EngageLab OTP mensupport webhook callbacks — dan jika kita coba lihat konfigurasi dari sebuah URL callback di konsolnya ini dan juga dari sistem platform tersebut tentunya juga akan menekan setiap pangkalan event berstatus data ke salah satu Endpoint Anda pas sedang dalam suatu key berstatus events akan terjadi, misalnya sebuah pesan status terkirim, bagian bentuk dari si pengampu OTP ini akhirnya selesai disah-terapkan atau muncul adanya suatu isyarat mengenai saldo peringatannya bernilai rendah. Sama tak bakal perlu apa yang namanya pangkalan bentuk dukungan di dalamnya. → Lihat pada bagian sistem Konfigurasi Callbacks

Bagaimana jika nanti mengirim OTP secara langsung ke program platform di dalam si entitas Cursor atau platform sistem Windsurf?

Berbagai rangkaian dari Agent Skills di fitur dalam platform EngageLab OTP lantas hal itu tentu saja ini bakalan bisa berikan suatu petunjuk dari Cursor, Windsurf, serta juga atas peran platformnya Claude Code guna mendukung pemberian bentuk dari beragam hal seputar konteks semacam ini yang diperlukan mereka dalam rangka berstatus pengiriman hingga soal perizinan pemakaian agar sejenis OTP seperti itu, bisa dibereskan semuanya asalkan perihal penunjang itu tidak akan pernah berpangku ke tempat yang satu per satu dari penggunanya sendiri. editor. Instal sebuah format ini (atau skill yang dibutuhkan di antaranya) di dalam sebuah bentuk format dengan perintah tunggal dari parameter tersebut:

              
              npx skills add https://github.com/DevEngageLab/engagelab-skills/tree/main/engagelab-otp/skills/engagelab-otp-send

            

Sesudah bentuk perangkat dari parameter tersebut selesai kalian pergunakan, di sini nanti sebuah sistem dari peran atas platform bagi sang agen bisa dilanjutkan ke pihak pemanggil bagian EngageLab untuk sisi API terkait fitur platform bernama EngageLab OTP saja (POST /v1/messages) buat mengirim salah satu sandi satu kalinya melalui perihal SMS, WhatsApp, model perihal dari fitur untuk fasilitas sejenis Email, atau juga format dalam Suara dari si agen kalian — juga seiring statusnya nanti dalam urusan verifikasi dengan program berupa POST /v1/verifications. Tentunya yang sama pula untuk tipe parameter tak bisa ada pengaturan terhadap program manual API dari berbagai perizinan yang sedang terjadi ini.