Contacts and leads
Your customers, the attributes you keep about them, and the leads agents collect.
On this page
Contacts are your customers: the people your agents talk to, with the details you choose to keep about them. Leads are the details your agents collect in conversations.
Where contacts come from
- 1Signed-in visitor chatsvia identity verification
- 2Agent collects an emailCollect leads action
- 3You add or import them
- 4One contact per personmerged by user id, then email
- Signed in: a visitor your site verified.
- Collected: a lead an agent collected.
- Imported or added by hand.
The same person is never two contacts. Records are merged by the user id on your site first, then by email.
Work with contacts
In Contacts you can:
- Search by name, email, phone or user id.
- Add contact by hand, or Edit one. User id on your site is what identity verification signs as
user_id. - Open a contact to see their conversations and what they submitted.
- Export CSV of every contact. Formulas are neutralised, so it opens safely in Excel.
- Delete a contact. Their conversations and leads are kept, just no longer linked to them.
Owners, admins and support agents can change contacts; members can only read them.
Import from CSV
- Select Import contacts and choose a CSV file, up to 5,000 rows.
- Columns are matched by name:
email,name,phone,external_user_id, and the key of any attribute you have declared (below). - Rows merge into existing contacts. Afterwards you see what was imported, which rows had errors and why, and which columns were ignored.
email,name,phone,external_user_id,plan
amina@example.com,Amina K.,+250788000000,cust-1042,pro
Contact attributes
Attributes are the extra facts you keep about customers, such as plan, company or signup date. Declare them in Contacts → Attributes (up to 50):
- Add an attribute with a key (for example
plan), a label and a type: text, number, yes/no or date. - Tick Agents can see it if the agent may use it.
Declaring attributes matters because only declared attributes are kept. A CSV column or a JWT claim with an undeclared name is ignored. That way nobody stores personal data by accident.
Attributes that agents can see:
- are told to the agent, with the customer's name, so it can answer personally ("You're on the Pro plan, so…")
- can be used in procedures as
{{contact.plan}}
Leads
The Leads page lists everything your agents' Collect leads and Collect details actions saved, newest first: contact details, case details, the agent and the conversation. Download CSV to take them to your CRM or spreadsheet. Collected emails also create or update contacts.
Related
Something not working as described here? See Troubleshooting.