Usar el Workbench de desarrolladores
El Workbench es la consola para quien integra Cord con otro sistema. Vive dentro de la app, así que revisas tu integración sin salir de donde trabajas.
Abrirlo
- Activa el Modo desarrollador en Tu cuenta › Preferencias. Es una preferencia de tu cuenta, no de la organización.
- Aparece la píldora Desarrolladores en la esquina inferior derecha. Haz clic o pulsa la tecla
W.
Necesitas el permiso Ajustes en la organización. Sin él, el Workbench no aparece.
Qué hay en cada pestaña
- Resumen: peticiones, tasa de error, latencia, entregas de webhooks, uso de la API del mes y alertas activas.
- Registros: cada petición a la API y al servidor MCP. Busca por ruta, por request id (
req_…) o por código de error, y abre una para ver su detalle, copiarla como cURL o repetirla en el Shell. - Errores: los errores agrupados por código y ruta, con cuántas veces pasó y cómo resolverlo.
- Eventos: lo que pasó en tu cuenta (una cotización pagada, un cliente creado) y lo que Cord entregó a cada endpoint, con la opción de reenviar.
- Webhooks: tus endpoints, su tasa de éxito y el historial de entregas con lo que Cord envió y lo que respondió tu servidor.
- Shell: prueba cualquier operación de la API con tu sesión, sin crear una llave. En Prueba puede crear y modificar datos en tu entorno de prueba; en En vivo solo lee. Te da el código listo en cURL, Node, JavaScript o Python.
- Llaves: crea, rota y revoca llaves de API, y ve las conexiones autorizadas: Zapier, Make, el complemento de Gmail y cualquier app conectada por OAuth.
- Salud: la lista de lo que puede romper tu integración, como un endpoint que falla seguido o una llave a punto de vencer.
En la barra de arriba, el Inspector (tecla /) busca cualquier req_…, evt_… o el ID de una cotización, factura, cliente, producto, llave o webhook.
Qué guarda Cord y por cuánto tiempo
De cada petición a la API, Cord guarda sus datos técnicos: método, ruta, estado, latencia, IP, la llave que la hizo, el request id, el código y el mensaje de error, la versión, el origen y la Idempotency-Key. Nunca guarda el cuerpo de la petición ni de la respuesta, para no almacenar datos de tus clientes.
Los registros se conservan 30 días. Si necesitas más historial, guarda en tu sistema el request id que devuelve cada respuesta en el encabezado Cord-Request-Id.
Preguntas frecuentes
¿El Workbench o el Shell consumen mi cuota de API? No. Solo cuentan las peticiones que haces con llaves en vivo.
No veo una petición que hice con una llave de prueba. El Workbench muestra el entorno en el que está la app. Entra al entorno de prueba para ver lo de tus llaves sk_test_.
¿Por qué no veo el historial de entregas de un webhook? El historial, reintentar y reenviar son parte del plan Profesional o superior.
La guía completa está en la documentación del Workbench.