Webhooks (CLI)

O grupo webhooks gerencia os endpoints de webhook e suas entregas: criação, rotação do segredo de assinatura, inspeção das entregas e reenvio.

Endpoint

create recebe o corpo via --data/--file; o secret sai em texto uma única vez, nesta resposta.

# Criar (o secret só aparece aqui)
repass webhooks create --data '{"url":"https://exemplo.com/hooks/repass","subscribedEvents":["conversion.created"]}'

# Listar
repass webhooks list --json

# Buscar
repass webhooks get whep_xxx --json

# Atualizar (parcial: url, descrição, eventos ou status)
repass webhooks update whep_xxx --data '{"status":"disabled"}'

repass webhooks create --json

{
  "id": "whep_xxx",
  "url": "https://exemplo.com/hooks/repass",
  "subscribedEvents": ["conversion.created"],
  "status": "active",
  "secret": "whsec_…",
  …
}

webhooks list é paginado. Veja Paginação para --all e cursores.

webhooks create mostra o secret em claro uma única vez, nesta resposta. Guarde-o na hora, ele não pode ser recuperado depois. Se perder, a alternativa é webhooks rotate-secret para gerar um novo (o antigo para de validar).

Exclusão e rotação de segredo

repass webhooks delete whep_xxx --yes           # exclui o endpoint permanentemente
repass webhooks rotate-secret whep_xxx          # gera um novo secret (também em claro só aqui)

webhooks delete é destructive. Exclui o endpoint permanentemente, sem recuperação. Rode webhooks get whep_xxx e webhooks deliveries whep_xxx antes para conferir o histórico. Em terminal interativo pede confirmação; fora de TTY exige --yes (veja Convenções).

webhooks rotate-secret é sensitive. O novo segredo de assinatura só aparece em claro nesta resposta e não há dry-run. Ao rodar, capture o segredo na hora e atualize o consumidor do webhook em seguida (o segredo antigo deixa de validar).

Entregas, dead-letter e reenvio

# Histórico de entregas (paginado, filtro por status)
repass webhooks deliveries whep_xxx --status failed --json

# Entregas em dead-letter (tentativas esgotadas)
repass webhooks dead-letter whep_xxx --json

# Dispara uma entrega de teste
repass webhooks test whep_xxx

# Reenvia manualmente uma entrega específica (id da ENTREGA, não do endpoint)
repass webhooks replay-delivery whdl_xxx

webhooks deliveries e webhooks dead-letter são paginados. Veja Paginação.

webhooks replay-delivery é sensitive. Reenvia manualmente aquela entrega para o endpoint. Use webhooks deliveries whep_xxx ou webhooks dead-letter whep_xxx para escolher a entrega certa antes.

Para o schema completo de cada corpo (eventos assináveis, status de endpoint e de entrega), consulte a página SDK equivalente (Webhooks) e a Referência da API. Os conceitos estão em Webhooks › Visão geral e Assinatura.

Começando

Convenções

Recursos

Webhooks (CLI)

Endpoint

Exclusão e rotação de segredo

Entregas, dead-letter e reenvio

​Endpoint

​Exclusão e rotação de segredo

​Entregas, dead-letter e reenvio

Endpoint

Exclusão e rotação de segredo

Entregas, dead-letter e reenvio