Contacts
Everyone your team talks to on WhatsApp, in one list
Contacts come in automatically from the WhatsApp numbers you connect, and you can add people by hand with a tag and opt-in status. Search the list and open a chat with anyone by phone number.
On this page
In short
Contacts in whatsappx.si are the people behind your WhatsApp conversations. They sync in from the numbers you connect by QR code or through the official WhatsApp Business Platform, you can add more by hand with a tag and opt-in status, and every teammate in the workspace can search them and start a chat by phone number.
What is in the contacts list?
A simple, shared address book for WhatsApp, built for answering people well.
Synced from WhatsApp
When a person messages a connected number, they appear as a contact with the name and number WhatsApp provides. Nothing to import.
Manual contacts
Add someone before the first message: full name, phone number with country code, an optional tag and whether they opted in.
Search
Type a name or number to find a contact instead of scrolling. The inbox has the same search for conversations.
Tags
When you add a contact, give it one short free-text tag such as "Lead", "Customer" or "Supplier" so teammates know who they are talking to.
Opt-in status
When you add a contact, record whether the person agreed to hear from you. Contacts show "Opted in" or "Not recorded", a reminder to message only people who asked.
Start a chat by phone number
Enter an international phone number from the inbox to open a conversation with someone who has not messaged you yet.
Where do contacts come from?
There are two sources, and both land in the same list.
1. Synced from your connected WhatsApp numbers. When you link a WhatsApp or WhatsApp Business app number by scanning a QR code, whatsappx.si becomes a linked device, like WhatsApp Web (WhatsApp Help Center), and recent chat history syncs in. Each person in that history becomes a contact. Numbers connected through Meta’s official WhatsApp Business Platform work the same way: when someone messages your business number, a contact is created from the sender’s details. From then on, every new conversation adds the sender automatically.
2. Added by your team. Anyone in the workspace can add a contact from the Contacts page, and developers can create contacts through the REST API. This suits people you already have permission to message but who have not written to you yet, for example a customer who ticked "contact me on WhatsApp" on your order form.
A contact record is deliberately small: a name, a phone number stored as digits with the country code, and, for contacts you add, one tag and an opt-in flag. whatsappx.si is not a full CRM. If you keep customer records elsewhere, the REST API can list and create contacts, and outbound webhooks forward incoming messages to your own system.
How do you add a contact and start a chat?
Open Contacts and choose "Add contact"
Every role in the workspace, including agents, can add a contact.
Enter the name and phone number with country code
Numbers are digits with the country code and no leading zero, for example 14155550123 or 919876543210. Add a short tag if you want one.
Record opt-in only if the person really agreed
Tick "This contact has opted in to WhatsApp messages" when the person gave you their number and asked to hear from you. Otherwise leave it unticked and the list shows "Not recorded".
Start the conversation from the inbox
Choose to start a new conversation, enter the international phone number and write your first message. If you have several connected numbers, it is sent from the number selected in the inbox. The chat then appears in the shared inbox like any other.
How do contacts relate to conversations and assignment?
A contact is the person; a conversation is the thread with that person on one of your connected numbers.
- The inbox reads from contacts. The name and tag shown on each conversation come from the matching contact, so teammates can see who they are talking to.
- Assignment lives on the conversation. Owners and admins assign a thread to a teammate from the chat view, and the inbox can be filtered to "mine", "unassigned" or a specific colleague. Agents see only the chats assigned to them. Assignment is about who answers right now, so it belongs to the thread, not the contact.
- Unread counts follow the conversation. A new message raises the unread count, and marking the conversation as read clears it for the team.
- Contacts are shared, not personal. Every workspace member sees the same list. When a colleague is on leave, the context is still there.
For example, a small clinic could let patient conversations sync in from its number, add suppliers by hand with the tag "Supplier", assign new patient conversations to whoever is on duty and keep supplier chats with the manager.
How do synced and manual contacts differ?
| Feature | Synced from WhatsApp | Added manually or by API |
|---|---|---|
| How it is created | Automatically, when a person messages a connected number | By a teammate in Contacts, or a POST to the contacts endpoint |
| Name and phone number | Taken from WhatsApp | Entered by you, digits with country code |
| Tag and opt-in flag | Not set ("No tag", "Not recorded") | Set when you add the contact |
| Can start a chat from it | Yes | Yes |
| Best for | Replying to people who contact you | People who asked to be contacted first |
Either way, a person messaging you does not by itself mean they agreed to marketing. Record opt-in only when you have it.
Can developers work with contacts?
Yes. The REST API exposes the same contacts your team sees: GET /api/v1/contacts lists them, POST /api/v1/contacts creates one (phone as 8–15 digits with the country code, no leading zero) and DELETE /api/v1/contacts/{id} removes one. Requests carry an API key as a Bearer token, and each key belongs to one workspace. Read-only keys can list contacts; full-access keys can also create and delete them. Outbound webhooks forward incoming messages to your own system. Examples are in the in-app API docs and on the API and webhooks page.
Frequently asked questions
Do my existing WhatsApp contacts import automatically?
Can I start a WhatsApp chat with someone who has not messaged me?
Who can add or delete contacts?
Will connecting my contacts to whatsappx.si get my WhatsApp number blocked?
Related
Feature
Shared inbox
Answer customer WhatsApp chats as a team: one shared inbox with search, assignment, unread counts and live updates. Connect by QR code or the official API.
Feature
API and webhooks
Send WhatsApp messages, list conversations and contacts, and receive incoming messages by webhook from your shared inbox. Bearer keys, signed webhooks, SSE.
Glossary
Opt-in
Opt-in is a person’s permission to receive WhatsApp messages from your business. Meta requires it before you message anyone, and opt-outs must be honored.
Resources
Features
Everything whatsappx.si does.
Bring your team into one WhatsApp inbox
Create a workspace, connect a number by QR code or the official API, and invite your teammates.