operational·build passing·latency p95 142ms·regions LA · EU
~ /developers/plazbot·$ tree -L 1

Infra completa.
No otro chatbot.

SDK, CLI, Workers, Monitor, API REST y WhatsApp Cloud API en una sola plataforma. Construye agentes IA conversacionales en producción.

├── 7 capas · 1 npm package · 3 subpaths
├── 12+ webhook events · 25+ endpoints REST
└── OpenAI · Claude · Gemini · Pinecone
read the docs
hello-plazbot.ts
TypeScript
1
2
3
4
5
6
7
8
9
// hello-plazbot.ts
import { Plazbot } from "plazbot";
const client = new Plazbot({ apiKey: process.env.PLAZBOT_KEY });
await client.message.send({
  to: "+51912345678",
  text: "Hola desde Plazbot SDK"
});
$✓message.sent·142ms·id: msg_01J9X...K2P

// WHAT YOU CAN BUILD ON WHATSAPP

whatsapp/*

Conectar números, enviar mensajes, lanzar campañas, recibir webhooks y desplegar agentes IA — todo por SDK, CLI o API REST sobre WhatsApp Cloud API oficial.

└── Cloud API oficial Meta · BSP certificado · Multi-región LA y EU

Empieza con el SDK

// LAYER 04 · SDK

plazbot/sdk

SDK TypeScript con 3 subpaths: core para Node, React para componentes, Workers para funciones serverless.

// INSTALL

$ npm i plazbot
$ npm i plazbot/react
$ npm i plazbot/workers

// CAPABILITIES

  • ├──Envío de mensajes y plantillas WhatsApp
  • ├──Listener de eventos (message.received, contact.*, conversation.*)
  • ├──Gestión de contactos
  • ├──Disparo de agentes IA por código
  • ├──Workers definibles desde SDK (defineTool, defineWorker, defineSync, defineSchedule, defineWebhook)
└── See full SDK reference
campaign.ts
TypeScript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// campaign.ts
import { Plazbot } from "plazbot";
const client = new Plazbot({
  apiKey: process.env.PLAZBOT_KEY,
  workspaceId: process.env.PLAZBOT_WORKSPACE
});
// Enviar plantilla aprobada por Meta
await client.whatsapp.template.send({
  to: "+51912345678",
  template: "welcome_onboarding",
  variables: { CONTACT_NAME: "Carlos" }
});
// Escuchar eventos
client.on("message.received", async (event) => {
  console.log(`Mensaje de ${event.contact.phone}: ${event.text}`);
});

// LAYER 04 · CLI

plazbot-cli

Construye, despliega y administra desde la terminal.

read the docs
~/projects/my-app — zsh
// AUTH
>_plazbot auth login
// AGENTS
>_plazbot agent list
>_plazbot agent create --name "Soporte"
>_plazbot agent deploy --id agt_abc123
// WHATSAPP
>_plazbot whatsapp broadcast --template welcome --csv contacts.csv
// WORKERS
>_plazbot workers init my-worker
>_plazbot workers deploy
>_plazbot workers logs --tail
// PORTAL IA
>_plazbot portal deploy
>_
└── See full CLI reference

// LAYER 02 · WORKERS

plazbot/workers

Funciones serverless invocables desde agentes IA, automatizaciones, webhooks o cron. 5 tipos según el trigger: tool, worker, sync, schedule y webhook.

consultar-stock.ts
TypeScript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import { defineTool } from 'plz/workers'
 
export default defineTool({
  name: 'consultar-stock',
  reference: 'Consulta disponibilidad de productos en inventario',
  agents: ['agent_abc123'],
  parameters: [
    { name: 'producto', type: 'string', description: 'Nombre del producto' }
  ],
 
  async run(payload, plz) {
    const res = await fetch(`${plz.env.API_URL}/stock?q=${payload.producto}`)
    return await res.json()
  }
})

// DEPLOY

$ plazbot workers deploy
→ Deployed to https://api.plazbot.com/api/worker/execute
└── docs.plazbot.com/guides/agents/workers/tipos

// LAYER 03 · API

api.plazbot.com

REST sobre HTTPS. JWT en Authorization. Workspace en x-workspace-id. Multi-región LA y EU.

// LATAM
api.plazbot.com
// EUROPA
apieu.plazbot.com
send-whatsapp.sh
Bash
1
2
3
4
5
6
7
8
9
$ curl https://api.plazbot.com/v2/whatsapp/send \
    -H "Authorization: Bearer $PLAZBOT_TOKEN" \
    -H "x-workspace-id: $WORKSPACE_ID" \
    -H "Content-Type: application/json" \
    -d '{
      "to": "+51912345678",
      "template": "welcome_onboarding",
      "variables": { "CONTACT_NAME": "Carlos" }
    }'

// ENDPOINTS WHATSAPP

GET/conversation/campaign
POST/conversation/campaign
POST/conversation/campaign/validate-data
POST/conversation/campaign/{id}/cancel
GET/conversation/campaign/{id}/records
GET/api/template/sync-status
POST/whatsapp/send
└── See full API reference

// LAYER 03 · WEBHOOKS

webhooks

Eventos en tiempo real. Configura URLs por workspace para recibir notificaciones de mensajes, contactos y conversaciones.

// MESSAGES
message.received→mensaje entrante
message.sent→mensaje saliente confirmado
message.delivered→entrega confirmada
message.read→lectura confirmada
// CONTACTS
contact.created→nuevo contacto
contact.existing→contacto re-engaged
contact.deleted→contacto eliminado
contact.blocked→contacto bloqueado
contact.from.ad→desde Click-to-WhatsApp
// CONVERSATIONS
conversation.assigned→asignada a agente
conversation.resolved→cerrada
conversation.reopened→reabierta
webhook-receiver.ts
TypeScript
1
2
3
4
5
6
7
8
9
10
// webhook-receiver.ts (Express)
app.post("/plazbot-webhook", express.json(), (req, res) => {
  const { event, data } = req.body;
  if (event === "message.received") {
    console.log(`Nuevo mensaje de ${data.contact.phone}`);
  }
  res.status(200).send("ok");
});

Nota técnica: validación HMAC de firma de webhooks aún no implementada. Recomendamos restringir el endpoint receptor a IPs de Plazbot mientras tanto.

// LAYER 04 · TOOLS

developer stack

Herramientas técnicas para construir y depurar integraciones. Sandbox para probar el SDK y monitor para inspeccionar requests y webhooks en tiempo real.

// SANDBOX

playground react

Entorno interactivo con 6 ejemplos del SDK de React. Edita props, ve cambios en vivo y copia snippets listos para tu app.

  • →Vite + React 18 + TypeScript
  • →Plazbot UI Kit pre-cargado
  • →6 ejemplos production-ready

// INSPECTOR

monitor de api

Inspecciona requests HTTP y entregas de webhooks en tiempo real. Status codes, latencias, payloads y reintentos.

  • →Logs de API en vivo
  • →Webhooks con replay y retries
  • →Filtros por método, status y endpoint

// RUNTIME

workers

Funciones serverless con SDK plz.* para automatizar flujos, conectar APIs externas y ejecutar lógica custom sin infraestructura.

  • →SDK plz.* con 8 módulos
  • →Tool, Worker, Sync, Schedule, Webhook
  • →Deploy desde CLI o dashboard

// EVERYTHING CONNECTS

Una sola plataforma.

Plataforma SaaS, SDK, CLI, Workers, API y agentes IA conectados. Construye sobre cualquier capa.

// platform stack — top to bottom6 layers
Plataforma SaaS
Inbox · Campaigns · Contacts
UI
React Agent · Widget · Portal IA
Componentes embebibles
@plazbot/react
SDK · CLI · Workers
TypeScript nativo · deploy desde terminal
npm
API REST + Webhooks
25+ endpoints · 12+ eventos en tiempo real
HTTPS
Agent Orchestrator + Multi-LLM
OpenAI · Claude · Gemini · Pinecone (RAG)
AI
Channels
WhatsApp · IG · FB · Voice · Webchat · Telegram · Email
Meta BSP
●Todo conectado · multi-región LA · EU
read the docs join discord github
plazbot·2026·meta business partner·status:all systems operational