OTP-API für KI-Agenten
Alles, was Ihr KI-Agent benötigt, um OTPs zu senden und zu verifizieren — in wenigen Minuten einsatzbereit.
Die EngageLab OTP-API ermöglicht es Ihrem KI-Agenten, Einmalpasswörter über eine einheitliche Multi-Channel-API zu senden und zu verifizieren: SMS, WhatsApp, E-Mail und Voice. Programmgesteuert, ohne dass eine menschliche Interaktion erforderlich ist.
Voraussetzung: API Key und Template erstellen
Bevor Ihr Agent OTPs senden kann, sind zwei einmalige Einrichtungsschritte erforderlich — beide müssen von einem Menschen in der EngageLab-Konsole durchgeführt werden.
1. API Key erstellen
Registrieren Sie sich für ein EngageLab-Konto und erstellen Sie einen API Key in der OTP-Konsole. Dadurch erhalten Sie einen dev_key und ein dev_secret, mit denen sich Ihr Agent für alle API-Anfragen authentifiziert.
2. Template erstellen und genehmigen lassen
Jede OTP-Nachricht wird mit einem vorab genehmigten Template gesendet. Erstellen Sie ein Template in der Konsole und konfigurieren Sie Ihre Sendekanäle (SMS, WhatsApp, E-Mail oder Voice), Code-Länge und Gültigkeitsdauer. Templates durchlaufen einen Überprüfungsprozess, bevor sie verwendet werden können. Übergeben Sie nach der Genehmigung die Template ID als Parameter an Ihren Agenten.
Agent Skills — Wie installiere ich EngageLab OTP Agent Skills?
Agent Skills geben Cursor, Claude Code und Windsurf das Wissen, um OTPs automatisch zu verarbeiten: Codes senden, verifizieren, Webhooks verarbeiten.
Ein Befehl zur Installation, fragen Sie dann einfach Ihren Agenten:
# 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
Weitere Details zur Verwendung der EngageLab OTP-Skills mit Ihren KI-Agenten anzeigen: → Agent Skills
Docs für Agenten — Welche Formate kann mein Agent lesen?
Geben Sie Ihrem Agenten direkten Zugriff auf die vollständige API Reference. Jede Seite behandelt einen einzelnen Endpoint mit vollständigen Anfrageparametern, Antwortformaten und Fehlercodes — alles, was ein Agent benötigt, um die EngageLab OTP-API ohne zusätzlichen Kontext aufzurufen:
Schnellstart — Senden und Verifizieren Sie Ihr erstes OTP
Kopieren Sie die folgenden Codebeispiele in Cursor oder Claude Code, um die OTP-Integration automatisch einzurichten:
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 bietet zwei primäre Endpoints für OTP-Workflows:
| Aktion | Endpoint | Anwendungsfall |
|---|---|---|
| Send OTP | POST /v1/messages |
Erstellen und liefern Sie einen Verifizierungscode an einen Benutzer. |
| Verify OTP | POST /v1/verifications |
Verifizieren Sie den vom Benutzer übermittelten Code. |
Schritte, denen Ihr Agent folgen wird
- Projektsprache erkennen aus Konfigurationsdateien (
package.json,requirements.txtusw.) - SDK installieren —
npm install engagelab-otpoderpip install engagelab-otp - Authentifizierung implementieren — HTTP Basic Auth unter Verwendung von
base64(dev_key:dev_secret) - Webhooks implementieren — Für die Produktion richten Sie Callback-Endpoints ein, um den Zustellstatus zu verfolgen
Für vollständige Fehlercodes, beziehen Sie sich auf die API Reference für jeden Endpoint (z. B. Send OTP Fehler).
Neu bei EngageLab OTP? Folgen Sie dem Schritt-für-Schritt-Konsolen-Setup-Leitfaden, um sich zu registrieren, ein Template zu erstellen und Ihren API Key zu erhalten, bevor Sie den obigen Code ausführen.
Offizielle SDKs — Node.js & Python
EngageLab ist ein globaler Anbieter von OTP-APIs und bietet offizielle SDKs für Node.js und Python an, um Ihnen bei der Integration der OTP-Zustellung, Verifizierung und Webhook-Callbacks ohne jegliche Abhängigkeiten zu helfen.
Installationsanweisungen und Beispiele für Node.js und Python SDKs anzeigen: → SDKs
FAQs
Wie sendet ein KI-Agent ein OTP ohne menschliche Interaktion?
Die EngageLab OTP-API ist vollständig programmierbar. Ihr Agent ruft /v1/messages auf, um zu senden, und /v1/verifications, um zu verifizieren.
Keine UI, keine manuellen Schritte erforderlich.
Was passiert, wenn ein OTP abläuft und der Agent einen neuen Versuch unternimmt?
Beim erneuten Aufruf der Send-API mit demselben Empfänger wird ein neuer Code ausgestellt und eine neue message_id zurückgegeben. Der abgelaufene Code wird automatisch ungültig. → Send OTP Fehler · Verify OTP Fehler
Wie verfolge ich den OTP-Zustell- und Verifizierungsstatus in Echtzeit?
EngageLab OTP unterstützt Webhook-Callbacks — konfigurieren Sie eine Callback-URL in der Konsole, und das System überträgt Ereignisdaten an Ihren Endpoint, wenn Schlüsselereignisse auftreten, z. B. Nachricht zugestellt, OTP verifiziert oder Warnungen bei niedrigem Guthaben. Keine Abfrage erforderlich. → Siehe Callback-Konfiguration
Wie sende ich ein OTP mit Cursor oder Windsurf?
EngageLab OTP Agent Skills geben Cursor, Windsurf und Claude Code den Kontext, den sie benötigen, um OTPs zu senden und zu verifizieren, ohne Ihren Editor zu verlassen. Installieren Sie den Skill mit einem Befehl:
npx skills add https://github.com/DevEngageLab/engagelab-skills/tree/main/engagelab-otp/skills/engagelab-otp-send
Nach der Installation kann Ihr Agent die EngageLab OTP-API (POST /v1/messages) aufrufen, um ein Einmalpasswort per SMS, WhatsApp, E-Mail oder Voice zu senden — und es mit POST /v1/verifications zu verifizieren. Kein manuelles API-Setup erforderlich.
