whatalo webhook trigger

Envía un evento webhook de prueba a tu plugin durante el desarrollo local — sin pedidos ni clientes reales.

Sintaxis

whatalo webhook trigger [evento] [opciones]

Opciones

Flag	Tipo	Descripción
`--store <id>`	string	Tienda de desarrollo objetivo que origina el evento
`--list`	boolean	Mostrar todos los eventos disponibles y salir
`--payload <file>`	string	Ruta a un archivo JSON con payload personalizado
`--json`	boolean	Salida del resultado en JSON
`--portal-url <url>`	string	URL del Portal del Desarrollador

Eventos disponibles

Ejecuta whatalo webhook trigger --list para ver todos los eventos.

Categoría	Evento
Pedidos	`ORDER_CREATED`
Pedidos	`ORDER_UPDATED`
Pedidos	`ORDER_CANCELLED`
Productos	`PRODUCT_CREATED`
Productos	`PRODUCT_UPDATED`
Productos	`PRODUCT_DELETED`
Clientes	`CUSTOMER_CREATED`
Clientes	`CUSTOMER_UPDATED`
Checkout	`CHECKOUT_COMPLETED`

whatalo webhook trigger solo funciona contra tiendas de desarrollo. Intentar disparar un webhook contra una tienda de producción devuelve un error 403. Esta restricción se aplica del lado del servidor.

Detalles de entrega

El webhook se entrega al endpoint configurado de tu plugin:

Propiedad	Valor
URL destino	`manifest.webhookUrl` o URL del túnel de la sesión dev activa
Timeout	15 segundos
Header: Firma	`X-Webhook-Signature` (HMAC-SHA256)
Header: Evento	`X-Webhook-Event`
Header: ID	`X-Webhook-ID`

La firma usa el mismo algoritmo que los webhooks reales. Tu archivo src/webhooks/verify.ts (generado por whatalo init) maneja la verificación incluyendo protección anti-replay.

Ejemplos

Listar todos los eventos disponibles:

whatalo webhook trigger --list

Disparar una creación de pedido de prueba:

whatalo webhook trigger ORDER_CREATED

Disparar con una tienda de desarrollo específica:

whatalo webhook trigger ORDER_CREATED --store mi-tienda-dev

Disparar con un payload personalizado desde un archivo:

whatalo webhook trigger ORDER_CREATED --payload ./test-payloads/pedido-grande.json

Disparar y capturar el resultado en JSON:

whatalo webhook trigger CHECKOUT_COMPLETED --json

Payloads personalizados

Por defecto, el CLI envía un payload de muestra realista para cada tipo de evento. Para sobreescribirlo, crea un archivo JSON con la estructura deseada y pásalo con --payload:

{
  "id": "819365047283",
  "total": "199.99",
  "currency": "DOP",
  "status": "confirmed",
  "customer": {
    "name": "María García",
    "email": "[email protected]"
  }
}

whatalo webhook trigger ORDER_CREATED --payload ./mi-payload.json

Comandos relacionados

whatalo logs — Ver logs de entrega de webhooks
whatalo dev — Iniciar el desarrollo local (requerido antes de disparar)