operational·meta business partner·latency p95 142ms·regions LA · EU
~ /developers

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.

└── ver quickstart de 3 pasos ↓
send-whatsapp.ts·typescript
01import { Plazbot } from "plazbot"
02 
03const bot = new Plazbot({
04 apiKey: process.env.PLAZBOT_KEY!,
05 workspaceId: process.env.PLAZBOT_WORKSPACE_ID!,
06 zone: "LA", // "LA" | "EU"
07})
08 
09await bot.message.onConversation({
10 to: "51912345678",
11 template: "welcome",
12 variablesBody: [{ variable: "1", value: "Ana" }],
13})
$message.sent·312ms·id: msg_018f…

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

  1. step [01/03]
    crea tu cuenta y copia credenciales

    Gratis, sin tarjeta. La API key y el workspaceId están en el panel.

    ~/.env·bash
    01# https://app.plazbot.com/signup → panel → developers
    02PLAZBOT_KEY=pk_xxxxxxxxxxxx
    03PLAZBOT_WORKSPACE_ID=ws_xxxxxxxxxxxx
  2. step [02/03]
    instala e inicializa el SDK

    Un solo paquete. Eliges zona (LA / EU) y el host se resuelve solo.

    ~/lib/plazbot.ts·typescript
    01// $ npm install plazbot
    02import { Plazbot } from "plazbot"
    03 
    04export const bot = new Plazbot({
    05 apiKey: process.env.PLAZBOT_KEY!,
    06 workspaceId: process.env.PLAZBOT_WORKSPACE_ID!,
    07 zone: "LA", // "LA" | "EU"
    08})
  3. step [03/03]
    envía tu primer mensaje

    Plantilla aprobada con variables. La respuesta trae messageId para tracking.

    ~/scripts/welcome.ts·typescript
    01import { bot } from "@/lib/plazbot"
    02 
    03const res = await bot.message.onConversation({
    04 to: "51912345678",
    05 template: "welcome",
    06 variablesBody: [{ variable: "1", value: "Ana" }],
    07})
    08 
    09console.log(res.messageId) // → "msg_018f..."

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

~/send-template.ts·ts
01import { bot } from "@/lib/plazbot"
02 
03await bot.message.onConversation({
04 to: "51912345678",
05 template: "welcome",
06 variablesBody: [{ variable: "1", value: "Ana" }],
07})
$ base.url = https://api.plazbot.com | https://apieu.plazbot.com · auth: Bearer + x-workspace-id · api reference ↗

// 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
ver plazbot studio
~ — plazbot studiorepl
$ plazbot studio
plazbot studio — AI REPL · workspace: acme · zone: LA
> /agents
3 agentes · soporte (agt_7fb6a3) · ventas · onboarding
> ¿por qué soporte no respondió anoche?
analicé 42 conversaciones — 3 hallazgos
1. webhook timeout 21:40 · 2. template pausada · 3. rate limit
> /diagnose agt_7fb6a3
>

// 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
api reference ↗

// WEBHOOKS

12+ eventos en tiempo real

  • message.received · contact.created
  • conversation.assigned / resolved
  • payload tipado PlazbotEvent
ver eventos →

// REGIONES

LA · EU

  • api.plazbot.com (Latinoamérica)
  • apieu.plazbot.com (Europa)
  • data residency por zona
docs ↗

// MULTI-LLM

OpenAI · Claude · Gemini

  • elige modelo por agente
  • RAG con Pinecone
  • orquestación multi-agente
sdk docs ↗

// READY

Tu primer mensaje está a 3 pasos.

Cuenta gratis, sin tarjeta. API key en el panel y npm i plazbot en tu terminal.

read the docs