Graph AI EngineCore Entity

Customer

The root guest identity node. Every interaction across bookings, Wi-Fi, orders, reviews, and loyalty is unified under a single Customer node per organisation.

15 fields28 relationships

Fields

NameTypeReqDescription
emailstringyesPrimary identifier, unique within an organisation.
first_namestring—Guest first name.
last_namestring—Guest last name.
phonestring—Phone number in E.164 format, e.g. +447307745845.
postcodestring—Postal code for geographic segmentation.
countrystring—Full country name.
country_codestring—ISO 3166-1 alpha-2 code, e.g. GB.
genderenum—Stated gender. Allowed values: male | female | non_binary | prefer_not_to_say.
age_rangestring—Age band string, e.g. 25-34 or 35-44.
birth_monthnumber—Month of birth, integer 1–12. Used to trigger birthday campaigns.
birth_daynumber—Day of birth, integer 1–31.
org_iduuid—Owning organisation. Always scope queries through the REGISTERED_WITH relationship.
morpheus_profile_iduuid—Internal CRM (Morpheus) profile ID.
zion_iduuid—Booking system (Zion) guest ID.
trinity_org_reg_iduuid—Organisation registration ID from the Trinity system.

Relationships

Outbound (28)
  • Customer[:REGISTERED_WITH]→Organizationemail_opt_in, sms_opt_in, data_opt_in, registered_at, last_interacted_at
  • Customer[:VISITED]→Venuevisit_count, first_visit, last_visit, total_spend (pennies)
  • Customer[:BOOKED]→Bookingcreated_at
  • Customer[:INVITED_TO]→Bookingstatus (PENDING | ACCEPTED | DECLINED)
  • Customer[:REVIEWED]→Reviewcreated_at
  • Customer[:ORDERED]→Ordercreated_at, amount (pennies)
  • Customer[:PLACED_ORDER]→SquareOrder
  • Customer[:CONTRIBUTED_TO]→SquareOrderamount (pennies), status, is_lead, payment_method
  • Customer[:CONNECTED_VIA_WIFI]→WifiSessioncreated_at
  • Customer[:SUBMITTED]→FormSubmissioncreated_at
  • Customer[:COMMUNICATED_IN]→Thread
  • Customer[:ENROLLED_IN]→LoyaltyEnrollmentenrolled_at, points
  • Customer[:TAGGED_WITH]→Tag
  • Customer[:RECEIVED_CAMPAIGN]→EmailCampaignsent_at
  • Customer[:OPENED_CAMPAIGN]→EmailCampaignopened_at
  • Customer[:CLICKED_CAMPAIGN]→EmailCampaignclicked_at, link_url
  • Customer[:BOUNCED_CAMPAIGN]→EmailCampaignbounced_at
  • Customer[:RECEIVED_SMS]→SmsCampaignsent_at
  • Customer[:IN_SEGMENT]→Segment
  • Customer[:ANSWERED]→CustomQuestionanswer
  • Customer[:SENT_GIFT_CARD]→GiftCardamount (pennies), currency, created_at
  • Customer[:REDEEMED_GIFT_CARD]→GiftCardredeemed_at
  • Customer[:CHARGED_CANCELLATION]→CancellationChargeamount_owed (pennies)
  • Customer[:BOOKED_VIA_INTEGRATION]→BookingIntegrationpenny_value, currency, created_at
  • Customer[:REFERRED]→Customer
  • Customer[:DINED_WITH]→Customerbooking_id, date
  • Customer[:GIFTED_TO]→Customergift_name, value (pennies), sent_at
  • Customer[:ENQUIRED]→Enquirycreated_at