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

Resolve contact(s)

Résout le meilleur contact utilisable pour une company à partir des rôles valides, des niveaux de certification et de la stratégie de sélection configurée.

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

Ce node sélectionne un contact métier existant sans demander de contact_id au concepteur du processus.

Il s’appuie sur les rôles contact_role actifs pour trouver un contact compatible avec l’intention métier, par exemple un représentant légal, un contact de facturation ou un autorisateur de paiement.

La sortie selected_contact est un objet platform.contact exploitable par les nodes suivants, et selected_contact_role documente la relation qui a justifié la sélection.

Quand l’utiliser

  • Vous devez adresser une demande à un contact selon son rôle dans la company.
  • Le processus doit router différemment quand aucun contact éligible n’existe.
  • Plusieurs contacts peuvent correspondre et vous devez appliquer une stratégie de sélection explicite.

Paramètres 4

companyRequisCompany
Company plateforme persistée dont les contacts doivent être résolus. Le node utilise company.id et ne demande pas de merchant_id.
role_typesOptionnelenum[]
Rôles acceptés, par exemple legal_representative, billing_contact, payment_authorizer ou main_contact. L’ordre sert de priorité avec best_role_type_fit.
certification_levelsOptionnelenum[]
Niveaux acceptés parmi declarative, verified et certified.
selection_strategyOptionnelenum
first conserve l’ordre de résolution API, latest privilégie le rôle le plus récent, most_certified privilégie la meilleure certification, et best_role_type_fit privilégie l’ordre de role_types.

Sorties 5

foundboolean
Valeur de routage. true envoie vers la route found, false vers not_found.
selected_contactContact
Contact sélectionné quand une correspondance existe.
selected_contact_roleContact role
Rôle valide qui justifie la sélection du contact.
selected_role_typestring
Type de rôle retenu, dérivé du match ou du rôle sélectionné.
other_candidatesContact[]
Autres contacts uniques éligibles, sans répéter le contact sélectionné.

Comportement

Valider la company

Le node exige un objet platform.company avec un id. Il n’expose pas de paramètre merchant_id.

Résoudre les candidats

Le node recherche les contacts selon les filtres de rôles et de certification. Les rôles révoqués ou non valides à la date de résolution sont exclus.

Appliquer la stratégie

Les matches sont triés selon selection_strategy. Le premier match trié devient selected_contact; les autres contacts uniques alimentent other_candidates.

Router le processus

Si un match existe, le node route vers found et expose le contact sélectionné. Sinon il route vers not_found avec des sorties nulles et une liste de candidats vide.

Exemple de processus

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

Le node choisit un contact éligible avant une demande métier, tout en gardant une branche explicite quand aucun contact ne correspond.