Catálogo de eventos

Esta página se genera desde el catálogo que sirve GET /api/v1/webhooks/events. No puede describir un evento que no existe, y solo queda vieja si el catálogo queda viejo.

El capítulo que explica cómo suscribirse, verificar la firma y revisar las entregas está aquí.

El sobre

Todo evento llega con el mismo cuerpo. Los campos de abajo son el sobre; data cambia según el evento, y llega solo cuando la suscripción lo pidió y su dueño puede leerlo.

Aviso o datos

Cada entrega trae exactamente uno de data o data_omitted. Estos son los dos modos y todas las razones por las que data puede no venir:

Los headers

La firma

hmac-sha256, t=<unix>,v1=<hex>.

Ventana de repetición: 300 segundos. Una firma más vieja que eso se rechaza.

Verificar, en pseudocódigo

const [ts, sig] = parseHeader('X-Webhook-Signature');  // 't=…,v1=…'
const expected = hmac_sha256(secret, ts + '.' + rawBody);  // hex
if (!timing_safe_equal(sig.v1, expected)) reject(401);
if (Math.abs(now_unix() - ts) > 300) reject(401);  // 5-min replay window

Reintentos

Hasta 5 intentos con espera exponencial: 5, 10, 20, 40, 80 segundos entre uno y otro.

All retries reuse the same X-Webhook-Event-Id so your endpoint can be idempotent.

Pausa automática

Una suscripción se pausa sola cuando 20 entregas seguidas agotan sus reintentos, o cuando lleva 24 horas fallando sin una sola respuesta correcta.

A subscription is paused when 20 events in a row exhaust their retries, or when it has failed for 24 hours without a single success. The workspace admins are notified once. A paused subscription receives nothing until POST /webhooks/{id}/resume; events in between are not queued — read the resources to catch up, or redeliver from the delivery log.

Los eventos

Son 156 eventos. El nombre es el valor que va en events al crear la suscripción, y el que llega en X-Webhook-Event.

• campaign.sent
• campaign.paused
• sending_domain.verified
• coach.proposals_ready
• coach.finding_ready
• voice.autonomous_call
• safety_hold.placed
• safety_hold.ack_overdue
• safety_hold.first_response_overdue
• chileautos.lead
• yapo.lead
• website.lead
• consignment.candidate.created
• quote.issued
• quote.voided
• quote.extended
• quote.archived
• reservation.created
• reservation.voided
• reservation.abono_disposed
• reservation.converted
• sale_note.issued
• sale_note.approved
• sale_note.voided
• purchase_note.issued
• purchase_note.corrected
• purchase_note.voided
• payment.recorded
• consignment.created
• consignment.returned
• consignment.sold
• credit_application.recorded
• credit_application.submitted
• credit_application.decided
• credit_application.withdrawn
• price_approval.requested
• price_approval.decided
• conversation.created
• conversation.assigned
• conversation.resolved
• message.received
• message.sent
• ticket.opened
• ticket.reopened
• ticket.resolved
• ticket.closed
• sla.breached
• agent_scenario_run.completed
• agent_scenario_suite.completed
• ai_agent.publish
• ai_agent_graph.publish
• cost.budget_alert
• runtime.budget_exceeded
• kb.source.create
• kb.source.embed
• kb.source.update
• kb.source.delete
• kb_file.uploaded
• kb_file.deleted
• skill.created
• skill.updated
• skill.deleted
• custom_tool.created
• custom_tool.updated
• custom_tool.deleted
• lead.created
• lead.stage_changed
• lead.pipeline_changed
• lead.assigned
• lead.won
• lead.lost
• lead.unqualified
• macro.applied
• stock.source_retired
• stock.synced
• vehicle.published
• vehicle.unpublished
• vehicle.publish_failed
• vehicle.created
• vehicle.attachment.created
• mercadolibre.order
• mercadolibre.vis_lead
• appointment.booked
• appointment.rescheduled
• appointment.cancelled
• appointment.completed
• appointment.no_show
• appointment.reminded
• appointment.imported
• contact.created
• contact.updated
• contact.merged
• team.created
• team.updated
• team.deleted
• custom_role.created
• custom_role.updated
• custom_role.deleted
• macro.created
• clinic_professional.created
• clinic_professional.updated
• clinic_professional.deleted
• clinic_service.created
• macro.updated
• macro.deleted
• assignment_rule.created
• assignment_rule.updated
• assignment_rule.deleted
• sla_policy.created
• sla_policy.updated
• sla_policy.deleted
• automation_trigger.created
• automation_trigger.updated
• automation_trigger.deleted
• sending_domain.created
• sending_domain.deleted
• whatsapp_template.created
• whatsapp_template.status_changed
• whatsapp_template.deleted
• whatsapp_flow.created
• whatsapp_flow.published
• whatsapp_flow.deprecated
• whatsapp_flow.deleted
• channel.connected
• channel.updated
• channel.disconnected
• membership.created
• membership.updated
• membership.removed
• clinic_service.updated
• clinic_service.deleted
• clinic_price_list.updated
• clinic_pack_purchase.created
• clinic_pack_purchase.session_consumed
• clinic_pack_purchase.cancelled
• clinic_budget.created
• clinic_budget.sent
• clinic_budget.accepted
• clinic_budget.rejected
• clinic_budget.voided
• clinic_budget.mirror_changed
• clinic_cash_session.opened
• clinic_cash_session.closed
• clinic_patient.created
• clinic_patient.updated
• clinic_patient.deleted
• clinic_patient.merged
• clinic_encounter.opened
• clinic_encounter.closed
• clinic_note.signed
• clinic_note.amended
• clinic_consent.signed
• clinic_consent.revoked
• clinic_document.uploaded
• clinic_document.deleted
• clinic_privacy_request.completed

campaign.sent

A campaign finished sending — every recipient reached a terminal pre-delivery state (sent/failed/suppressed).

Versión 1 · Recurso campaign · data requiere campaigns:read

Cuándo se dispara. The campaign worker drains the last pending recipient and flips the campaign to status=sent.

{
  "campaign_id": "0d9b2a4e-1f6c-4e7a-9b3d-5c8e2f1a6b4d",
  "name": "Reactivación de clientes abril",
  "channel": "whatsapp",
  "total_recipients": 1240,
  "sent": 1198,
  "failed": 17,
  "suppressed": 25,
  "finished_at": "2026-06-11T15:04:05Z"
}

campaign.paused

A sending campaign was paused automatically — the WhatsApp number hit its Meta messaging limit, or the email reputation guard tripped (ADR 0032: >8% hard bounces or >0.3% complaints after 200 sends; also blocks the tenant email channel).

Versión 1 · Recurso campaign · data requiere campaigns:read

Cuándo se dispara. A campaign send gets a rate/messaging-limit error from Atribu/Meta (auto-probes hourly), or the SES event ingest crosses a reputation threshold.

