All contacts
Store WhatsApp, Telegram, and email recipients — use them in Send, campaigns, and groups.
Open Contact → All Contacts.
What this page is for
The Contacts directory is your shared address book across channels. Each person has a name, at least one reach identifier (WhatsApp, Telegram, or email), optional notes, custom extra data fields, and membership in one or more groups.
Use contacts when sending from Send → Send (single recipient or bulk Contact target), campaigns, and recurring sends. Device settings can also auto-add inbound senders to a group — see Auto-add from devices.
Sample data shown.
Contact list
| Control / column | What it does |
|---|---|
| Import | Open the import dialog — CSV file or Google Sheet. |
| Add Contact | Create one contact manually. |
| Search | Field-based — pick Name, WhatsApp, Telegram, or Email, then type (minimum 3 characters). See Search contacts. |
| Select all on this page | Tick every row on the current page for bulk delete. |
| Delete all / Delete selected (N) | Permanently remove contacts. Groups remain; member lists are cleared. |
| Name | Display name. Shows notes, an N extra badge for custom fields, and group chips when set. |
Phone in international format without + (for example 628123456789). | |
| Telegram | Telegram user or chat ID. |
| Email address for email sends. | |
| Actions | Edit or Delete on each row. |
Pagination appears at the bottom when you have more rows than one page.
Every contact needs at least one of WhatsApp, Telegram, or email. Name is required.
Search contacts
Search is field-based — click the search area first, pick which column to search, then type your query (minimum 3 characters).
| Step | What you do |
|---|---|
| 1. Click search | A Search in popup opens — choose Name, WhatsApp, Telegram, or Email before typing |
| 2. Type query | Kirisan filters the list after you reach the minimum length |
| 3. Switch field | Click the field pill on the left (for example Name ▼) to change columns — switching clears the query |
| Search field | Matches |
|---|---|
| Name | Contact names that contain your text (case-insensitive) |
| WhatsApp numbers that contain your digits | |
| Telegram | Telegram user or chat IDs that contain your text |
| Email addresses that contain your text |
If you type fewer than three characters, Kirisan waits and shows a short hint under the search bar.
Add or edit a contact
Click Add Contact or Edit on a row.
Sample data shown.
| Field | What to enter |
|---|---|
| Name | Required — shown in the list and send pickers. |
Digits only, country code included, no +. | |
| Telegram | Numeric user or chat ID from Telegram. |
| Used for email channel sends. | |
| Notes | Private label (for example VIP customer) — not sent to recipients. |
| Add to group | Search and tick one or more Contact → Groups lists. |
| Extra data | Custom key/value pairs (for example city, promo_code) — available as template variables when sending. |
Click Add Contact (or Save when editing).
Import contacts
Click Import on the list page.
Sample data shown.
CSV file
- Choose CSV file.
- Click the drop zone and pick a
.csvfile, or use Download example for a starter file. - Optionally pick groups to add every imported row to.
- Click Import.
Sample data shown — row 1 is the header; data starts on row 2.
Expected columns (first row = header; names are flexible):
| Column | Required | Notes |
|---|---|---|
name | Yes | Skipped if empty. |
whatsapp | One of three | Also matches headers like phone, number, wa. |
telegram | One of three | Also matches tg. |
email | One of three | |
notes | No | Stored on the contact. |
| Any other header | No | Becomes extra data (for example city, promo_code). |
Example header row:
name,whatsapp,telegram,email,notes,city,promo_codeEach row must have name plus at least one of whatsapp, telegram, or email.
Duplicate WhatsApp, Telegram, or email
Each identifier belongs to one contact only per account — the same WhatsApp number, Telegram ID, or email cannot be stored on two contacts.
Import does not update an existing contact when a row repeats an identifier that is already saved. Kirisan creates a new contact only when the identifier is free.
| Import path | What happens on a duplicate identifier |
|---|---|
| CSV file | That row fails with a save error. Rows before the failure are already saved; the import stops and shows the error. |
| Google Sheet | The batch containing the duplicate fails. Earlier batches (up to 500 rows each) may already be committed; the toast reports how many were imported and skipped. |
To change name, notes, groups, or extra data for someone already in the directory, use Edit on their row instead of re-importing.
Duplicate rows within the same file behave the same way: the first row wins; later rows with the same identifier fail.
Google Sheet
- Switch to Google Sheet.
- Paste the sheet URL (
https://docs.google.com/spreadsheets/d/…). - Share the sheet as Anyone with the link — Viewer (or publish to web).
- Use the same column names as CSV (
name,whatsapporphone,email,notes, plus extra columns). Telegram is supported on CSV import; the Google Sheet importer currently maps phone / whatsapp and email only. - Optionally assign a group, then click Import.
Up to 10,000 rows per Google Sheet import. Invalid rows (missing name or identifiers) count as skipped in the result toast. Rows with identifiers already on file may fail the batch — see Duplicate WhatsApp, Telegram, or email above.
Use contacts when sending
| Send target | How contacts are used |
|---|---|
| Contact (no campaign name) | Pick one contact from the directory. |
| Contact (with campaign name) | All contacts or a custom multi-select — saved as a campaign. |
| Recurring campaign | Reloads All contacts or your selection on each run. |
See Send messages and Campaigns.
Extra data fields can fill template placeholders when the send flow supports variables — see Variables.
Auto-add from devices
When editing a WhatsApp, Telegram, or WABA device, Contacts → Auto-add senders to group can save new inbound senders automatically:
- Open Channel → channel → Devices.
- Edit the device.
- Under Contacts, pick a group (or leave None).
- Save.
New chatters are added to All Contacts (if new) and placed in that group. This is separate from manual import on this page.
Tips
- Use groups to segment newsletters, VIPs, or regions — see Groups.
- Keep WhatsApp numbers in a consistent international format to avoid duplicate-looking entries.
- Import a CSV first, then refine rows with Edit for notes and extra fields.
- Delete all clears every contact but keeps group definitions empty.
Related
- Groups — segment contacts for sends and auto-add
- WA Groups — WhatsApp group chats (not contact lists)
- Send messages — Contact send target
- Campaigns — bulk and recurring contact sends
- WhatsApp Devices — auto-add senders to a group
- Telegram Devices — auto-add senders to a group
- Variables — extra data in templates