O que é a Workbench e como vejo os eventos, as falhas e os logs da minha integração?
A Workbench é o painel de desenvolvedor da Selectwin. Ela abre por cima de qualquer tela, pelo item Workbench do menu lateral, com webhooks, eventos, entregas com falha, logs e o Inspector.
Atualizado em
A Workbench reúne o que quem integra com a Selectwin precisa acompanhar: os endpoints de webhook, os eventos enviados, as entregas que falharam, os logs da conta e uma busca por qualquer id. Ela abre como uma gaveta por cima da tela em que você está.
Como abrir
- No menu lateral, na parte de baixo, clique em Workbench.
- Ou em Configurações → Desenvolvedores, no card Webhooks, eventos e logs, clique em Abrir.
Use Copiar link para mandar a mesma aba a alguém da equipe. Os botões do topo da gaveta recolhem, maximizam e fecham o painel.
As abas
- Visão geral: as entregas dos últimos 7 dias (Aceitas, Tentando de novo e Não entregues), o que Precisa de atenção, os endpoints e as chaves de API.
- Webhooks: os seus endpoints — criar, editar, testar e trocar o segredo. Veja como configurar webhooks.
- Eventos: todos os eventos enviados. Filtre pelo id do evento ou do recurso, pelo tipo e pelo período. Abra um evento para ver as entregas e os dados, e use Reenviar para todos para mandar de novo.
- Falhas: as Entregas com falha — o que o seu endpoint não aceitou. Tentamos de novo por até 3 dias; depois disso, use Reenviar o evento.
- Logs: tudo o que mudou algo na sua conta, pela API ou pelo painel — quem fez, o quê, quando e de qual IP. Consultas não entram.
- Inspector: cole um id — de uma cobrança (
tra_…), assinatura (subs_…), cliente (cus_…), evento de webhook (wbh_…) e outros — e clique em Inspecionar para ver o objeto, os eventos de webhook dele e as mudanças registradas.
Bom saber
- Os dados são do ambiente em que o painel está. Para ver os testes, mude o painel para Sandbox. Veja como funciona o Sandbox.
- Todos os papéis abrem a Workbench. Criar endpoint, enviar teste, reenviar e trocar o segredo é para Proprietário, Administrador e Gerente.
- Os envios de mensagens do SmartOps não ficam na Workbench: eles estão em SmartOps → Envios.
- As chaves de API ficam em Configurações → Desenvolvedores. Veja onde pegar as chaves.
Veja também
- Como automatizo pagamentos com o n8n?No seu n8n autogerenciado, instale o pacote n8n-nodes-selectwin, crie a credencial Selectwin API com a sua chave e use os nós Selectwin e Selectwin Trigger.
- Onde pego as chaves de API e como testo no sandbox?Em Configurações → Desenvolvedores. Para testar, mude o painel para Sandbox e gere uma chave sk_test_: a URL da API é a mesma, só a chave muda.
- Como aceito chamadas da API só de alguns IPs?Em Configurações → Desenvolvedores, em IPs que podem usar a API, ligue Aceitar a API só destes IPs e adicione os IPs ou as faixas dos seus servidores. Chamadas de outro IP são recusadas.
Ainda precisa de ajuda?
Fale com o seu gerente de conta pelo WhatsApp ou e-mail, de segunda a sexta, das 8h às 18h.