{
  "campaign_id": "0d9b2a4e-1f6c-4e7a-9b3d-5c8e2f1a6b4d",
  "name": "Reactivación de clientes abril",
  "reason": "messaging_limit"
}

sending_domain.verified

A tenant email sending domain finished DKIM verification and can now send email campaigns (ADR 0032).

Versión 1 · Recurso sending_domain · data requiere messaging_accounts:read

Cuándo se dispara. A sending-domain refresh observes SES flip VerifiedForSendingStatus to true for the first time.

{
  "id": "7f2c1b9e-3a5d-4c8e-9f1a-2b6d4e8c0a3f",
  "domain": "mail.cliente.cl"
}

coach.proposals_ready

Conversation Coach generated new improvement proposals for an agent — route to Slack/email/etc. to alert the agent owner.

Versión 1 · Recurso ai_agent · data requiere ai_agents:read

Cuándo se dispara. A finding investigation or a correction synthesis persisted at least one improvement_proposal.

{
  "ai_agent_id": "4ce54eaf-…",
  "finding_id": "00000000-…-0000000f1nd1",
  "source": "investigation",
  "proposals": 3
}

coach.finding_ready

The conversation reviewer detected a RECURRING issue with an agent (Mejoras, ADR 0095) — «promete descuentos que no existen», with an occurrence count — one step before anybody proposes a fix for it.

Versión 1 · Recurso ai_agent · data requiere ai_agents:read

Cuándo se dispara. A conversation review created or bumped a finding.

{
  "ai_agent_id": "4ce54eaf-…",
  "findings": [
    {
      "id": "00000000-…-0000000f1nd1",
      "kind": "missing_knowledge",
      "topic_key": "financiamiento.pie_minimo",
      "title": "No sabe responder por el pie mínimo",
      "occurrence_count": 7,
      "status": "open"
    }
  ],
  "source": "review"
}

voice.autonomous_call

A proactive/autonomous voice agent initiated an outbound speed-to-lead call on its own (ADR-0016) — route to Slack/email so a human is aware ("warn and be careful").

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. A new lead arrives and the tenant's voice agent autonomy_level is proactive or autonomous and all guardrails pass.

{
  "lead_id": "4ce54eaf-…",
  "contact_id": "00000000-…",
  "agent_id": "a1b2…",
  "autonomy_level": "proactive"
}

safety_hold.placed

A clinical SAFETY HOLD was placed on a contact: proactive messaging to that person is blocked until a named human acknowledges and resolves it. Opt-in per tenant (clinical_safety.operational_alert_webhook).

Versión 1 · Recurso outbound_hold · data requiere outbound_holds:read

Dato sensible: llega siempre como aviso, sin data, pida lo que pida la suscripción.

Cuándo se dispara. The service-lifecycle evaluator decides a patient reply requires professional attention, or an operator places a hold by hand. Fires once per hold — a re-raised concern deduplicates onto the live hold.

{
  "hold_id": "018f…",
  "contact_id": "9a1c…",
  "scope": "contact",
  "kind": "safety",
  "reason": "the patient reports worsening swelling",
  "placed_at": "2027-02-09T14:03:11.000Z",
  "stepKey": "check_in_24h",
  "ticketId": "T-1247",
  "ackMinutes": 15
}

safety_hold.ack_overdue

Nobody acknowledged a safety hold within the tenant's acknowledgement target (D6 default: 15 minutes of declared coverage). The backup has been paged.

Versión 1 · Recurso outbound_hold · data requiere outbound_holds:read

Dato sensible: llega siempre como aviso, sin data, pida lo que pida la suscripción.

Cuándo se dispara. The safety-hold SLA sweep (5-min tick) finds a hold still in active past its ack target. Fires once per hold.

{
  "hold_id": "018f…",
  "contact_id": "9a1c…",
  "eventType": "ack_overdue",
  "targetMinutes": 15,
  "elapsedMinutes": 22,
  "withinCoverage": true
}

safety_hold.first_response_overdue

No human wrote to the patient within the first-response target (D6 default: 60 minutes of declared coverage) after a safety hold was placed. A durable breach row was recorded.

Versión 1 · Recurso outbound_hold · data requiere outbound_holds:read

Dato sensible: llega siempre como aviso, sin data, pida lo que pida la suscripción.

Cuándo se dispara. The safety-hold SLA sweep finds no human outbound message to the contact dated after the hold was placed, past the first-response target. Fires once per hold.

{
  "hold_id": "018f…",
  "contact_id": "9a1c…",
  "eventType": "first_response_overdue",
  "targetMinutes": 60,
  "elapsedMinutes": 74,
  "withinCoverage": true
}

chileautos.lead

A buyer lead arrived from Chileautos ("envío de leads") and was ingested as a Vitrina lead.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. The Chileautos leads webhook (POST /integrations/chileautos/leads) is processed by the worker.

{
  "lead_id": "7c1f0e2a-6b3d-4a9e-8f12-2b9a1c0d4e5f",
  "contact_id": "4821",
  "vehicle_id": "a35d4ff0-8612-4ff0-8612-a8ee57f4f095",
  "source": "chileautos",
  "chileautos_lead_identifier": "88d404ca-a35d-4ff0-8612-a8ee57f4f095",
  "chileautos_status": "New"
}

yapo.lead

A buyer lead arrived from Yapo.cl and was ingested as a Vitrina lead.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. The per-account yapo leads webhook (POST /integrations/yapo/leads/:accountId/:token) is processed by the worker.

{
  "lead_id": "7c1f0e2a-6b3d-4a9e-8f12-2b9a1c0d4e5f",
  "contact_id": "4821",
  "vehicle_id": "a35d4ff0-8612-4ff0-8612-a8ee57f4f095",
  "yapo_lead_id": "90815723",
  "yapo_ad_id": "75481920"
}

website.lead

A buyer inquiry arrived through a dealer website's "Consulta del sitio" form and was ingested as a Vitrina lead.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. POST /api/v1/website-leads (Bearer api_key, scope leads:intake) is processed.

{
  "lead_id": "7c1f0e2a-6b3d-4a9e-8f12-2b9a1c0d4e5f",
  "contact_id": "4821",
  "conversation_id": "9b1e2a4e-1f6c-4e7a-9b3d-5c8e2f1a6b4d",
  "vehicle_id": "a35d4ff0-8612-4ff0-8612-a8ee57f4f095",
  "submission_id": "3f7a1c9e2b4d5f6a7b8c9d0e1f2a3b4c",
  "intent": "sell"
}

consignment.candidate.created

A private owner offered their car through a dealer website's "vende tu auto" form and the submission landed as a consignment candidate.

Versión 1 · Recurso consignment_candidate · data requiere consignments:read

Cuándo se dispara. POST /api/v1/widget/consignments (publishable pk_ key, origin-locked, scope leads:intake) is processed. A honeypot-tripped or duplicate submission fires nothing.

