Usar o Workbench de desenvolvedores

O Workbench é o console para quem integra o Cord com outro sistema. Ele fica dentro do app, então você revisa a sua integração sem sair de onde trabalha.

Abrir

1. Ative o Modo desenvolvedor em Sua conta › Preferências. É uma preferência da sua conta, não da organização.
2. A pílula Desenvolvedores aparece no canto inferior direito. Clique nela ou pressione a tecla W.

Você precisa da permissão Configurações na organização. Sem ela, o Workbench não aparece.

O que há em cada aba

• Visão geral: requisições, taxa de erro, latência, entregas de webhooks, uso da API no mês e alertas ativos.
• Logs: cada requisição à API e ao servidor MCP. Busque por rota, por request id (req_…) ou por código de erro, e abra uma para ver o detalhe, copiá-la como cURL ou repeti-la no Shell.
• Erros: os erros agrupados por código e rota, com quantas vezes aconteceram e como resolvê-los.
• Eventos: o que aconteceu na sua conta (um orçamento pago, um cliente criado) e o que o Cord entregou a cada endpoint, com a opção de reenviar.
• Webhooks: os seus endpoints, a taxa de sucesso deles e o histórico de entregas com o que o Cord enviou e o que o seu servidor respondeu.
• Shell: teste qualquer operação da API com a sua sessão, sem criar uma chave. Em Teste, ele pode criar e modificar dados no seu ambiente de teste; em Produção, só lê. Ele entrega o código pronto em cURL, Node, JavaScript ou Python.
• Chaves: crie, troque e revogue chaves de API, e veja as conexões autorizadas: Zapier, Make, o complemento do Gmail e qualquer app conectado por OAuth.
• Saúde: a lista do que pode quebrar a sua integração, como um endpoint que falha com frequência ou uma chave prestes a vencer.

Na barra de cima, o Inspetor (tecla /) busca qualquer req_…, evt_… ou o ID de um orçamento, fatura, cliente, produto, chave ou webhook.

O que o Cord guarda e por quanto tempo

De cada requisição à API, o Cord guarda os dados técnicos: método, rota, status, latência, IP, a chave que a fez, o request id, o código e a mensagem de erro, a versão, a origem e a Idempotency-Key. Nunca guarda o corpo da requisição nem da resposta, para não armazenar dados dos seus clientes.

Os logs são mantidos por 30 dias. Se você precisa de mais histórico, guarde no seu sistema o request id que cada resposta devolve no cabeçalho Cord-Request-Id.

Perguntas frequentes

O Workbench ou o Shell consomem a minha cota de API? Não. Só contam as requisições feitas com chaves de produção.

Não vejo uma requisição que fiz com uma chave de teste. O Workbench mostra o ambiente em que o app está. Entre no ambiente de teste para ver o que as suas chaves sk_test_ fizeram.

Por que não vejo o histórico de entregas de um webhook? O histórico, as novas tentativas e o reenvio fazem parte do plano Profissional ou superior.

O guia completo está na documentação do Workbench.