Contacts
Contacts is your address book: the people a campaign can reach. Each contact is one phone number with an optional name, email, tags, groups, time zone, custom fields and a record of where consent came from. Numbers are encrypted at rest, and opted-out contacts are never sent a campaign message.
Add a contact
Section titled “Add a contact”-
Open Contacts in the sidebar under Audience.
Open Contacts. -
Click Add contact.
Click Add contact. -
Enter the Phone number. Pick the country on the left, then type the number as people dial it locally. Add a first and last name if you have them, and type a tag into Tags and press Enter.
Enter the number, name and tags. -
Under Consent from, choose where the person agreed to receive messages, and paste the wording they agreed to into Consent wording. Then click Add contact.
Record consent, then click Add contact.
The form also has Groups (tick the groups the contact joins), Time zone (leave it on From the number unless the person lives in a different zone from their number’s country) and Custom fields (key and value pairs such as branch = Maadi that you can use in messages as {{custom.branch}}). One number can only be one contact: adding a number you already have returns an error.
Find contacts
Section titled “Find contacts”Type into the search box to match a name, an email, a full number with its country code, or the last 4 digits. Narrow the list with the Tag, Group and opt-out status filters; Clear filters resets them.
The Status column shows Consent on file, No consent record or Opted out. Export CSV downloads the filtered list; it needs the logs:export permission.
Edit a contact or opt them out
Section titled “Edit a contact or opt them out”-
Click a contact to open their details, then click Edit.
Open the contact and click Edit. -
Turn on Opted out of campaigns and click Save contact. Campaigns skip the contact from then on. Turn it off again only if the person asks to receive messages again.
Turn on Opted out of campaigns, then save.
To delete someone for good, open the contact and click Erase contact, then type the confirmation word. Their tags and group memberships go with them; messages already sent stay in the message log, and a STOP opt-out stays on the blacklist.
Consent and opt-outs (STOP)
Section titled “Consent and opt-outs (STOP)”Record consent when you add or import a contact: the source (web form, paper form, in person, SMS keyword, import, API or other) and the wording the person agreed to. The details panel shows it under Consent.
A contact can opt out in two ways:
- They reply STOP. When an inbound SMS is only a stop word, such as
STOP,UNSUBSCRIBE,CANCEL,END,QUIT,OPTOUTor Arabicإيقاف,إلغاءorتوقف(case, spacing and end punctuation are ignored), SMSFabric adds the number to the blacklist, marks the contact opted out and stops every campaign message to that number that no phone has taken yet. The contact shows Replied STOP. A laterSTART,UNSTOPorSUBSCRIBE(اشتراك) reply undoes it. - Your team marks them. Use Opted out of campaigns as above. The contact shows Marked by your team.
Groups
Section titled “Groups”Groups are static lists, such as a branch or a loyalty tier. A campaign can target several groups and tags at once, and each contact still gets one message.
-
On Contacts, click Groups.
Click Groups. -
Under New group, enter a Name and an optional Description, then click Create group.
Name the group and click Create group. -
Click a group to see its members.
Click a group. -
The contact list opens with the Group filter set to that group. Add to with the group’s name adds more contacts to it.
The list shows the group's members.
Add existing contacts to a group
Section titled “Add existing contacts to a group”-
On Groups, click the person-plus icon on the group’s row (or Add to on its filtered contact list).
-
Search by name, email, number or the last 4 digits, and tick the contacts to add. Contacts already in the group are ticked and greyed out with Already in this group. Then click Add with the count, for example Add 2 contacts.
-
The group’s member count goes up straight away. The notice says how many were added and how many were already there; click Undo in it to take them out again.
To put a new contact in a group, tick it under Groups in the Add contact form. You can also fill a group during a CSV import (Add everyone to a group, below), or add existing contacts in bulk with POST /v1/contact-groups/:id/members (see the contact groups reference). Use the pencil and bin icons in the groups table to rename or delete a group. Deleting a group keeps its contacts.
Import a CSV
Section titled “Import a CSV”Use a UTF-8 CSV with a header row and one column of phone numbers; every other column is optional. From Excel or Google Sheets, save as “CSV UTF-8”. A file can be up to 5 MB and 100,000 rows.
-
On Contacts, click Import CSV.
Click Import CSV. -
Drop your file on Contacts CSV or click it to choose one, then click Upload and map columns.
Choose the file and upload it. -
Check how each column will be imported. SMSFabric guesses from the header names; change any column under Import as. Choose exactly one column as Phone number. A column set to Custom field becomes a variable you can use in messages, and Don’t import skips it.
Map each column. -
Under Options, choose the country for numbers written without a country code, an optional group and tags for everyone in the file, and where consent came from. Leave Update contacts that already exist on to refresh contacts you already have; turn it off to skip them.
Set the import options. -
Click Import with the row count, for example Import 4,120 rows. You can leave the page; the import keeps running.
Start the import. -
Read the report: how many rows were added, updated and skipped, and why each skipped row was left out, with its line numbers.
Read the report.
Rows are skipped for these reasons:
| Reason | What to do |
|---|---|
| No phone number | Fill the phone cell on that line. |
| Not a valid number | Check the digits, or set the country for numbers without a country code. |
| Same number earlier in the file | Nothing; the first row was imported. |
| Already a contact | Turn on Update contacts that already exist to update them instead. |
| On your blacklist | Remove the number from the blacklist only if the person asked to hear from you again. |
| Email is not valid / A field is not valid | Fix the cell and import the file again. |
Every upload is listed under Recent imports with its report. The API equivalent is described in the contact imports reference.
Permissions
Section titled “Permissions”| To | You need |
|---|---|
| See contacts and groups | contacts:read (every role except Billing) |
| Add, edit, erase, import contacts and add them to groups | contacts:manage (Owner, Admin, Developer, Campaign manager, Agent) |
| Export CSV | contacts:read and logs:export |
See Team for the full role table, and the contacts reference for the API.