Con la API de Plazbot conectas tus sistemas: creas contactos, envías mensajes y plantillas de WhatsApp y consultas tus datos desde tu propio código. Para usarla necesitas dos cosas: un token de API y el ID de tu workspace.
1. Abre Developer
Ve a Configuración › Developer. Ahí están los tokens de API, los webhooks, los logs, los recursos y los secrets. Empieza por Tokens de API.
2. Crea un token
Presiona Nuevo Token. El token se crea al instante, con acceso completo y vigencia de un año, y se abre el diálogo Token creado. Presiona Copiar y guárdalo en un lugar seguro, como una variable de entorno o un gestor de secretos.
3. Administra tus tokens
En la lista ves cada token con su fecha de expiración y puedes volver a copiarlo con el ícono de copiar.
El token pertenece a tu usuario: funciona en todos los workspaces donde participas.
Si un token se filtra o ya no lo usas, elimínalo: presiona la papelera, escribe
DELETEy confirma.
4. Recursos y Workspace ID
En la pestaña Recursos tienes los enlaces a la documentación de la API, el SDK y la CLI. Más abajo, en Información del workspace, copia tu Workspace ID: cada llamada lo necesita junto con tu token.
5. Tu primera llamada
Cada petición lleva dos encabezados:
Encabezado | Valor |
|---|---|
|
|
| El ID de tu workspace |
La URL base es https://api.plazbot.com, o https://apieu.plazbot.com si tu cuenta está en Europa.
Ejemplo: enviar una plantilla de WhatsApp.
6. Lee la respuesta
La API responde siempre con el mismo formato:
Muchos errores de negocio (una plantilla que no existe, un campo que falta) llegan con código HTTP 200 y
"success": false. Revisa siempresuccess.Sin token recibes 401.
Sin el encabezado
x-workspace-idrecibes 400.
7. SDK de Node
El SDK te ahorra los encabezados y revisa success por ti: si algo falla, lanza un error.
8. CLI de Plazbot
En tu propia computadora también puedes usar plazbot login; plazbot init es ideal para servidores y CI.