User Guide · Inbox & Contacts

Contacts

Every person who has talked to you, across channels: segments, groups, import, export, merged identities and lifetime value.

Contacts is your customer database. Every conversation creates or updates a contact, and Inboxi groups conversations that belong to the same real person into one contact row. Open it from the people icon on the icon rail.

The contacts list

inboxi.app/contacts
Contacts in grid view, with platforms and segments on the left.
  1. 1Filter by platform: Gmail, Instagram, Telegram, Facebook, Widget, Slack, WhatsApp.
  2. 2Smart segments: Favorites, Unanswered, New this week, Hot leads, Idle (30d+), Unassigned.
  3. 3Message: start a new conversation with a contact.
  4. 4Sort, and switch between list and grid view.
  5. 5Import, Export and New Contact.

Below the segments, Groups are your own lists (VIP, Wholesale, Event 2026). Create one with New Group, then add contacts to it from a contact's menu or in bulk.

Merged identities and lifetime value

A person may talk to you on several channels or numbers. On each contact row you may see:

BadgeMeaning
💬 3 chatsThis contact has several conversations that were merged into one person: same email address, same website visitor, or the same phone number writing to different WhatsApp numbers. The inbox still shows each conversation separately.
💰 4 · 1.2KLifetime value: number of orders and total spent, matched by phone number. Hover it for the exact figures.
Group chipsThe groups the contact belongs to.

If Inboxi spots possible duplicates (contacts sharing a phone or email), a banner offers Review, which selects them so you can handle them from the bulk bar.

Bulk actions

Select contacts with their checkboxes to open the bulk bar: Message, Export, Add to group and Delete.

The contact page

inboxi.app/contacts/…
A contact's page: profile, editable details and tabs.
  1. 1Tabs: Details, Chats, Orders, Courses, History, Notes, Tags.
  2. 2Add tags right from the profile card.
  3. 3Edit first and last name, email, phone, city, country, company and bio.
  4. 4Send Message, or Save Contact after editing.
TabContent
DetailsProfile, contact fields and social media links.
ChatsAll conversations linked to this person.
OrdersTotal orders, total spent and the order history.
CoursesEnrolled courses and progress (education workspaces).
HistoryThe full conversation history.
NotesTeam notes about the contact.
TagsCustom tags assigned to the contact.

Import contacts

Click Import to bring contacts in from a CSV file. The importer has three steps: Upload, Map columns and Review & import.

inboxi.app/contacts/import
Step 1 of the contact importer.
  1. 1Upload → Map columns → Review & import.
  2. 2Drop a CSV file here.
  3. 3Download template: a CSV with the right headers.
  4. 4Import Purpose decides how duplicates are handled.

File rules

  • Each row needs a phone number or an email. Everything else is optional.
  • Phone numbers can use English or Arabic digits.
  • The file must be a .csv with headers in the first row, up to 20 MB.
  • Groups and Tags accept several values separated by | or ,; missing groups and tags are created for you.

Columns you can map

First Name, Last Name, Phone, Email, Country Code, Groups, Tags, Lifecycle (a stage name from Settings), Notes and Assigned Agent (agent email or name).

Import purpose

OptionBehavior
Add new contacts onlyNew contacts are created. Existing contacts (matched by phone or email) are left unchanged.
Update existing contacts onlyExisting contacts are updated; new rows are skipped.
Add & update contactsNew contacts are created and existing ones updated.
Add all contacts despite duplicatesEvery row is created, duplicates included. Use with caution.

Export

Export downloads the contacts you're looking at (or the ones you selected) as a file. To export everything, including conversations, use Settings › General › Exports.

Contacts can also be created and updated through the API. See Contacts API.