← Todas las guías

Automatización e integraciones

Eventos y conexiones entre módulos

Aprende qué ocurre cuando un módulo emite un evento, cómo usarlo en una integración y dónde revisar una entrega.

Un evento registra que ocurrió algo, como crear una orden, confirmar una reserva o cambiar el estado de una factura. Otros módulos pueden reaccionar a algunos eventos; una integración externa puede recibirlos mediante un webhook si está configurado.

El recorrido de un evento

01AcciónUn registro cambia
02EventoEl módulo lo registra
03DestinoRegla o webhook
04RevisiónActividad y resultado
La acción original y la entrega externa son pasos distintos; revisa ambos estados.

Eventos principales por área

Los nombres exactos que puedes seleccionar dependen de los módulos activos y de los permisos de integración.

ÁreaEjemplos de eventos
Reservasbooking.hold.created, booking.hold.expired, booking.confirmed, booking.cancelled, booking.rescheduled
Calendariocalendar.event.created, calendar.event.updated, calendar.event.deleted, calendar.external.synced, calendar.external.sync_failed
Entidadesentities.created, entities.updated, entities.deleted, entities.relation.created, entities.user.linked
Catálogo e inventariocatalog.item.created, catalog.item.updated, catalog.listing.published, catalog.stock.adjusted, catalog.stock.reserved, catalog.stock.low, catalog.stock.depleted
Órdeneswork_orders.created, work_orders.updated, work_orders.status_changed, work_orders.assigned, work_orders.completed, work_orders.invoiced, work_orders.sla_breached, work_orders.quote_approved, work_orders.purchase_order_requested
Documentosdocuments.generated, documents.published, documents.signed, documents.approved, documents.rejected, documents.shared, documents.archived
Facturacióninvoicing.invoice.created, invoicing.invoice.issued, invoicing.invoice.paid, invoicing.invoice.overdue, invoicing.payment.recorded, invoicing.refund.recorded
Tienda y pedidoscommerce.order.created, commerce.order.paid, commerce.order.payment_failed, commerce.order.cancelled, commerce.order.updated
Conversacionesconversations.started, conversations.message_received, conversations.message_sent, conversations.archived, conversations.whatsapp_delivery_failed
Sitiossites.site.published, sites.page.published, sites.form.submitted, sites.media.job.ready, sites.media.job.failed

La lista muestra ejemplos representativos, no todos los eventos que emite cada módulo. El catálogo del selector de webhooks de tu espacio es la lista habilitada para tu configuración. Los campos del evento pueden incluir referencias o datos personales; comparte solo lo necesario.

Catálogo de nombres declarados

