> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/digital-agent/campaigns/contacts-and-metadata.md).

# Contacts and metadata

How to upload contacts and pass personalised data (metadata) to the voicebot.

Each contact in a campaign is a **phone number** with optional **metadata** - any extra data about the contact (name, contract number, amount due, preferred language...). The voicebot can read the metadata during the call and use it to personalise the conversation, see [Campaign smart functions](https://docs.borndigital.ai/digital-agent/campaigns/campaign-smart-functions.md).

## Uploading contacts

On the campaign detail page click **Upload** and choose an Excel file (`.xlsx` or `.xls`).

* Only the **first sheet** is read; the **first row** must contain column headers.
* One column must contain the phone number. Name it **`phone_number`** (variants such as `phoneNumber` or `cell_phone` are accepted too).
* **Every other column becomes metadata** - the column header is the key, the cell is the value.
* Use lowercase headers with underscores (`first_name`, `contract_id`) - you will reference them by these names in the flow.

**Example**

| phone\_number | first\_name | contract\_id | amount\_due |
| ------------- | ----------- | ------------ | ----------- |
| +420601234567 | Jana        | C-1001       | 1200        |
| +420702345678 | Petr        | C-1002       | 450         |

## Phone number format

* Use the international format with the country prefix, e.g. `+420601234567`.
* A phone number may have at most **16 characters** - longer values are skipped.
* Duplicate numbers are removed. If you upload a number that is already in the campaign, its metadata is updated.

## Adding and removing contacts

* **Upload** another file to add more contacts - also to a running campaign. New contacts are queued immediately.
* **Add number** in the *Numbers* list adds a single number (digits and `+` only) without metadata.
* Contacts can be deleted from the list (one by one or in bulk). A call that is already in progress is not interrupted.
* Metadata of a contact can be edited in the contact detail (**Metadata** > **Add** / **Save Changes**) until the contact has been processed.

## Limits

| Limit                                   | Value                                                                                                                       |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| File size                               | 10 MB                                                                                                                       |
| Contacts per upload into one campaign   | 5,000 - the remaining contacts are automatically placed into copies of the campaign named `<campaign name> n.1`, `n.2`, ... |
| Contacts held by one campaign at a time | 10,000 - when a **continuous** campaign is full, the oldest contacts are removed to make room for new ones                  |

{% hint style="info" %}
Feeding a **continuous** campaign from a CRM or web form is done by a server-to-server integration. Contact Born Digital if you need one.
{% endhint %}
