Actions16
👤 Lookup Contact Info
AI-generatedSummary
Retrieve contact information from LiraX CRM by phone number or email.
Inputs
- phone — Phone number for contact lookup. Will be automatically normalized to digits. Include country code for international numbers (e.g., 380501234567). Displayed for operations: getContact.
- email — Email address for contact lookup or creation. Displayed for operations: getContact.
- aiSettings — AI Agent settings for output formatting and error handling. Always available collection with options: includeSummary (boolean, default true), standardizedOutput (boolean, default true), errorMode (options: strict/lenient/silent, default lenient), confidenceThreshold (number, default 0.7, min 0 max 1).
Output shape
Contact lookup result standardized for AI Agent consumption.
At least one of phone or email must be provided; the API schema (getContactSchema) enforces this requirement via refinement. Returns contactFound boolean, contact object (name, phone, email), searchCriteria, and timestamp. AI summary and standardized format governed by aiSettings. Raw API response included if includeRawResponse is true.
Examples
Example 1: Lookup contact by phone
Phone: 380501234567, Email: (empty), aiSettings default. Returns contact details if found in LiraX CRM.
Example 2: Lookup contact by email
Phone: (empty), Email: john.smith@example.com, aiSettings errorMode: strict. Returns contact details or throws error immediately on failure.