skip to content
Back to homeTry for free

Add and edit contacts

Add one person by hand, change what you know about them, tag them, and remove a contact with everything that goes with it.

Version 1.0 · Last updated ·

Add a contact by hand

  1. Open Contacts and click New contact.

    The New contact window: phone number, name, email address, tags, and the box “They agreed to be messaged”.
  2. Type the number in Phone number, starting with + and the country code.

    For example +971 50 123 4567. Read the phone number below before you type a local number.

  3. Fill in what you know: Name, Email address, Tags.

    Only the number is required.

  4. Tick They agreed to be messaged only if this person said yes to receiving your messages.

    It is unticked when the window opens. Without it the contact is saved as No consent, and nothing is sent to them. See Consent and opt-outs.

  5. Click Add the contact.

    The window closes and a green line above the list says Added and the name. The contact is at the top of the list, with added by hand under the name.

On the screenWhat it does
Phone numberThe contact’s WhatsApp number. Required. One number can belong to one contact only: a number you already have is refused with You already have this number.
NameUp to 120 characters. Left empty, the list shows no name.
Email addressOptional. It is kept on the contact and exported with it. Nothing is sent to it: xconversions writes on WhatsApp only.
TagsOptional. Several tags are separated by commas: customer, vip. Up to 200 characters in all.
They agreed to be messagedThe contact’s consent. Tick it only when the person agreed. The line under the box says that you can still reply without it; today the app sends nothing to a contact without it, not even an answer. See the three states.
CancelCloses the window without adding anybody.
Add the contactSaves the contact.

The phone number

Write the number in full international form: +, the country code, then the number without the 0 a local number starts with. Spaces, dashes, dots and brackets are ignored, and 00 in front is read as +.

You typeWhat the app does
+971 50 123 4567 or 00971501234567Stores +971501234567.
Letters or other signs, for example 050 123 4567 ext 2Refuses it: That number cannot be messaged. Check the country code.
Fewer than 8 digits, or more than 15Refuses it with the same sentence.
Digits that are not 0 to 9, for example Arabic-Indic digitsRefuses it with the same sentence.
A local number that starts with 0, for example 0612345678Accepts it, takes the 0 off and puts +971 in front: +971612345678.
A number with no + and no 0 in front, for example 612345678Accepts it and puts + in front as it is: +612345678.

Edit a contact

  1. In the list, click the pencil at the end of the contact’s row.

    You can also arrive here from a conversation: the contact’s details in the Inbox have an Edit contact button. Search in the menu opens a contact here too.

    The Edit contact window for Demo Salma: phone number, name, remark name, email address, tags, owner, note, and the consent box.
  2. Change what you need.

  3. Click Save changes.

    The window closes. The green line above the list reads Added and the name after an edit too: nothing was added twice.

On the screenWhat it does
Phone numberCan be changed only while the contact has no conversation. After the first message it is locked, and the window says why: the number is what ties the conversation to this person.
NameThe name shown in the list and in the inbox. Up to 120 characters.
Remark nameOptional. What your business calls this person, beside the name they came with. It shows in the contact’s details in the inbox, and your AI agent can use it. Up to 120 characters.
Email addressOptional.
TagsEvery tag the contact has, separated by commas. This box is the whole list: a tag you delete here is removed from the contact.
OwnerThe colleague this customer belongs to, or Nobody. The AI agent can hand a conversation to the contact’s owner.
NoteOptional. Your own note about this person, up to 2,000 characters. Customers do not see it. It shows in the contact’s details in the inbox, and your AI agent can use it and add to it.
They agreed to be messagedThe contact’s consent: tick it or untick it. For a contact who asked to stop, this box is replaced by a red line with the date they asked. That cannot be changed.
Save changesSaves the contact.

Tags

A tag is a word or a few words you put on a contact, such as vip or showroom visit. Tags are how you group people.

  • A tag is always saved in small letters: VIP becomes vip. The same tag is never kept twice on one contact.
  • You add tags by hand in the two windows above. An import adds the tags of a file’s tags column. Your AI agent adds tags when its skill Add contact tags is set, and a workflow does with its step Add tags.
  • Tags are used in segments, which pick everybody who has or has not a tag, and in workflows, which can start when a tag is added.
  • There is no list of tags to manage. A tag exists for as long as one contact carries it.

Custom fields

A contact can also carry facts under names of your own, such as Budget or Interested in. They come from the columns of an imported file that you keep with Keep as a custom field, and from your AI agent when its skill Update contact attributes is set to save them.

Custom fields are not shown in the list or in the Edit contact window, and cannot be typed there. You meet them in three places: segments can pick contacts by an imported column, a campaign or a workflow can put one into a template’s variables, and the export lists them.

To change a custom field for many people, import a file again with their numbers and the column: the file’s value replaces the old one.

Remove a contact, and what goes with it

  1. In the list, click the bin at the end of the contact’s row.

    The confirmation: Remove this contact and every conversation with them? This cannot be undone. Two buttons: Cancel and Remove.
  2. Click Remove to confirm.

    To remove several at once, see Select several contacts and remove them.

WhatWhat happens to it
The contact, with its tags, note and custom fieldsRemoved.
The conversation with them, and every message in itRemoved.
Their place in segments and in workflowsRemoved.
Campaigns that already wrote to themKeep their figures. The line for this person stays in the campaign’s results, with a dash for the name and the number it was sent to.
The record that they asked you to stopRemoved with the contact.

Good to know

  • Who can do this: people whose access includes Contacts and segments. See Roles and access.
  • The Contacts screen has no button that opens a contact’s conversation. Open the Inbox and search the name or number: see Find a conversation.
  • When a customer changes their WhatsApp number and WhatsApp reports it, the contact follows them: the number changes by itself, and the conversation, tags and consent stay.

Still stuck?

A person on our team answers. In the app, open the help button in the corner of any screen. From here, write to us.