{
  "candidate_id": "d41f2b8e-5a17-4c93-8b0e-6f1a2c3d4e5f",
  "patente": "KXTR52",
  "make": "Toyota",
  "model": "Yaris",
  "year": 2019,
  "kilometers": 68000,
  "expected_price_clp": 9500000,
  "sale_horizon": "15d",
  "region_code": "13",
  "photo_count": 3,
  "submission_id": "8b1c0a5d7e2f4a6b9c3d0e1f2a3b4c5d"
}

quote.issued

A cotización was issued — a price offer on a unit, frozen at issuance and holding no reservation on the car.

Versión 1 · Recurso quote · data requiere quotes:read

Cuándo se dispara. POST /api/v1/quotes.

{
  "id": "d2d2d2d2-0000-4000-8000-000000000001",
  "display_id": "Q-47",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "buyer_contact_id": "22222222-0000-4000-8000-000000000002",
  "salesperson_id": "11111111-0000-4000-8000-000000000001",
  "offered_price_clp": 11900000,
  "tax_treatment": "afecto",
  "expires_on": "2026-09-23",
  "state": "vigente"
}

quote.voided

A cotización was voided. Terminal — a voided quote is never restored.

Versión 1 · Recurso quote · data requiere quotes:read

Cuándo se dispara. POST /api/v1/quotes/{id}/void.

{
  "id": "d2d2d2d2-0000-4000-8000-000000000002",
  "display_id": "Q-52",
  "void_reason": "el cliente desistió de la compra",
  "voided_by": "11111111-0000-4000-8000-000000000001",
  "voided_at": "2026-09-15T11:20:03.000Z"
}

quote.extended

A cotización’s validity window was moved to a new date, including bringing an expired one back to vigente.

Versión 1 · Recurso quote · data requiere quotes:read

Cuándo se dispara. POST /api/v1/quotes/{id}/extend.

{
  "id": "d2d2d2d2-0000-4000-8000-000000000001",
  "display_id": "Q-47",
  "expires_on": "2026-10-20",
  "extend_reason": "el cliente sigue esperando la aprobación del crédito",
  "extended_by": "11111111-0000-4000-8000-000000000001",
  "extended_at": "2026-09-20T09:11:44.000Z"
}

quote.archived

A cotización was filed away from the working register. Not a delete and not a state — its folio and state are unchanged.

Versión 1 · Recurso quote · data requiere quotes:read

Cuándo se dispara. POST /api/v1/quotes/{id}/archive.

{
  "id": "d2d2d2d2-0000-4000-8000-000000000003",
  "display_id": "Q-31",
  "archive_reason": "cotización antigua, ya no vigente en el seguimiento",
  "archived_by": "11111111-0000-4000-8000-000000000001",
  "archived_at": "2026-09-10T08:00:00.000Z"
}

reservation.created

A reserva took a hold on a unit — the only Wave 2a document that locks inventory.

Versión 1 · Recurso reservation · data requiere reservations:read

Cuándo se dispara. POST /api/v1/reservations.

{
  "id": "d3d3d3d3-0000-4000-8000-000000000001",
  "display_id": "R-18",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "holder_contact_id": "22222222-0000-4000-8000-000000000002",
  "salesperson_id": "11111111-0000-4000-8000-000000000001",
  "agreed_price_clp": 11900000,
  "hold_expires_on": "2026-09-25",
  "status": "activa"
}

reservation.voided

A reserva was voided, releasing the hold on the unit for good.

Versión 1 · Recurso reservation · data requiere reservations:read

Cuándo se dispara. POST /api/v1/reservations/{id}/void.

{
  "id": "d3d3d3d3-0000-4000-8000-000000000002",
  "display_id": "R-22",
  "void_reason": "el cliente no completó el pago del abono a tiempo",
  "voided_by": "11111111-0000-4000-8000-000000000001",
  "voided_at": "2026-09-20T10:05:00.000Z"
}

reservation.abono_disposed

The deposit on a closed reserva was disposed of — kept, refunded or applied.

Versión 1 · Recurso reservation · data requiere reservations:read

Cuándo se dispara. POST /api/v1/reservations/{id}/abono-disposition.

{
  "id": "d3d3d3d3-0000-4000-8000-000000000001",
  "display_id": "R-18",
  "abono_disposition": "devuelto",
  "abono_disposition_reason": "el cliente desistió; se devolvió el abono",
  "abono_disposition_by": "11111111-0000-4000-8000-000000000001",
  "abono_disposition_at": "2026-09-21T09:00:00.000Z"
}

reservation.converted

A reserva was converted into a nota de venta, closing the hold and carrying its payments onto the new document.

Versión 1 · Recurso reservation · data requiere reservations:read

Cuándo se dispara. POST /api/v1/reservations/{id}/convert.

{
  "id": "d3d3d3d3-0000-4000-8000-000000000001",
  "display_id": "R-18",
  "sale_note_id": "d4d4d4d4-0000-4000-8000-000000000001",
  "sale_note_display_id": "V-118"
}

sale_note.issued

A nota de venta was issued, allocating its folio.

Versión 1 · Recurso sale_note · data requiere sale_notes:read

Cuándo se dispara. POST /api/v1/sale-notes.

{
  "id": "d4d4d4d4-0000-4000-8000-000000000001",
  "display_id": "V-118",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000002",
  "buyer_contact_id": "22222222-0000-4000-8000-000000000002",
  "net_clp": 11900000,
  "tax_clp": 1900000,
  "tax_treatment": "afecto",
  "status": "issued"
}

sale_note.approved

A nota de venta was approved — the instant it becomes legally valid, the car is marked sold and its deal closes won.

Versión 1 · Recurso sale_note · data requiere sale_notes:read

Cuándo se dispara. POST /api/v1/sale-notes/{id}/approve.

{
  "id": "d4d4d4d4-0000-4000-8000-000000000001",
  "display_id": "V-118",
  "approved_by": "11111111-0000-4000-8000-000000000001",
  "approved_at": "2026-09-19T14:10:00.000Z"
}

sale_note.voided

A nota de venta was voided.

Versión 1 · Recurso sale_note · data requiere sale_notes:read

Cuándo se dispara. POST /api/v1/sale-notes/{id}/void.

{
  "id": "d4d4d4d4-0000-4000-8000-000000000001",
  "display_id": "V-118",
  "void_reason": "el banco rechazó el financiamiento del comprador",
  "voided_by": "11111111-0000-4000-8000-000000000001",
  "voided_at": "2026-09-20T09:00:00.000Z"
}

purchase_note.issued

A nota de compra was issued — the instrument that creates a vehicle’s cost basis.

Versión 1 · Recurso purchase_note · data requiere purchase_notes:read

Cuándo se dispara. POST /api/v1/purchase-notes.

{
  "id": "d5d5d5d5-0000-4000-8000-000000000001",
  "display_id": "P-9",
  "seller_contact_id": "22222222-0000-4000-8000-000000000003",
  "net_clp": 6200000,
  "tax_treatment": "no_gravado",
  "status": "issued"
}

purchase_note.corrected

A live nota de compra was corrected, stamped with who changed it.

