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

IA Agent for Developers

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
create-agent.ts
TypeScript
1
2
3
4
5
6
7
8
9
import { Plazbot } from "plazbot"
const bot = new Plazbot({ apiKey: process.env.PLAZBOT_KEY })
await bot.agent.addAgent({
  name: "Sales Bot",
  prompt: "Eres un asistente de ventas",
  zone: "LA"
})
$✓agent.created·238ms·id: agt_7fb6a3

// 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

  • ├──Crear y configurar agentes IA por codigo (addAgent, updateAgent, deleteAgent)
  • ├──Tool calling con servicios externos (endpoints HTTP, headers, body templates)
  • ├──Acciones automaticas (asignar, cambiar etapa, etiquetar, resolver)
  • ├──Instrucciones, persona, fallbacks y reglas configurables por agente
  • ├──Workers definibles desde SDK (defineTool, defineWorker, defineSync, defineSchedule)
└── See full SDK reference
agent-setup.ts
TypeScript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// agent-setup.ts
import { Plazbot } from "plazbot"
const bot = new Plazbot({ apiKey, workspaceId })
// Crear agente con tool calling
const agent = await bot.agent.addAgent({
  name: "Support Bot",
  prompt: "Eres un asistente de soporte",
  useToolCalling: true,
  zone: "LA"
})
// Conversar con el agente
const res = await bot.agent.onMessage({
  agentId: agent.agentId,
  question: "Estado de mi pedido #1234"
})

// 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