Eventos de Webhook

Lista de todos los eventos disponibles.

Búsqueda

`search.completed`

Se dispara cuando un usuario realiza una búsqueda.

{
  "id": "evt_123",
  "type": "search.completed",
  "created": "2024-01-15T10:30:00Z",
  "data": {
    "searchLogId": "log_abc123",
    "query": "zapatillas running",
    "resultsCount": 25,
    "queryTimeMs": 45,
    "filters": {
      "categories": ["deportes"],
      "priceMax": 150
    }
  }
}

`search.zero_results`

Cuando una búsqueda no devuelve resultados.

{
  "id": "evt_124",
  "type": "search.zero_results",
  "created": "2024-01-15T10:31:00Z",
  "data": {
    "searchLogId": "log_abc124",
    "query": "producto inexistente",
    "suggestedQueries": ["producto similar", "alternativa"]
  }
}

Productos

`product.clicked`

Cuando un usuario hace clic en un resultado de búsqueda.

{
  "id": "evt_125",
  "type": "product.clicked",
  "created": "2024-01-15T10:32:00Z",
  "data": {
    "searchLogId": "log_abc123",
    "productId": "prod_456",
    "position": 3,
    "query": "zapatillas running"
  }
}

`product.synced`

Cuando se sincroniza un producto.

{
  "id": "evt_126",
  "type": "product.synced",
  "created": "2024-01-15T10:33:00Z",
  "data": {
    "productId": "prod_456",
    "externalId": "SKU-001",
    "action": "created" // created | updated | deleted
  }
}

Suscripción

`subscription.created`

Nueva suscripción activa.

{
  "id": "evt_127",
  "type": "subscription.created",
  "created": "2024-01-15T10:34:00Z",
  "data": {
    "subscriptionId": "sub_789",
    "plan": "GROWTH",
    "billingCycle": "MONTHLY"
  }
}

`subscription.cancelled`

Suscripción cancelada.

{
  "id": "evt_128",
  "type": "subscription.cancelled",
  "created": "2024-01-15T10:35:00Z",
  "data": {
    "subscriptionId": "sub_789",
    "reason": "user_requested",
    "effectiveDate": "2024-02-15T00:00:00Z"
  }
}

Uso

`usage.limit_approaching`

Cuando el uso se acerca al límite (80%).

{
  "id": "evt_129",
  "type": "usage.limit_approaching",
  "created": "2024-01-15T10:36:00Z",
  "data": {
    "metric": "searches",
    "current": 4000,
    "limit": 5000,
    "percentage": 80
  }
}

`usage.limit_exceeded`

Cuando se excede el límite.

{
  "id": "evt_130",
  "type": "usage.limit_exceeded",
  "created": "2024-01-15T10:37:00Z",
  "data": {
    "metric": "searches",
    "current": 5100,
    "limit": 5000,
    "overage": 100
  }
}

Filtrar eventos

Puedes suscribirte solo a eventos específicos en el Dashboard.

Categoría	Eventos
Búsqueda	`search.completed`, `search.zero_results`
Productos	`product.clicked`, `product.synced`
Suscripción	`subscription.created`, `subscription.cancelled`
Uso	`usage.limit_approaching`, `usage.limit_exceeded`

Búsqueda​

search.completed​

search.zero_results​

Productos​

product.clicked​

product.synced​

Suscripción​

subscription.created​

subscription.cancelled​

Uso​

usage.limit_approaching​

usage.limit_exceeded​

Filtrar eventos​