Versión 1 · Recurso purchase_note · data requiere purchase_notes:read

Cuándo se dispara. PATCH /api/v1/purchase-notes/{id}.

{
  "id": "d5d5d5d5-0000-4000-8000-000000000001",
  "display_id": "P-9",
  "corrected_by": "11111111-0000-4000-8000-000000000001",
  "corrected_at": "2026-09-13T09:00:00.000Z"
}

purchase_note.voided

A nota de compra was voided.

Versión 1 · Recurso purchase_note · data requiere purchase_notes:read

Cuándo se dispara. POST /api/v1/purchase-notes/{id}/void.

{
  "id": "d5d5d5d5-0000-4000-8000-000000000001",
  "display_id": "P-9",
  "void_reason": "se anuló la compra: el vendedor desistió antes de firmar",
  "voided_by": "11111111-0000-4000-8000-000000000001",
  "voided_at": "2026-09-14T11:30:00.000Z"
}

payment.recorded

A payment was recorded against a reservation or a nota de venta.

Versión 1 · Recurso document_payment · data requiere document_payments:read

Cuándo se dispara. POST /api/v1/document-payments (deprecated door) or POST /api/v1/payments.

{
  "id": "d6d6d6d6-0000-4000-8000-000000000001",
  "reservation_id": "d3d3d3d3-0000-4000-8000-000000000001",
  "sale_note_id": null,
  "instrument": "transferencia",
  "amount_clp": 300000,
  "paid_on": "2026-09-18"
}

consignment.created

A consignment contract was created — the vehicle’s tenencia becomes consignacion.

Versión 1 · Recurso consignment_contract · data requiere consignments:read

Cuándo se dispara. POST /api/v1/consignments or POST /api/v1/consignments/bulk.

{
  "id": "d7d7d7d7-0000-4000-8000-000000000001",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "dueno_contact_id": "22222222-0000-4000-8000-000000000004",
  "modalidad": "en_local",
  "comision_type": "percentage",
  "comision_value": 10,
  "minimo_clp": 8000000,
  "estado": "activo"
}

consignment.returned

A consignment contract was returned — the car goes back to its owner and its tenencia becomes propio.

Versión 1 · Recurso consignment_contract · data requiere consignments:read

Cuándo se dispara. POST /api/v1/consignments/{id}/return or PATCH .../{id} with estado: "devuelto".

{
  "id": "d7d7d7d7-0000-4000-8000-000000000001",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "estado": "devuelto"
}

consignment.sold

A consigned car was sold and settled with its owner — the contract moves to vendido and produces a Liquidación.

Versión 1 · Recurso consignment_contract · data requiere consignments:read

Cuándo se dispara. POST /api/v1/consignments/{id}/sell.

{
  "id": "d7d7d7d7-0000-4000-8000-000000000001",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "liquidacion_id": "d8d8d8d8-0000-4000-8000-000000000001",
  "amount_venta_clp": 8900000,
  "comision_amount_clp": 890000,
  "monto_owner_clp": 8010000
}

credit_application.recorded

A credit application dossier was recorded.

Versión 1 · Recurso credit_application · data requiere credit_applications:read

Cuándo se dispara. POST /api/v1/credit-applications.

{
  "id": "d9d9d9d9-0000-4000-8000-000000000001",
  "display_id": "F-12",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "buyer_contact_id": "22222222-0000-4000-8000-000000000002",
  "institution_id": "dadadada-0000-4000-8000-000000000001",
  "requested_amount_clp": 9500000,
  "state": "recorded"
}

credit_application.submitted

A credit application’s carpeta was recorded as sent to the lender.

Versión 1 · Recurso credit_application · data requiere credit_applications:read

Cuándo se dispara. POST /api/v1/credit-applications/{id}/submission.

{
  "id": "d9d9d9d9-0000-4000-8000-000000000001",
  "display_id": "F-12",
  "submitted_by": "11111111-0000-4000-8000-000000000001",
  "submitted_at": "2026-09-10T14:00:00.000Z"
}

credit_application.decided

The lender’s verdict was recorded on a credit application.

Versión 1 · Recurso credit_application · data requiere credit_applications:read

Cuándo se dispara. POST /api/v1/credit-applications/{id}/decision.

{
  "id": "d9d9d9d9-0000-4000-8000-000000000001",
  "display_id": "F-12",
  "outcome": "approved",
  "approved_amount_clp": 9200000,
  "decided_by": "11111111-0000-4000-8000-000000000001",
  "decided_at": "2026-09-16T10:00:00.000Z"
}

credit_application.withdrawn

A credit application was pulled by the dealership — terminal.

Versión 1 · Recurso credit_application · data requiere credit_applications:read

Cuándo se dispara. POST /api/v1/credit-applications/{id}/withdrawal.

{
  "id": "d9d9d9d9-0000-4000-8000-000000000001",
  "display_id": "F-12",
  "withdrawn_reason": "el cliente obtuvo mejores condiciones en otra financiera",
  "withdrawn_by": "11111111-0000-4000-8000-000000000001",
  "withdrawn_at": "2026-09-18T09:00:00.000Z"
}

price_approval.requested

Authority over a below-reference price was requested on a quote, a reservation or a nota de venta.

Versión 1 · Recurso price_approval · data requiere price_approval:read

Cuándo se dispara. POST /api/v1/price-approvals.

{
  "id": "dbdbdbdb-0000-4000-8000-000000000001",
  "quote_id": null,
  "reservation_id": null,
  "sale_note_id": "d4d4d4d4-0000-4000-8000-000000000001",
  "requested_price_clp": 10900000,
  "requester_user_id": "11111111-0000-4000-8000-000000000002",
  "status": "pending"
}

price_approval.decided

A price approval request was granted or rejected. Terminal — no second decision.

Versión 1 · Recurso price_approval · data requiere price_approval:read

Cuándo se dispara. POST /api/v1/price-approvals/{id}/decision.

{
  "id": "dbdbdbdb-0000-4000-8000-000000000001",
  "status": "approved",
  "decision_note": "autorizado por gerencia dado el tiempo en stock",
  "decider_user_id": "11111111-0000-4000-8000-000000000001",
  "decided_at": "2026-09-19T16:05:00.000Z"
}

conversation.created

A new conversation was opened — a customer wrote in on a channel, or the workspace opened the thread from its side.

Versión 1 · Recurso conversation · data requiere conversations:read

Cuándo se dispara. The first inbound message of a thread (any channel), POST /conversations, or a proactive outbound conversation (ADR 0108). NOT on a historical backfill: importing a dealer’s past threads is inert by design, so a coexistence or history sync fires nothing.

{
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "display_id": "C-3052",
  "channel": "whatsapp",
  "contact_id": "22222222-0000-4000-8000-000000000001",
  "messaging_account_id": "16161616-0000-4000-8000-000000000001",
  "ticket_id": null,
  "handler": "bot",
  "status": "open",
  "source": null,
  "created_at": "2026-09-22T11:06:33.744Z"
}

