Neo4j Find Customer by External ID & Business ID icon

Neo4j Find Customer by External ID & Business ID

根據用戶 External ID 和商家 ID 查找客戶記錄。,externalId: 用戶的 External ID (UUID),businessId: 客戶註冊的商家 ID (UUID)。

Neo4j Find Customer by External ID & Business ID

AI-generated

Overview

This node queries a Neo4j graph database to find customer records based on two identifiers: an External ID associated with a user and a Business ID representing the registered business. It matches a pattern where a Customer node is linked to a Business node via a REGISTERED_WITH relationship, and the Customer is connected to a User node identified by the given External ID.

Common scenarios:

  • Retrieving detailed customer information for a specific user within a particular business context.
  • Validating if a user belongs to a certain business by checking their registration.
  • Integrating Neo4j customer data into workflows that require user-business relationship verification.

Practical example:
A marketing automation workflow might use this node to fetch customer details before sending personalized offers, ensuring the user belongs to the targeted business.

Properties

Name Meaning
External ID The unique external identifier (UUID) of the user whose customer record is being searched.
Business ID The unique identifier (UUID) of the business with which the customer is registered.

Output

The node outputs JSON objects representing matched customer nodes. Each output item contains a customer field with all properties of the matched Customer node from Neo4j.

Example structure of one output item’s JSON:

{
  "customer": {
    "property1": "value1",
    "property2": "value2",
    "...": "..."
  }
}

No binary data output is produced by this node.

Dependencies

  • Requires a Neo4j database connection configured via credentials including host, port, username, password, and optionally database name.
  • Uses the official Neo4j driver to connect and run Cypher queries.
  • Needs proper Neo4j credentials set up in n8n with full configuration (host, port, username, password).

Troubleshooting

  • Neo4j credentials are not fully configured:
    Ensure all required fields (host, port, username, password) are correctly filled in the credential settings.

  • Failed to establish Neo4j connection:
    Check network connectivity to the Neo4j server, verify credentials, and confirm the database is running.

  • Neo4j session is not available:
    This indicates a failure in creating or maintaining the session; retry or check resource limits.

  • Errors parsing Neo4j response:
    Could be due to malformed queries or unexpected data; review the input parameters and Neo4j schema.

  • Continue on Fail behavior:
    If enabled, errors for individual items will be captured in the output with error details instead of stopping execution.

Links and References

Discussion