Crea agentes para WhatsApp desde tu código.
Cloud API oficial de Meta, SDK TypeScript y agentes IA multi-LLM. Del npm install al primer mensaje en 3 pasos. Webhooks, workers y CLI cuando los necesites.
01import { Plazbot } from "plazbot"0203const bot = new Plazbot({04 apiKey: process.env.PLAZBOT_KEY!,05 workspaceId: process.env.PLAZBOT_WORKSPACE_ID!,06 zone: "LA", // "LA" | "EU"07})0809await bot.message.onConversation({10 to: "51912345678",11 template: "welcome",12 variablesBody: [{ variable: "1", value: "Ana" }],13})
// QUICKSTART · 3 PASOS
Del signup al primer mensaje.
Tres pasos copia-pega. Sin configurar servidores de Meta ni revisar aprobaciones manuales: Plazbot es Meta Business Partner y el número se conecta desde el panel.
- step [01/03]crea tu cuenta y copia credenciales
Gratis, sin tarjeta. La API key y el workspaceId están en el panel.
~/.env·bash01# https://app.plazbot.com/signup → panel → developers02PLAZBOT_KEY=pk_xxxxxxxxxxxx03PLAZBOT_WORKSPACE_ID=ws_xxxxxxxxxxxx - step [02/03]instala e inicializa el SDK
Un solo paquete. Eliges zona (LA / EU) y el host se resuelve solo.
~/lib/plazbot.ts·typescript01// $ npm install plazbot02import { Plazbot } from "plazbot"0304export const bot = new Plazbot({05 apiKey: process.env.PLAZBOT_KEY!,06 workspaceId: process.env.PLAZBOT_WORKSPACE_ID!,07 zone: "LA", // "LA" | "EU"08}) - step [03/03]envía tu primer mensaje
Plantilla aprobada con variables. La respuesta trae messageId para tracking.
~/scripts/welcome.ts·typescript01import { bot } from "@/lib/plazbot"0203const res = await bot.message.onConversation({04 to: "51912345678",05 template: "welcome",06 variablesBody: [{ variable: "1", value: "Ana" }],07})0809console.log(res.messageId) // → "msg_018f..."
// BUILD · ELIGE TU CAMINO
¿Qué quieres construir?
Tres caminos, un solo SDK. Empieza por el que resuelve tu caso y combina los demás cuando los necesites.
// MENSAJERÍA
whatsapp api
Envía texto, plantillas y campañas sobre la Cloud API oficial de Meta. Webhooks en tiempo real para cada mensaje entrante.
- →Texto libre y plantillas con variables
- →Campañas masivas desde CSV
- →12+ eventos de webhook
// INTELIGENCIA
agentes ia
Agentes multi-LLM (OpenAI, Claude, Gemini) con RAG que responden solos en WhatsApp, web y voz. Handoff a humanos cuando toca.
- →bot.agent.addAgent() desde el SDK
- →RAG con tus documentos
- →Orquestación multi-agente
// LÓGICA CUSTOM
workers
Funciones serverless que extienden tus agentes: tools, syncs, schedules y webhooks. Deploy desde la CLI, sin infraestructura.
- →SDK plz.* con 8 módulos
- →Tool, Worker, Sync, Schedule, Webhook
- →plazbot workers deploy
// CODE · MISMA OPERACIÓN · 3 SUPERFICIES
Un ejemplo, tres superficies.
Enviar la plantilla welcome expresado en SDK TypeScript, CLI Bash y REST HTTP. Parámetros idénticos — elige la superficie según el contexto: tu app, tus ops o cualquier stack.
01import { bot } from "@/lib/plazbot"0203await bot.message.onConversation({04 to: "51912345678",05 template: "welcome",06 variablesBody: [{ variable: "1", value: "Ana" }],07})
// STUDIO · IA EN TU TERMINAL
plazbot studio
Un REPL con IA dentro de la CLI. Pregunta en lenguaje natural por qué un agente no respondió, diagnostica conversaciones y opera tu workspace sin salir de la terminal.
- →conversa con tu workspace en lenguaje natural
- →/agents · /load · /diagnose · /panel
- →modo one-shot: plazbot studio ask "..."
- →streaming de respuestas en vivo
// PLATFORM · LO QUE HAY DEBAJO
Una sola plataforma.
Todo lo del quickstart corre sobre la misma infraestructura: API REST, webhooks, multi-región y multi-LLM. Los detalles viven en la documentación.
// API REST
api.plazbot.com
- →25+ endpoints sobre HTTPS
- →Bearer token + x-workspace-id
- →campañas · templates · contactos
// WEBHOOKS
12+ eventos en tiempo real
- →message.received · contact.created
- →conversation.assigned / resolved
- →payload tipado PlazbotEvent
// REGIONES
LA · EU
- →api.plazbot.com (Latinoamérica)
- →apieu.plazbot.com (Europa)
- →data residency por zona
// MULTI-LLM
OpenAI · Claude · Gemini
- →elige modelo por agente
- →RAG con Pinecone
- →orquestación multi-agente
// READY
Tu primer mensaje está a 3 pasos.
Cuenta gratis, sin tarjeta. API key en el panel y npm i plazbot en tu terminal.