conversation.assigned

A conversation changed hands: a new assignee, a new handler, or both.

Versión 1 · Recurso conversation · data requiere conversations:read

Cuándo se dispara. POST /conversations/:id/assign, /claim, /handoff or /return-to-ai, the assignment rules routing an unowned inbound, and a ticket assignment mirroring onto its conversation. NOT on a no-op (the same assignee and the same handler).

{
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "display_id": "C-3052",
  "from_assignee_user_id": null,
  "to_assignee_user_id": "11111111-0000-4000-8000-000000000001",
  "from_handler": "bot",
  "to_handler": "human",
  "ticket_id": "dddddddd-0000-4000-8000-000000000001"
}

conversation.resolved

A conversation stopped being open work. changes.status.to is resolved (dealt with, reopened by the next inbound message) or closed (terminal).

Versión 1 · Recurso conversation · data requiere conversations:read

Cuándo se dispara. POST /conversations/:id/resolve, POST /conversations/:id/close on a thread that was not already resolved, and the auto-resolve worker. The auto-CLOSE of an already-resolved thread fires nothing: the conclusion was already reported, and reporting the grace window as a second conclusion is the two-events-for-one-action mistake. A ticket.resolved / ticket.closed follows only when no sibling conversation on that ticket is still active.

{
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "display_id": "C-3052",
  "from_status": "open",
  "to_status": "resolved",
  "resolved_by": "human",
  "resolved_at": "2026-09-22T11:15:06.653Z",
  "ticket_id": "dddddddd-0000-4000-8000-000000000001"
}

message.received

The customer sent a message.

Versión 1 · Recurso message · data requiere conversations:read

Cuándo se dispara. A customer message is persisted on any channel. NOT on a history backfill (a coexistence or Instagram history sync writes customer messages with the fan-out switched off, so importing months of threads does not replay months of events), and not for the internal system lines the thread carries for assignments and status changes.

{
  "message_id": "eeeeeeee-0000-4000-8000-000000000001",
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "contact_id": "22222222-0000-4000-8000-000000000001",
  "channel": "whatsapp",
  "type": "text",
  "content": "¿Me pueden confirmar la hora del jueves?",
  "external_message_id": "wamid.HBgLNTY5NzcwMDAwMjE",
  "created_at": "2026-09-22T11:07:02.824Z"
}

message.sent

The workspace sent a message to the customer. The envelope’s author says who wrote it: a member, a member through a connected app or a personal token, an API key, or the AI agent.

Versión 1 · Recurso message · data requiere conversations:read

Cuándo se dispara. An outbound message is persisted — the AI answering, a teammate replying, an API send, a template, a flow, a location pin, an attachment or a voice note. It fires at PERSIST, which on most channels is the moment Vitrina commits to the send rather than the moment the provider confirms it: delivery_status carries what was known then, and a later failure or delivery receipt shows on the message row (GET /conversations/{id}/messages), not as a second event. Internal system lines and internal notes are not messages and fire nothing.

{
  "message_id": "eeeeeeee-0000-4000-8000-000000000002",
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "contact_id": "22222222-0000-4000-8000-000000000001",
  "channel": "whatsapp",
  "type": "text",
  "content": "Hola Rodrigo, te confirmo la visita del jueves a las 10:00.",
  "sender_type": "api_key",
  "delivery_status": "sent",
  "created_at": "2026-09-22T11:08:10.882Z"
}

ticket.opened

A new ticket has been opened on a conversation.

Versión 1 · Recurso ticket · data requiere tickets:read

Cuándo se dispara. POST /conversations/:id/tickets, the open_ticket / handoff tools, or a stale handoff being reopened with a brand-new ticket.

{
  "ticket_id": "dddddddd-0000-4000-8000-000000000001",
  "origin_conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "reason": "El cliente pide reagendar su visita",
  "opened_by": "human",
  "opened_via": "admin_ui",
  "brand": null
}

ticket.reopened

A previously resolved or closed ticket has been reopened.

Versión 1 · Recurso ticket · data requiere tickets:read

Cuándo se dispara. reopenTicket() in the ticket service — typically triggered by new inbound activity on a stale handoff.

{
  "ticket_id": "dddddddd-0000-4000-8000-000000000001",
  "origin_conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "reason": "customer_replied",
  "brand": null
}

ticket.resolved

A ticket has transitioned to status=resolved.

Versión 1 · Recurso ticket · data requiere tickets:read

Cuándo se dispara. PUT /tickets/:id/close (which resolves, despite the path), the auto-resolve worker, and a conversation resolve cascading to its ticket when no sibling conversation is still active. NOT on PUT /tickets/:id/status with status=resolved — that route sets the column without stamping resolved_by/resolved_at, so it has never emitted this.

{
  "ticket_id": "dddddddd-0000-4000-8000-000000000001",
  "origin_conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "resolved_by": "human",
  "resolved_at": "2026-09-22T11:15:06.653Z",
  "brand": null
}

ticket.closed

A ticket has transitioned to status=closed (terminal).

Versión 1 · Recurso ticket · data requiere tickets:read

Cuándo se dispara. A conversation is closed (auto-close worker after the grace window, or a manual close) and no other open conversation holds the ticket.

{
  "ticket_id": "dddddddd-0000-4000-8000-000000000001",
  "origin_conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "closed_by": "auto",
  "brand": null
}

sla.breached

An open ticket crossed an applicable SLA policy target (first response or resolution). Fired once per (ticket, policy, breach type).

Versión 1 · Recurso ticket · data requiere tickets:read

Cuándo se dispara. The SLA monitor worker (10-min tick) detects a newly-breached open ticket. Business hours are honoured when the policy is business_hours_only.

{
  "ticket_id": "9b1c…",
  "ticket_display_id": "T-1247",
  "policy_id": "ec95…",
  "policy_name": "Soporte estándar",
  "breach_type": "resolution",
  "target_minutes": 1440,
  "elapsed_seconds": 95400,
  "assignee": "Paulina Rojas",
  "breached_at": "2026-06-07T18:20:00.000Z"
}

agent_scenario_run.completed

An Agent Evals scenario run reached a terminal VERDICT (passed | partial | failed | error) — ADR 0098. A cancelled run does not fire it: the configuration moved under the run (or a human stopped it), so there is no result to report and a mass cancellation would otherwise be one webhook per run.

Versión 1 · Recurso agent_scenario_run · data requiere ai_agents:read

Cuándo se dispara. The scenario-run worker finishes a run queued by POST /ai-agents/:id/scenarios/run, a single-scenario run, or a publish.

{
  "run_id": "3c1e2d4f-…",
  "scenario_id": "9a7b6c5d-…",
  "scenario_display_id": "EV-12",
  "ai_agent_id": "7c2e3a0e-…",
  "agent_version_kind": "draft",
  "batch_id": "b1a2c3d4-…",
  "status": "failed",
  "score": 0,
  "hard_fails": [
    {
      "id": "grounded-3",
      "kind": "grounded",
      "evidence": "turn 1: not in any tool result → 10:20"
    }
  ],
  "duration_ms": 48210
}

