Tickets: webhook y Linear

Lleva los tickets a tu sistema con su webhook propio o conéctalos con Linear.

GuíaTodos los planesSin clave de API

Dónde se configura

En ByDomu, Configuración › Canales e integraciones › Tickets: Linear y webhook. Funciona en todos los planes y no pide clave de API: lo configura alguien del equipo desde el panel. Es un webhook normal (misma firma, misma cola con reintentos, mismo registro de entregas) suscrito solo a ticket.*.

Conecta tu sistema con el webhook

Pega la dirección (https://…) de tu servidor, de Jira o Zendesk por medio de tu propio puente, o de Zapier, Make o n8n.
Elige los eventos. Por defecto van ticket.created, ticket.status_changed y ticket.resolved; ticket.updated y ticket.note_added se marcan aparte.
Copia el secreto y guárdalo en tu sistema para verificar X-Domu-Signature. Puedes volver a verlo o rotarlo; al rotarlo, el anterior deja de servir en el acto.
«Enviar una prueba» manda una entrega con X-Webhook-Test: true y data.message; abajo ves las últimas entregas con su código de respuesta.

Cuándo saleEvento

Se creó un ticket. Trae el ticket (con el enlace al panel) y el contacto, si lo tiene.ticket.created

Cambió el título, el resumen, la prioridad, el responsable o las etiquetas. changedFields dice cuáles.ticket.updated

El ticket cambió de estado (PENDING, IN_PROGRESS o RESOLVED). previousStatus trae el anterior.ticket.status_changed

Se agregó una nota interna al ticket, en ByDomu o como comentario en Linear (note.source).ticket.note_added

El ticket quedó resuelto. Sale junto con ticket.status_changed.ticket.resolved

Qué llega en cada entrega

data.ticket trae el número y el código (T-0012), estado, prioridad, canal, etiquetas, responsable, el issue de Linear si existe y url, el enlace al ticket en el panel; data.contact, el contacto si lo tiene. Un cambio a RESOLVED manda ticket.status_changed y ticket.resolved: descarta repetidos por id.

{
  "event": "ticket.created",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "ticket.created",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "USER",
    "userId": "clx1usr001"
  },
  "data": {
    "ticket": {
      "id": "clx1tkt001",
      "number": 12,
      "code": "T-0012",
      "title": "No llegan las fotos al portal",
      "summary": "La clienta dice que la ficha P-0042 se ve sin fotos desde ayer.",
      "status": "PENDING",
      "priority": "HIGH",
      "channel": "WHATSAPP",
      "labels": [
        "Portales"
      ],
      "assignedToId": "clx1usr001",
      "assignedToName": "Andrés Mejía",
      "contactId": "clx1con001",
      "conversationId": "clx1cnv001",
      "linearIssueKey": null,
      "url": "https://www.bydomu.com/inbox/tickets/clx1tkt001",
      "resolvedAt": null,
      "createdAt": "2026-09-22T14:30:00.000Z",
      "updatedAt": "2026-09-22T14:30:00.000Z"
    },
    "contact": {
      "id": "clx1con001",
      "code": "C-0042",
      "firstName": "Laura",
      "lastName": "Restrepo",
      "fullName": "Laura Restrepo",
      "email": "[email protected]",
      "phone": "+573000000001",
      "source": "WEBSITE",
      "status": "QUALIFIED",
      "type": "CLIENT",
      "score": 72,
      "ownerId": "clx1usr001",
      "preferredCity": "Bogotá",
      "preferredType": "APARTMENT",
      "budget": 450000000,
      "currency": "COP",
      "tags": [
        "Compra",
        "Chapinero"
      ],
      "createdAt": "2026-09-20T15:04:00.000Z"
    }
  }
}

Con una clave secreta y webhooks:write también puedes suscribir ticket.* (y ticket.suggested, cuando Noa propone abrir un ticket) desde la API, como cualquier otro evento.

Conecta Linear

En la misma pantalla, Conectar con Linear abre la autorización de Linear para toda la inmobiliaria. Luego eliges el equipo, cuándo se crea el issue y cómo se corresponden estados y prioridades. Los issues y comentarios salen a nombre de la app, con el nombre de quien escribió en ByDomu; si lo activas, llevan la etiqueta «Desde ByDomu».

QuéDirección

Crear el issue (Solo si lo marco al crear · Siempre · Nunca)ByDomu → Linear

Estado, prioridad, responsable, etiquetas y notasByDomu → Linear

Cambios de estado y prioridad, comentarios nuevosLinear → ByDomu

Lo que cambia en Linear vuelve como eventos: ticket.status_changed, ticket.updated (changedFields: priority) y ticket.note_added con note.source = "linear". El cliente nunca ve Linear: solo ve el estado de su solicitud.

Si algo falla

401Tu sistema rechaza la firma: revisa que uses el secreto actual (¿lo rotaste?) y el cuerpo crudo.
5xxSe reintenta y queda en las entregas recientes: Hasta 5 intentos (0 s, 5 s, 30 s, 2 min y 10 min) ante error de red, 429 o 5xx. Responde 2xx en menos de 10 s.
LINLos cambios hechos en Linear no llegan: la pantalla avisa si falta el webhook de la app de Linear. Lo que se hace en ByDomu sí llega a Linear.