ByDomuDevelopers
Create key

customer.at_risk

Customer at risk of churning

Object · contactInstant

When it fires

A contact’s churn-risk score (SaaS vertical) rose to High. risk carries the level, the score, the signals in words and what Noa suggests.

Instantly, when it happens in ByDomu: from the app, the API, Noa, an automation or an integration. actor.kind tells you who: USER, NOA, SYSTEM, API, AUTOMATION or INTEGRATION.

Subscribe with

  • customer.at_riskOnly this event
  • customer.*Every event of Contact
  • *The whole catalog

Fields it carries

paths for filters and templates
contact.idContact id
contact.codeContact code
contact.firstNameFirst name
contact.lastNameLast name
contact.emailEmail
contact.phonePhone
contact.sourceSource
contact.statusStatus
contact.typeContact type
contact.scoreScore
contact.ownerIdOwner
contact.preferredCityCity of interest
contact.preferredTypeProperty type they want
contact.budgetBudget
contact.tagsTags

Up to 5 attempts (0 s, 5 s, 30 s, 2 min and 10 min) on network errors, 429 or 5xx. Reply 2xx in under 10 s.

{
  "event": "customer.at_risk",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "customer.at_risk",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "SYSTEM",
    "userId": null
  },
  "data": {
    "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"
    },
    "risk": {
      "level": "HIGH",
      "score": 78,
      "signals": [
        {
          "code": "USAGE_DROP",
          "label": "El uso bajó 62 % en 3 semanas"
        },
        {
          "code": "TICKETS_OPEN",
          "label": "2 tickets sin resolver hace 6 días"
        }
      ],
      "suggestedAction": "Que un asesor lo llame hoy y le ofrezca 20 minutos de ayuda."
    }
  }
}
Get it with your test dataGET /v1/webhooks/sample/customer.at_risk
Try it