agent_scenario_suite.completed

An Agent Evals SUITE run finished — every scenario run in its batch reached a terminal status (ADR 0098 phase 1B).

Versión 1 · Recurso agent_scenario_suite_run · data requiere ai_agents:read

Cuándo se dispara. The last run of the suite's batch finishes, whatever started it: POST /ai-agents/:id/scenario-suites/:suiteId/run, the nightly cron, or a publish of an agent that has a golden suite. Exactly once per suite run — the completion flip is a conditional update.

{
  "suite_run_id": "5f6e7d8c-…",
  "suite_id": "1a2b3c4d-…",
  "suite_name": "Golden",
  "kind": "golden",
  "ai_agent_id": "7c2e3a0e-…",
  "batch_id": "b1a2c3d4-…",
  "trigger": "cron",
  "agent_version_kind": "live",
  "agent_version_number": 41,
  "summary": {
    "n": 66,
    "passed": 54,
    "partial": 7,
    "failed": 4,
    "error": 1,
    "hard_fails": 4,
    "pass_rate": 83.1,
    "flaky": 2,
    "cost_usd": 1.842,
    "duration_ms": 412000
  },
  "delta": {
    "pass_rate": -3.1,
    "vs_suite_run_id": "4e5d6c7b-…"
  }
}

ai_agent.publish

An AI agent draft has been published as the live config.

Versión 1 · Recurso ai_agent · data requiere ai_agents:read

Cuándo se dispara. POST /ai-agents/:id/publish.

{
  "ai_agent_id": "7c2e3a0e-…",
  "name": "Soporte Vitrina",
  "updated_at": "2026-05-15T03:47:40.357Z"
}

ai_agent_graph.publish

A multi-agent graph was published — the draft topology became the live one, snapshotted as a new immutable version.

Versión 1 · Recurso ai_agent_graph · data requiere ai_agents:read

Cuándo se dispara. The graph publish seam validates the draft and inserts the version row (ai-agent-graph.service). The eval cascade that may follow does not gate the event.

{
  "tenant_id": "00000000-0000-4000-8000-000000000001",
  "graph_id": "9f1c6b40-3a2e-4f58-9d17-70c4f1a2b3d5",
  "version_id": "d0a7e912-5c84-4b6f-8e1a-2f9c7b3d0e45",
  "version_number": 7,
  "topology": "supervisor"
}

cost.budget_alert

An AI spend threshold was crossed. ⚠ ONE NAME, THREE PRODUCERS, THREE SHAPES — branch on the keys you get, not on a single schema. The Copilot credit gate emits domain: "copilot" with the credit counters; the Copilot dollar-margin guard emits domain: "copilot" with the USD limits; the graph runtime budget emits tenant_id + pct and no domain at all. Every field below is therefore optional in practice.

Versión 1 · Recurso workspace · data requiere billing:read

Cuándo se dispara. A tenant exhausts its monthly Copilot credit allowance, crosses its soft or hard USD margin limit (once each per month — the row carries the dedupe stamp), or crosses 50%, 80% or 100% of its monthly graph-runtime cost budget (once per threshold per month).

{
  "domain": "copilot",
  "month": "2026-09",
  "severity": "soft",
  "used_usd": 41.28,
  "soft_limit_usd": 40,
  "hard_limit_usd": 60
}

runtime.budget_exceeded

A multi-agent graph turn hit one of its runtime ceilings and was cut short. The turn still answers; what stopped is the orchestration, so a graph firing this repeatedly is mis-shaped rather than merely busy.

Versión 1 · Recurso ai_agent_graph · data requiere ai_agents:read

Cuándo se dispara. The graph runtime refuses to go further on one of four ceilings: recursion depth, fan-out width, per-node turns, or evaluator-loop iterations.

{
  "tenant_id": "00000000-0000-4000-8000-000000000001",
  "graph_id": "9f1c6b40-3a2e-4f58-9d17-70c4f1a2b3d5",
  "topology": "evaluator_loop",
  "reason": "evaluator_iterations"
}

kb.source.create

A new knowledge-base source has been added to the workspace.

Versión 1 · Recurso kb_source · data requiere kb:read

Cuándo se dispara. POST /kb/sources.

{
  "kb_source_id": "b2…",
  "title": "Devoluciones — política",
  "tags": [
    "returns",
    "policy"
  ]
}

kb.source.embed

A KB source has been (re-)embedded; vectors are ready for retrieval.

Versión 1 · Recurso kb_source · data requiere kb:read

Cuándo se dispara. POST /kb/sources/:id/embed (manual) or the kb-ingestion worker after content changes.

{
  "kb_source_id": "b2…",
  "chunks": 47
}

kb.source.update

A knowledge-base source’s summary, tags, status or verified_until changed.

Versión 1 · Recurso kb_source · data requiere kb:read

Cuándo se dispara. PUT /kb/sources/:id.

{
  "kb_source_id": "a5a5a5a5-0000-4000-8000-000000000001",
  "fields": [
    "status"
  ]
}

kb.source.delete

A knowledge-base source was HARD-deleted — the row and its embedded chunks are gone; retrieval can no longer return it.

Versión 1 · Recurso kb_source · data requiere kb:read

Cuándo se dispara. DELETE /kb/sources/:id.

{
  "kb_source_id": "a5a5a5a5-0000-4000-8000-000000000001"
}

kb_file.uploaded

A document was added to the workspace’s knowledge file library. A 201 here means the bytes are stored, not that the file is searchable yet — ingestion runs best-effort on a worker.

Versión 1 · Recurso kb_file · data requiere kb:read

Cuándo se dispara. POST /kb-files (multipart upload).

{
  "kb_file_id": "a6a6a6a6-0000-4000-8000-000000000001",
  "name": "Garantías 2026.pdf",
  "content_type": "application/pdf"
}

kb_file.deleted

A knowledge file was removed from the workspace (ADR 0093 — a soft delete: the row survives tombstoned, but every agent attachment goes and the embedded chunks are purged, so this is the customer-visible ending).

Versión 1 · Recurso kb_file · data requiere kb:read

Cuándo se dispara. DELETE /kb-files/:id.

{
  "kb_file_id": "a6a6a6a6-0000-4000-8000-000000000001"
}

skill.created

A new skill was added to the tenant library.

Versión 1 · Recurso skill · data requiere ai_agents:read

Cuándo se dispara. POST /skills.

{
  "skill_id": "a4a4a4a4-0000-4000-8000-000000000001",
  "name": "Agendar hora"
}

skill.updated

A skill’s content or channel_overrides changed — applies instantly to every agent it is attached to; there is no draft/publish step for a skill.

Versión 1 · Recurso skill · data requiere ai_agents:read

Cuándo se dispara. PUT /skills/:id.

