Glossary
Canonical term definitions used across Nexus documentation, API, and codebase. Where the codebase uses synonyms, both terms are listed.
| Term | Synonyms | Definition |
|---|---|---|
| Organization | Org, Tenant | A business entity in Nexus. All data is scoped to an organization. Each organization has its own members, contacts, orders, and integrations. |
| Contact | Customer | A person your organization interacts with. Stored in the customers table. The CRM UI uses "Contact"; the database uses "Customer". |
| Company | — | A business associated with a contact. Currently stored as a text field on the Contact record. |
| Conversation | Chat, Thread | A messaging exchange between your org and a contact on a specific channel. Stored in the chats table. |
| Message | — | A single communication unit within a conversation (text, media, template, or system event). |
| Channel | — | A communication platform: whatsapp, facebook, instagram, email, or internal. |
| Order | — | A sales transaction containing line items, a total, and a lifecycle status. |
| Order Item | Line Item | A single product entry within an order (SKU, quantity, price). |
| AWB | Airway Bill, Shipment | A shipping record created with a courier. Contains tracking number, status, and label URL. |
| Pick List | — | A warehouse document listing items to be picked for one or more orders, organized by bin location. |
| Inventory Item | Product, SKU | A trackable product in the inventory system. |
| Warehouse | — | A physical or logical storage location for inventory. |
| Bin | Location, Slot | A specific position within a warehouse (e.g., aisle-shelf-bin). |
| Stock Movement | — | A recorded change in inventory quantity (inbound, outbound, adjustment, transfer). |
| Purchase Order | PO | An order placed with a supplier for restocking inventory. |
| Supplier | Vendor | A company you purchase inventory from. The codebase uses both suppliers and vendors. |
| Label | Tag (CRM) | A categorical marker applied to contacts for segmentation. Stored in the labels table. |
| Journey Stage | Lifecycle Stage | A contact's position in the sales funnel (lead, prospect, customer, churned). |
| Edge Function | Serverless Function | A Supabase Edge Function running on Deno. Handles webhooks, integrations, and business logic. |
| RLS | Row-Level Security | PostgreSQL feature that restricts row access based on the authenticated user's JWT claims. |
| JWT | Token | JSON Web Token issued by Supabase Auth. Contains user identity and organization context. |
| WABA | WhatsApp Business Account | The Meta business entity that owns WhatsApp phone numbers. |
| CDR | Call Detail Record | A record of a phone call including duration, status, caller, and callee. |
| PBX | Private Branch Exchange | A telephone system (Issabel/Asterisk) for managing voice calls. |
| n8n | — | An open-source workflow automation tool used for complex multi-step integrations. |
| BSP | Business Solution Provider | A Meta-authorized provider of WhatsApp Business API access. |
| Annotation | — | An AI-generated analysis of a conversation (sentiment, topics, risk flags). |
| Embedded Signup | ES | Meta's OAuth flow for connecting WhatsApp Business accounts. |
| Canned Response | Quick Reply, Template | A pre-written message template for fast agent replies. |
| Segment | — | A dynamic group of contacts defined by filter criteria. |
| Touchpoint | — | A recorded interaction between your org and a contact (message, call, email, note). |