ormuz
Home/Orchestration/Nodes Core/Resolve contact(s)
RouteurStable

Resolve contact(s)

Resolves the best usable contact for a company from valid roles, certification levels, and the configured selection strategy.

Resolve contact
resolve_contact

Select the best qualified contact for a business company using role types, certification levels, and a selection strategy. Use this when you need the appropriate billing, legal, payment, or other responsible contact rather than looking up a known email address.

roles: legal_representative, payment_authorizercertification: verified, certified
Found
Not found

Vue d’ensemble

Objectif

This node selects an existing business contact without asking the process designer for a contact_id.

It relies on active contact_role resources to find a contact compatible with the business intent, for example a legal representative, billing contact, or payment authorizer.

The selected_contact output is a platform.contact usable by subsequent nodes, and selected_contact_role documents the relationship that justified selection.

Quand l’utiliser

  • You need to address a request to a contact based on their role in the company.
  • The process must route differently when no eligible contact exists.
  • Several contacts may match and you must apply an explicit selection strategy.

Parameters 4

companyRequisCompany
Persisted platform Company whose contacts must be resolved. The node uses company.id and does not request a merchant_id.
role_typesOptionnelenum[]
Accepted roles, for example legal_representative, billing_contact, payment_authorizer, or main_contact. Order acts as priority with best_role_type_fit.
certification_levelsOptionnelenum[]
Accepted levels among declarative, verified, and certified.
selection_strategyOptionnelenum
first preserves API resolution order, latest favors the newest role, most_certified favors the strongest certification, and best_role_type_fit favors the order of role_types.

Outputs 5

foundboolean
Routing value. true goes to found, false to not_found.
selected_contactContact
Selected contact when a match exists.
selected_contact_roleContact role
Valid role that justifies selection of the contact.
selected_role_typestring
Selected role type, derived from the match or selected role.
other_candidatesContact[]
Other unique eligible contacts, excluding the selected contact.

Behavior

Validate the company

The node requires a platform.company object with an id. It exposes no merchant_id parameter.

Resolve candidates

The node searches contacts according to role and certification filters. Revoked roles or roles not valid at resolution time are excluded.

Apply the strategy

Matches are sorted by selection_strategy. The first sorted match becomes selected_contact; other unique contacts populate other_candidates.

Route the process

When a match exists, the node routes to found and exposes the selected contact. Otherwise it routes to not_found with null outputs and an empty candidate list.

Process example

Contexte métier
Resolve contact(s)
Found
Not found
Send email to contacts
Collect user email

The node chooses an eligible contact before a business request while preserving an explicit branch when no contact matches.