{
  "skill_id": "a4a4a4a4-0000-4000-8000-000000000001",
  "name": "Agendar hora"
}

skill.deleted

A skill was removed (ADR 0093 — soft delete): it leaves the library and every agent it was attached to immediately.

Versión 1 · Recurso skill · data requiere ai_agents:read

Cuándo se dispara. DELETE /skills/:id.

{
  "skill_id": "a4a4a4a4-0000-4000-8000-000000000001"
}

custom_tool.created

A new custom tool was added to the Tool Store.

Versión 1 · Recurso custom_tool · data requiere functions:read

Cuándo se dispara. POST /custom-tools.

{
  "custom_tool_id": "a7a7a7a7-0000-4000-8000-000000000001",
  "name": "consultar_clima"
}

custom_tool.updated

A custom tool’s definition changed — its request template, parameters, auth configuration or enabled state. Fires from both the full-replace (PUT) and partial (PATCH) routes.

Versión 1 · Recurso custom_tool · data requiere functions:read

Cuándo se dispara. PUT or PATCH /custom-tools/:id.

{
  "custom_tool_id": "a7a7a7a7-0000-4000-8000-000000000001",
  "name": "consultar_clima"
}

custom_tool.deleted

A custom tool was removed. Every agent wired to it loses it immediately; past tool_invocation audit rows survive.

Versión 1 · Recurso custom_tool · data requiere functions:read

Cuándo se dispara. DELETE /custom-tools/:id.

{
  "custom_tool_id": "a7a7a7a7-0000-4000-8000-000000000001"
}

lead.created

A new lead has been opened — an opportunity the workspace is now working: a buyer asking about a car, a patient asking for a treatment, a company asking for a quote.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. POST /leads, POST /leads/from-conversation, POST /leads/import, the create_lead AI tool, or a marketplace / dealer-website ingest.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "contact_id": "22222222-0000-4000-8000-000000000001",
  "pipeline_id": "44444444-0000-4000-8000-000000000001",
  "stage_id": "55555555-0000-4000-8000-000000000001",
  "source": "conversation",
  "intent": "buy",
  "title": "María — prueba de manejo Corolla 2022",
  "value_amount": 8990000,
  "value_currency": "CLP",
  "owner_user_id": "3897d483-9e84-4971-8b17-9a41a6811966",
  "team_id": null
}

lead.stage_changed

A lead moved to a different stage of its board. EVERY stage change fires this — the REST move, a drag on the board, an AI tool, a quick action that closes the lead, the lead reviewer — so a receiver that tracks progress needs only this one event.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. PUT /leads/:id/stage, PUT /leads/:id/won | /lost | /unqualify | /reopen, the update_lead_stage AI tool, or the lead reviewer moving a card. NOT on a no-op move (already on that stage), and not on PUT /leads/:id/pipeline — that one reports its own stage move inside lead.pipeline_changed.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "from_stage_id": "55555555-0000-4000-8000-000000000001",
  "to_stage_id": "55555555-0000-4000-8000-000000000002",
  "to_stage_slug": "contacted",
  "reason": "la llamamos y confirmó la hora"
}

lead.pipeline_changed

A lead was reclassified onto a different sales board, landing on that board’s first stage.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. PUT /leads/:id/pipeline or the update_lead_pipeline AI tool. No separate lead.stage_changed fires for the landing stage — this event already carries it.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "from_pipeline_id": "44444444-0000-4000-8000-000000000001",
  "to_pipeline_id": "44444444-0000-4000-8000-000000000002",
  "from_stage_id": "55555555-0000-4000-8000-000000000002",
  "to_stage_id": "55555555-0000-4000-8000-000000000003",
  "reason": "es una venta mayorista"
}

lead.assigned

A lead was (re)assigned to an owner or a team. One assignee owns the whole relationship, so the lead’s conversations and their tickets move with it.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. PUT /leads/:id/assign, PUT /leads/:id with owner_user_id, or the team rotation picking an owner on create.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "owner_user_id": "3897d483-9e84-4971-8b17-9a41a6811966",
  "team_id": "cccccccc-0000-4000-8000-000000000001"
}

lead.won

A lead closed in the workspace’s favour.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. PUT /leads/:id/won, or any move onto a stage whose category is won. Only on the STATUS FLIP: moving an already-won lead between two won columns is a board tidy-up, not a second sale.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "reason": "cerró con financiamiento propio",
  "value_amount": 8750000,
  "value_currency": "CLP"
}

lead.lost

A real opportunity did not close.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. PUT /leads/:id/lost, or any move onto a stage whose category is lost. Status flip only, as for lead.won.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "reason": "compró en otra parte",
  "value_amount": 8990000,
  "value_currency": "CLP"
}

lead.unqualified

There was never an opportunity here — the wrong product, the wrong workspace, a duplicate, a test. A DISTINCT outcome from lead.lost: unqualified leads are excluded from win rate on both sides, so qualifying early never looks like losing.

Versión 1 · Recurso lead · data requiere leads:read

Cuándo se dispara. PUT /leads/:id/unqualify, or any move onto a stage whose category is unqualified. Status flip only, as for lead.won.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "reason": "buscaba un servicio que no ofrecemos",
  "value_amount": null,
  "value_currency": "CLP"
}

macro.applied

A macro has been applied to a conversation AND the macro opts into the webhook notification (i.e. its action list includes a run_webhook step). Lean payload — consumers use the ids to fetch detail if they need it.

Versión 1 · Recurso conversation · data requiere conversations:read

Cuándo se dispara. POST /macros/:id/apply with a conversation_id, when the macro's actions array contains at least one step with type=run_webhook. Fires once per apply regardless of how many run_webhook steps the macro has.

{
  "macro_id": "8f74aa7c-df40-478d-b5f5-5cfc2eb98da4",
  "macro_name": "Send return label",
  "conversation_id": 10031,
  "ticket_id": 10042,
  "contact_id": 142,
  "executed_steps": [
    {
      "type": "send_message",
      "ok": true
    },
    {
      "type": "add_label",
      "ok": true
    },
    {
      "type": "change_status",
      "ok": true
    },
    {
      "type": "run_webhook",
      "ok": true
    }
  ],
  "applied_by_user_id": "3897d483-9e84-4971-8b17-9a41a6811966",
  "applied_at": "2026-05-15T03:47:40.357Z"
}

stock.source_retired

Retiro de fuente (ADR 0031): a decommissioned import source handed its vehicles to dealer ownership.

Versión 1 · Recurso marketplace_integration · data requiere marketplace:read

Cuándo se dispara. POST /api/v1/vehicles/source-retirement/execute completes (once per retired source).

{
  "integration_id": "a3f1…",
  "provider": "veekls",
  "retired": 156,
  "revived": 2,
  "kept_hidden": 3
}

stock.synced

A stock integration finished importing active inventory from a marketplace portal.

Versión 1 · Recurso marketplace_integration · data requiere marketplace:read

Cuándo se dispara. syncStock() completes successfully (manual POST /marketplaces/:id/sync or the scheduled tick).