La siguiente lista enumera los nombres de eventos declarados por los módulos del producto. Algunos son internos del sistema y no aparecen como opción de webhook. El selector de tu espacio determina cuáles puedes conectar.

  • Reservas: booking.hold.created, booking.hold.expired, booking.confirmed, booking.cancelled, booking.rescheduled, booking.no_show, booking.completed, booking.reminder.due, booking.approval.requested, booking.approval.granted, booking.series.created, booking.fee.assessed, booking.fee.waived, booking.verification.requested, booking.condition.blocked.
  • Calendario: calendar.calendar.created, calendar.calendar.updated, calendar.calendar.deleted, calendar.event.created, calendar.event.updated, calendar.event.deleted, calendar.event.upcoming, calendar.external.linked, calendar.external.unlinked, calendar.external.synced, calendar.external.sync_failed.
  • Entidades: entities.type.created, entities.type.updated, entities.type.activated, entities.type.deactivated, entities.type.deleted, entities.relation_def.created, entities.relation_def.deleted, entities.created, entities.updated, entities.deleted, entities.relation.created, entities.relation.deleted, entities.user.linked, entities.user.unlinked.
  • Catálogo: catalog.listing.published, catalog.listing.updated, catalog.listing.unpublished, catalog.collection.updated, catalog.item.created, catalog.item.updated, catalog.item.deleted, catalog.price.resolved, catalog.stock.adjusted, catalog.stock.reserved, catalog.stock.released, catalog.stock.committed, catalog.stock.low, catalog.stock.depleted.
  • Tienda y pedidos: commerce.order.created, commerce.order.paid, commerce.order.payment_failed, commerce.order.cancelled, commerce.order.updated.
  • Órdenes de trabajo: work_orders.created, work_orders.updated, work_orders.status_changed, work_orders.time_logged, work_orders.time_entry_voided, work_orders.bulk_operations_completed, work_orders.sla_breached, work_orders.sla_escalated, work_orders.attachment_uploaded, work_orders.attachment_deleted, work_orders.note_added, work_orders.line_added, work_orders.line_edited, work_orders.line_removed, work_orders.assigned, work_orders.completed, work_orders.invoiced, work_orders.document_generated, work_orders.scheduled, work_orders.reminder_due, work_orders.refunded, work_orders.partially_refunded, work_orders.voided, work_orders.returned, work_orders.line_returned, work_orders.amended, work_orders.template_created, work_orders.template_updated, work_orders.template_deleted, work_orders.occurrence_materialized, work_orders.occurrence_skipped, work_orders.line_backordered, work_orders.backorder_fulfilled, work_orders.relationship_added, work_orders.relationship_removed, work_orders.checklist_item_completed, work_orders.crew_changed, work_orders.quote_issued, work_orders.quote_approved, work_orders.quote_rejected, work_orders.quote_drifted, work_orders.self_requested, work_orders.auto_assigned, work_orders.purchase_order_requested, work_orders.reviewed, work_orders.payment_recorded, work_orders.rma_created, work_orders.rma_resolved, work_orders.kit_exploded.
  • Documentos e impresión: documents.signing_request.created, documents.generated, documents.published, documents.signed, documents.rejected, documents.approved, documents.shared, documents.archived, documents.observed_role_created, documents.receipt.print_failed, documents.receipt.printed, documents.receipt.reprinted.
  • Facturación: invoicing.invoice.created, invoicing.invoice.issued, invoicing.invoice.paid, invoicing.invoice.voided, invoicing.invoice.written_off, invoicing.invoice.disputed, invoicing.invoice.reissued, invoicing.invoice.overdue, invoicing.credit_note.issued, invoicing.payment.recorded, invoicing.wallet.created, invoicing.wallet.entry.recorded, invoicing.refund.recorded, invoicing.contract.created, invoicing.contract.principal_failed, invoicing.invoice.due_soon, invoicing.fiscal_authorization.created, invoicing.fiscal_authorization.updated, invoicing.fiscal_authorization.deleted.
  • Cuentas por pagar y libro mayor: payables.bill.approved, payables.bill.paid, payables.bill.voided, payables.payment.recorded, payables.bill.due_soon, payables.bill.overdue, payables.bill.credited, ledger.account.created, ledger.account.closed, ledger.transfers.posted, ledger.period.closed, ledger.books.unbalanced.
  • Conversaciones: conversations.started, conversations.message_received, conversations.message_sent, conversations.archived, conversations.template_created, conversations.template_submitted, conversations.template_status_changed, conversations.template_category_changed, conversations.template_quality_changed, conversations.whatsapp_history_synced, conversations.whatsapp_coexistence_changed, conversations.whatsapp_marketing_preference_changed, conversations.whatsapp_number_quality_changed, conversations.whatsapp_account_health_changed, conversations.whatsapp_delivery_failed.
  • Sitios: sites.site.published, sites.site.unpublished, sites.site.updated, sites.page.published, sites.page.unpublished, sites.page.updated, sites.form.submitted, sites.media.job.queued, sites.media.job.ready, sites.media.job.failed.
  • Personas y acceso: users.created, users.updated, users.password_changed, users.password_reset_by_admin, users.deactivated, users.reactivated, auth.login, auth.login_failed, auth.magic_link_sent, auth.password_reset_requested, auth.method_enrolled, auth.method_removed, auth.webauthn_registered, auth.discovery_code_sent, members.created, members.updated, members.membership.expiring, members.membership.expired, members.role_elevation.expired, members.removed, members.view_as.started, invites.created, invites.accepted, invites.revoked, invites.expired, roles.created, roles.updated, roles.deleted, service_principals.created, service_principals.key_rotated, service_principals.revoked.
  • Espacios y preferencias: tenants.fiscal_identity.updated, tenants.created, tenants.updated, tenants.deactivated, tenants.deleted, tenants.purged, modules.enabled, modules.disabled, modules.config_updated, preferences.color.updated, preferences.color.default.updated, preferences.layout.updated, preferences.sidebar.updated, preferences.tables.updated, preferences.tables.reset, preferences.tables.default.updated, preferences.tables.default.reset.
  • Tableros y automatización: dashboards.created, dashboards.updated, dashboards.deleted, dashboards.exported, workflows.run.stranded, workflows.schedule.stale, workflows.workflow.principal_failed.

Configurar una entrega

  1. Pide al sistema receptor una dirección HTTPS y confirma qué eventos necesita.
  2. En Integraciones → Webhooks, crea la conexión y selecciona solo esos eventos.
  3. Configura la firma si el destino lo permite y valida esa firma en el receptor.
  4. Ejecuta una prueba cuando la pantalla la ofrezca.
  5. Revisa Actividad y auditoría para comprobar la entrega y su resultado.

Si falla

Confirma que el destino siga activo, acepte solicitudes HTTPS y valide la firma correcta. Corrige primero la causa y luego reintenta desde la cola de errores, si está disponible. Un reintento puede entregar de nuevo un mismo evento; el sistema receptor debe reconocer duplicados y evitar repetir acciones.

No uses el contenido completo de un evento en capturas o consultas de soporte: puede incluir información de clientes. Comparte el identificador del evento, la hora y el estado de entrega.

Relacionado