API de OTP para Agentes de IA
Todo lo que su agente de IA necesita para enviar y verificar OTPs — póngase en marcha en minutos.
La API de OTP de EngageLab permite que su agente de IA envíe y verifique contraseñas de un solo uso (OTP) a través de una API multicanal unificada: SMS, WhatsApp, Email y Voz. De forma programática, sin requerir ninguna interacción humana.
Requisito previo: Crear un API Key y una Plantilla
Se requieren dos pasos de configuración únicos antes de que su agente pueda enviar OTPs — ambos deben ser completados por un humano en la consola de EngageLab.
1. Crear un API Key
Regístrese para obtener una cuenta de EngageLab y cree un API key en la consola de OTP. Esto le proporciona un dev_key y un dev_secret, que su agente utiliza para autenticar todas las solicitudes de la API.
2. Crear y aprobar una Plantilla
Cada mensaje OTP se envía utilizando una plantilla preaprobada. Cree una plantilla en la consola, configure sus canales de envío (SMS, WhatsApp, Email o Voz), la longitud del código y el período de validez. Las plantillas pasan por un proceso de revisión antes de poder ser utilizadas. Una vez aprobada, pase el Template ID a su agente como parámetro.
Agent Skills — ¿Cómo instalo los Agent Skills de EngageLab OTP?
Los Agent Skills brindan a Cursor, Claude Code y Windsurf el conocimiento para manejar los OTPs automáticamente: enviar códigos, verificarlos, procesar webhooks.
Un comando para instalar, luego solo pregúntele a su agente:
# 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
Vea más detalles sobre cómo usar los Skills de EngageLab OTP con sus agentes de IA: → Agent Skills
Docs para Agentes — ¿Qué formatos puede leer mi agente?
Dele a su agente acceso directo a la Referencia de API completa. Cada página cubre un Endpoint único con parámetros de solicitud completos, formatos de respuesta y códigos de error — todo lo que un agente necesita para llamar a la API de EngageLab OTP sin contexto adicional:
Inicio Rápido — Envíe y Verifique su Primer OTP
Copie los ejemplos de código a continuación en Cursor o Claude Code para configurar la integración de OTP automáticamente:
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 proporciona dos Endpoints principales para los flujos de trabajo de OTP:
| Acción | Endpoint | Caso de Uso |
|---|---|---|
| Send OTP | POST /v1/messages |
Generar y entregar un código de verificación a un usuario. |
| Verify OTP | POST /v1/verifications |
Verificar el código enviado por el usuario. |
Pasos que seguirá su agente
- Detectar el idioma del proyecto desde los archivos de configuración (
package.json,requirements.txt, etc.) - Instalar SDK —
npm install engagelab-otpopip install engagelab-otp - Implementar Autenticación — HTTP Basic Auth usando
base64(dev_key:dev_secret) - Implementar Webhooks — Para producción, configure endpoints de callback para rastrear el estado de entrega
Para códigos de error completos, consulte la Referencia de la API de cada Endpoint (por ejemplo, Errores de Send OTP).
¿Es nuevo en EngageLab OTP? Siga la guía de configuración de la consola paso a paso para registrarse, crear una plantilla y obtener su API Key antes de ejecutar el código anterior.
SDKs Oficiales — Node.js y Python
EngageLab es un proveedor global de API de OTP que ofrece SDKs oficiales para Node.js y Python para ayudarlo a integrar la entrega de OTP, la verificación y los callbacks de webhook sin dependencias.
Vea las instrucciones de instalación y los ejemplos para los SDKs de Node.js y Python: → SDKs
Preguntas Frecuentes (FAQs)
¿Cómo envía un agente de IA un OTP sin interacción humana?
La API de OTP de EngageLab es totalmente programable, su agente llama a /v1/messages para enviar y a /v1/verifications para verificar.
Sin interfaz de usuario, no se requieren pasos manuales.
¿Qué sucede cuando expira un OTP y el agente lo reintenta?
Llamar a la API de envío de nuevo con el mismo destinatario emite un nuevo código y devuelve un nuevo message_id. El código expirado se invalida automáticamente. → Errores de Send OTP · Errores de Verify OTP
¿Cómo hago un seguimiento del estado de entrega y verificación de OTP en tiempo real?
EngageLab OTP admite callbacks de webhook — configure una URL de callback en la consola y el sistema enviará los datos del evento a su Endpoint cuando ocurran eventos clave, como mensaje entregado, OTP verificado o alertas de saldo bajo. No se requiere polling. → Ver Configuración de Callback
¿Cómo envío un OTP con Cursor o Windsurf?
Los Agent Skills de EngageLab OTP brindan a Cursor, Windsurf y Claude Code el contexto que necesitan para enviar y verificar OTPs sin salir de su editor. Instale el Skill con un comando:
npx skills add https://github.com/DevEngageLab/engagelab-skills/tree/main/engagelab-otp/skills/engagelab-otp-send
Una vez instalado, su agente puede llamar a la API de OTP de EngageLab (POST /v1/messages) para enviar una contraseña de un solo uso por SMS, WhatsApp, Email o Voz — y verificarlo con POST /v1/verifications. No requiere configuración manual de API.