{
  "integration_id": "a3f1…",
  "provider": "chileautos",
  "vehicles_imported": 12,
  "vehicles_updated": 38,
  "vehicles_deactivated": 3
}

vehicle.published

A vehicle was published (or re-published) to a marketplace portal.

Versión 1 · Recurso vehicle · data requiere stock:read

Cuándo se dispara. publishVehicle() succeeds for a portal via POST /vehicles/:id/publish.

{
  "vehicle_id": "c8d2…",
  "integration_id": "a3f1…",
  "provider": "chileautos",
  "external_id": "6f2b1f7e-1f2a-4c3d-9e8f-0a1b2c3d4e5f"
}

vehicle.unpublished

A vehicle’s publication was removed from a marketplace portal — either a synchronous unpublish or a Facebook Marketplace device-agent task confirming a remove it had only enqueued.

Versión 1 · Recurso vehicle · data requiere stock:read

Cuándo se dispara. unpublishVehicle() succeeds via DELETE /vehicles/{id}/publications/{pubId}, or the device agent reports a remove task done via POST /device-agent/tasks/{id}/result (facebook_marketplace — the enqueue itself fires nothing; only the confirmed removal does).

{
  "vehicle_id": "c8d2…",
  "integration_id": "a3f1…",
  "provider": "mercadolibre",
  "external_id": "MLC-1234567890"
}

vehicle.publish_failed

A publish, update or unpublish attempt against a marketplace portal failed — the portal rejected it, the connection errored, or (Facebook Marketplace) the device agent reported the task could not complete.

Versión 1 · Recurso vehicle · data requiere stock:read

Cuándo se dispara. The per-integration catch in publishVehicle() via POST /vehicles/{id}/publish, or the device agent reporting a publish/update/remove task failed via POST /device-agent/tasks/{id}/result.

{
  "vehicle_id": "c8d2…",
  "integration_id": "a3f1…",
  "provider": "chileautos",
  "error": "The portal rejected the listing: missing required field \"version\"."
}

vehicle.created

A vehicle entered this workspace — one event per car, whichever door it came through: the manual/API create (POST /vehicles) or a marketplace stock import. Use it to mirror the lot: id is the handle every other endpoint takes, and url fetches the full record. A car that is MERGED into one you already know about does not fire this event (the identity resolver attached the new listing to the existing vehicle, so no car appeared); neither does a re-import of a car already in stock.

Versión 1 · Recurso vehicle · data requiere stock:read

Cuándo se dispara. A vehicle row is inserted — vehicle.service create (manual/API intake) or either insert door of the marketplace-sync importer (a newcomer, and a newcomer whose plate conflicted and was imported plate-absent). Retries of one delivery reuse the event id.

{
  "id": "c8d24f0e-7a1b-4c3d-9e8f-0a1b2c3d4e5f",
  "patente": "KXRT52",
  "vin": "JTDBR32E730123456",
  "make": "Toyota",
  "model": "Yaris",
  "version": "XLS 1.5 AT",
  "year": 2019,
  "km": 48200,
  "price": 8990000,
  "status": "disponible",
  "tenencia": "propio",
  "location": {
    "id": "25424bd5-57e1-412c-a0fe-5c375608cef7",
    "name": "Manquehue"
  },
  "source": "chileautos",
  "created_at": "2026-09-15T13:22:41.118Z",
  "url": "https://api.vitrinadev.com/api/v1/vehicles/c8d24f0e-7a1b-4c3d-9e8f-0a1b2c3d4e5f"
}

vehicle.attachment.created

A document was filed into a vehicle's expediente — padrón, cédula del consignante, contrato firmado, certificado de anotaciones vigentes or factura. The event carries METADATA AND A FETCH URL, never file bytes and never a signed URL: GET content_url with an API key holding vehicle_registry:read and the bytes stream back (every read is audited). ⚠ PERSONAL DATA: filename is chosen by the person who uploaded the file and regularly carries a natural person's name or RUT, and a cedula is a third party's identity document. Receiving these makes your platform a PROCESSOR of the dealership's personal data under Ley 21.719 — store them under the dealership's retention rules, keep them out of logs, and be able to erase them on request.

Versión 1 · Recurso vehicle_attachment · data requiere vehicle_registry:read

Cuándo se dispara. The expediente upload seam persists the row (POST /vehicle-attachments, the only upload door — a transferencia references an already-filed document rather than uploading its own). Retries of one delivery reuse the event id.

{
  "id": "3f9c1a52-64bd-4a71-8e2c-9b7d5e3a1c04",
  "vehicle_id": "c8d24f0e-7a1b-4c3d-9e8f-0a1b2c3d4e5f",
  "kind": "padron",
  "filename": "padron_KXRT52.pdf",
  "mime_type": "application/pdf",
  "byte_size": 184320,
  "uploaded_at": "2026-09-15T13:31:08.402Z",
  "content_url": "https://api.vitrinadev.com/api/v1/vehicle-attachments/3f9c1a52-64bd-4a71-8e2c-9b7d5e3a1c04/content"
}

mercadolibre.order

A Mercado Libre order notification (orders_v2) was received for a connected seller.

Versión 1 · Recurso marketplace_integration · data requiere marketplace:read

Cuándo se dispara. The MELI notifications worker processes an orders_v2 topic. It also upserts the buyer as a contact and creates a sales lead (source=marketplace, deduped by order id) when the tenant has a sales pipeline; this event fires regardless for downstream automation/reporting.

{
  "integration_id": "a3f1…",
  "order_id": 2000003508419013,
  "status": "paid",
  "total_amount": 8990000,
  "currency_id": "CLP",
  "buyer": {
    "id": 123456789,
    "nickname": "COMPRADOR123"
  },
  "items": [
    {
      "id": "MLC123",
      "title": "Toyota Yaris XLS 2019",
      "qty": 1
    }
  ]
}

mercadolibre.vis_lead

A Mercado Libre vehicle-classified buyer lead (VIS Leads) was received for a connected seller.

Versión 1 · Recurso marketplace_integration · data requiere marketplace:read

Cuándo se dispara. The MELI notifications worker processes a vis_leads topic (buyer contact via whatsapp/call/question/visit/contact request/reservation). It also upserts the buyer as a contact and creates a sales lead (source=marketplace, deduped by lead id) when the tenant has a sales pipeline; this event fires regardless for downstream automation/reporting.

{
  "integration_id": "a3f1…",
  "lead_id": "44115522",
  "item_id": "MLC123",
  "contact_type": "whatsapp",
  "status": "active"
}

appointment.booked

An appointment was booked and confirmed — a test drive, a consulta, a service visit: whatever the workspace puts in its diary.

Versión 1 · Recurso appointment · data requiere appointments:read

Cuándo se dispara. POST /appointments, the agent booking tool, the embed widget, the clinic diary (POST /clinic/agenda/appointments), or a hold that was confirmed. NOT for kind=block (an admin unavailability marker is not a booking).