Marketing

WhatsApp CRM: Contact Lists, Lead Stages and Chat History on Your Own Number (2026)

A CRM is mostly a list of people, what you know about each one, and what happened last. Here is how those three pieces map onto WhatsApp with Blueticks, what each one can and cannot do, and where the Claude connector fits.

Maya Cohen8 min read

WhatsApp CRM: Contact Lists, Lead Stages and Chat History on Your Own Number (2026)
On this page

Most of your customers already talk to you on WhatsApp. The problem is that the conversations live in one app, the list of people lives in a spreadsheet, and what you know about each person lives in your head. A WhatsApp CRM is the attempt to put those three things next to each other so the next message you send is informed by the last one.

This guide covers what Blueticks gives you for that: contact lists with fields you define, lead records that an AI agent keeps while it answers, and chat history you can search and read. It also covers where the Claude connector fits and what you still need to handle yourself.

What does a WhatsApp CRM need to hold?

Three kinds of information, kept per person:

  • Who they are. A WhatsApp number, plus any fields you care about, such as a first name, a product, or a renewal date.
  • Where they are. A stage in the relationship, for example new, engaged, or qualified.
  • What happened. The conversation history, so the next reply does not start from zero.

The sections below map each one to a part of the Blueticks tools.

Contact lists with fields you define

A contact list in Blueticks is called an audience. You create one by name, and the audience tool lists these actions: list, create, get, update, delete, append contacts, update a contact, and remove a contact.

Each contact has a phone number or WhatsApp address and an optional set of variables. A variable is a key and a value you attach to that person, such as firstName or product. The tool description says each key becomes a token you can use in a message, and token matching ignores case.

Custom variables can also replace a built-in value. If you set firstName to a name yourself, that token resolves to your value instead of the WhatsApp profile name. The built-in tokens are whatsappname, displayname, phone, and mobile, and they are always available.

The contact field you keep current is the one that matters. When a customer tells you their renewal date moved, you update that contact rather than sending a note to yourself. The update and remove actions exist for exactly this.

A contact can be an individual, a group chat, or a newsletter channel, and all three are valid entries in an audience. A raw name is not valid, so the entry has to be a number or a WhatsApp address.

Lead records an agent keeps while it talks

Some of the CRM work happens inside the conversation. An agent on your number can record the chat it is serving as a lead for you. The lead tool takes a chat ID, a stage, and optional fields.

The stage must be one of five values: new, engaged, qualified, handed off, or closed. The agent calls the save again when the stage or a field changes, and that call updates the same lead rather than creating a second one.

The fields are defined by the agent owner, and the agent only fills the ones named for it. Any other field name is dropped. There is a limit of five fields per lead, each name up to 40 characters and each value up to 200 characters.

Two details matter when you decide whether to rely on this. First, if you write a definition of a hot lead, the records are scored for you afterwards, and the agent does not get the score back. Second, the tool description tells the agent to record the lead silently and never mention leads, stages, or scores in the chat. Your customer sees a normal conversation.

The tool also tells the agent not to record a support request, spam, or a personal chat as a lead.

The qualify tool is available to agent sessions. The tool definition states that it is only available to agent sessions, so it is not a function you call from a chat with Claude. The walkthrough for this behaviour is in our guide on a WhatsApp agent that qualifies leads.

Chat history you can search and read

The chat history tool reads conversations on the connected WhatsApp number. It lists chats, newest activity first, and can filter by a since date and by direct chats.

To find a customer, you search chats by name. The latest-chats option returns the most recent chats, each with its newest messages, in a single call. It takes up to 200 chats and up to 100 messages per chat.

The message action reads messages from one chat, from up to 25 chats in one call, or from all chats when you give no chat. Each result says whether the scan was complete. If it says the scan hit its cap, older matches may exist, so the search is incomplete. Check that field before you tell someone a message was never sent.

This is the part of the CRM that answers "what did we talk about last time?" before you reply.

Contacts you can look up

The contacts tool lists contacts and can filter them by a query. Results page with a cursor. Use it to find the person behind a name before you add them to an audience or check their chat.

Using a list to send a message

A CRM list becomes useful when you send to part of it. A campaign is created against one audience, and its text can use the variables from that audience's contacts.

The create action starts the send when you make the campaign, unless you set a later send time. The campaigns tool description instructs the assistant to confirm with you before it creates a bulk send. Read the audience and the text before you confirm.

If a contact is missing a variable that the message uses, the default is to reject the campaign at creation. The other option is to skip, which sends the literal token text to those contacts. Check your list before you run the campaign. The full mechanics of a bulk send are in our guide to mass WhatsApp messaging.

Working with all of it from Claude

Blueticks publishes a Claude connector. The default tool set that Claude clients see includes the audiences, campaigns, chats, contacts, and groups tools. That means you can ask Claude to look up a contact, read a chat's recent messages, update a contact field, or review an audience, all in one conversation.

The connector list is not the same in every assistant. ChatGPT's connector does not include creating or resuming campaigns, and it does not create or edit groups. Check the connector you use before you plan a workflow around a specific action.

Setup steps are in our guide to connecting WhatsApp to Claude with MCP.

Where the CRM stops

Blueticks gives you contact lists, custom fields, lead records, and chat history. Those four are what this guide covers. The audience actions listed above do not include deal objects, and this guide does not describe a sales pipeline with deal values or forecasts.

Lead recording is off by default for an agent, and the record is only as complete as the fields it was given. The follow-up itself is yours.

A four-step way to start

  1. List the fields you actually use. Keep them to a handful, so the same few fields exist on every contact.
  2. Load the contacts you already have. Create an audience and add each person with their variables.
  3. Check the numbers first. Send a small test campaign to a short audience of your own contacts and confirm each token filled in before you widen it.
  4. Turn the agent on when it is ready. A new agent waits for you to click "Turn it on".

FAQ

Is this a full CRM? It is a contact list with fields, lead records, and chat history. It has no deal values or forecasts. Leads move through five stages, from new to closed.

Can the agent see my whole chat history? The read tools see the chat the agent is answering in, plus any other chats you add. They do not see your other chats.

Will the customer know they have a lead record? The agent is told to record leads silently and not to mention stages or scores in the chat.

Can I change a contact's fields later? Yes. Editing a contact changes one contact inside an audience.

Does a campaign send right away? Yes, unless you set a later send time.

Which chat does a lead record belong to? The save action records the chat the agent is serving, and it takes that chat's ID. Calling the save again on the same chat updates the same lead.

Can a list include groups? Yes. An audience can include individuals, group chats, and newsletter channels.

Next step

Start with the contact list. Create one audience, add a few people with the fields you use, and check that the tokens fill in the way you expect before you send anything to the whole list.

Share this article

The Dispatch, every week.

One sharp WhatsApp growth tactic in your inbox each week. Joined by 238,000+ founders, marketers and support leads.

Free forever. No spam, unsubscribe in one click.

Also on TikTok: @blueticksagents