The address book

The address book keeps the phone numbers and emails of the organizations and people you work with, in one place for your whole account.

It is not tied to a survey, a form or a project, and it is there on every plan, with no limit on the number of records.

Why use it

Most organizations keep their contacts in a phone, a few spreadsheets and someone's memory. When that person is away, the number is gone. The address book replaces all of that with one directory the whole team can search.

  • One source of truth. Everyone finds the same, up-to-date number or email instead of asking around.
  • Fast in the field. Results appear as you type, and one tap calls, opens WhatsApp or writes an email.
  • Private when it must be. A record you mark Private is seen only by you.
  • Reach many people at once. Send an email or a text to a tag or a filter, each person getting their own copy, with a stop link and a record of what was sent.
  • Clean and portable. Import from Excel, CSV or your phone, spot and merge duplicates, and export whenever you want. Your contacts are never locked in.
  • Included for everyone. It is on every plan, with no limit on the number of records.

What it holds

  • Organizations (a partner, a donor, a school, a clinic) and people (a person can belong to an organization).
  • Several phone numbers and emails for each record, each with a label such as work, mobile or WhatsApp, and one marked as the main one.
  • A city and country, a job title, a website, notes, tags you choose, and custom fields you define.

Open Address Book in the menu to see the list.

Add a record

  1. Click Add organization or Add person.
  2. Type the name. For a person, choose their organization if they have one.
  3. Add phone numbers and emails. A number can be typed the way you would dial it from your country; pick the country if it has no +.
  4. Click Save.

If a number or an email already belongs to another record, you see a warning with a link to it. You can still save.

Find someone quickly

Start typing in the search box at the top. Matches appear under the box as you type: names, parts of a name, a phone number (with or without the leading zero), an email, the organization, a tag or a city. Arabic spellings are forgiving: فاطمة finds فاطمه.

  • Click the star on a record to keep it under Favourites.
  • The last records you opened are under Recently opened.
  • Use Filters to narrow the full list by kind, organization type, organization, city, country, job title, tag or a custom field.

Call, message, copy

On a record, one tap on a number calls it (Call) or opens WhatsApp, and one tap on an email opens your mail program. Copy puts a number or an address on your clipboard.

Private records

When you add or edit a record you can mark it Private. A private record is seen only by you. Nobody else sees it, not even the account administrator, and it never appears in their search, lists, exports or message recipients.

  • Only the person who created a record can make it private or share it again.
  • An organization that a Monitoring project uses as a partner cannot be private, because everyone who opens the project must see its partners.
  • If a user is removed from the account, their private records are deleted with them. Their shared records stay.

Tags and custom fields

Tags group records ("Board", "Q4 meeting"). Tick several records and choose Add tag to tag them all at once, then filter by that tag.

Under More, then Settings, you can add custom fields of your own, for organizations, people or both: text, number, date, yes/no or a list of choices.

Import and export

  • Import reads an Excel (.xlsx) or CSV sheet, or the .vcf file a phone exports. You match the columns before anything is saved, choose what to do with a row that matches an existing record (skip, update or add as new) and get a report with every rejected row and the reason. You can mark everything you import as private.
  • Export writes the current list, or the rows you ticked, as an Excel sheet or a vCard file. It contains only the records you can see.

Duplicates, deleting and the trash

  • More → Possible duplicates suggests records that share a phone number or an email. Merge two of them: you choose, field by field, which value stays, and every number, email, tag, person and project link of both records is kept.
  • Delete moves a record to the Trash, where it stays for 30 days and can be restored. When you delete an organization you choose whether its people are deleted too or kept without an organization.
  • An organization that is a partner of a project cannot be deleted until it is taken off those projects.

Send an email or a text

Tick records (or choose every match of a filter) and click Send email or Send SMS. Before anything is sent you see how many people can be reached and who will be skipped and why (no address, asked to stop, address that does not receive email, not a mobile number, the same address twice).

Email

  • Each person gets their own copy. Nobody sees who else was written to.
  • Use {name}, {organization} and {job_title} in the subject or message to fill in each person's own details.
  • Your signature is added at the end. Write it once, from your own settings page (My signature) or while you compose, or untick it for one message.
  • Every email ends with a link that lets the person stop receiving emails from your organization. It opens in the language you were using when you sent it.
  • An account can send a limited number of emails a day; the preview shows how many are left and when the allowance renews.
  • Email leaves from the platform's address under your name and your organization's, and replies come to you. If your organization verifies its own domain (More → Settings → Sending domains), people with an address on that domain send from their own address instead.

Note email sending is switched on by the platform. If you do not see Send email, it has not been switched on yet.

Text messages (SMS)

  • A text costs credit from your SMS credit. The preview shows the cost per country and the total against your balance. If the credit does not cover the send, nothing is sent and you are offered a way to add credit.
  • Numbers on the do-not-text list, and numbers that are not mobiles, are skipped.

Under More → Sends you can follow each send, and on a record's History tab you see everything that was sent to it.

Send from your organization's own domain

By default an email leaves from the platform's address, under your name and your organization's. If your organization verifies its own domain (for example alamal.org), people with an address on that domain send from their own address, and the emails are signed so that they are trusted (see below).

Set it up (an administrator with the settings permission, and someone who can edit your domain's DNS records):

  1. Open More → Settings → Sending domains.
  2. Type your organization's domain, such as alamal.org, and click Add domain. Use your own domain: a public mail service such as Gmail or Outlook cannot be verified, because only its provider can publish the records.
  3. The screen shows three records (type CNAME). Click Copy beside each and publish them where your domain's DNS is managed, usually your domain registrar or hosting provider.
  4. Optionally add the recommended _dmarc record that the screen shows, which helps your mail reach the inbox.
  5. Click Check now. It can take some hours for the records to be seen, so you can come back later: the platform also checks again by itself every hour.

What the status means

  • Waiting for the records: the domain was added, and the records are not seen yet.
  • Verified: done. People with an address on this domain now send from it.
  • Failed: the records did not appear within 72 hours, or they were removed later. Sending goes back to the platform's address, so no email is lost, and the administrators are told. Publish the records again and click Check now.

Good to know

  • A colleague whose address is on another domain, such as a personal Gmail, keeps sending from the platform's address, under their name and your organization's.
  • Remove takes a domain off the list. From then on, people on it send from the platform's address again.
  • You do not see Sending domains until email sending has been switched on by the platform, like Send email.

Why emails from your own domain are trusted

When your organization verifies its own domain, every email sent from it is signed with DKIM. Amazon, which delivers the email, puts a digital signature on each message using a private key. The matching public key is published in your domain's records: the three records you add when you verify it.

The signature gives the receiving mail service two guarantees:

  • The email really comes from the owner of the domain. Someone pretending to be you cannot produce a valid signature for your domain, so they cannot send as you without being noticed.
  • The content was not changed on the way. If a single character of the message is altered in transit, the signature no longer matches.

Mail services use this to decide whether an email is genuine or spam, so a signed email is less likely to land in the spam folder. You do not need to do anything after verifying the domain: signing is automatic. If the domain stops verifying, the next email goes from the platform's address and an administrator is told.

Who can do what

Access is controlled by roles: view, edit, delete, import, export, send and settings (the last also opens the activity log). The account owner has them all. A role has none until you give it some.

When the account is read-only (for example after a trial ends), you can still view, search and export, but not add, change, delete, import, merge or send.

Activity

People with the settings permission can open More → Activity to see who created, edited, deleted, merged, imported, exported or sent what, and when. It can be filtered by action, user and date. Looking at a record is not logged. An entry about someone else's private record appears only as A private record.