Contact addresses are a type of default contact field, just like Name and Groups. Contact addresses can be added, edited and prioritized from the Update Contact dialogue, accessed through the “Edit” option in each contact profile’s settings drop-down menu:
The Update Contact menu, accessed via the ‘Edit’ option above, provides an input for you to add connections of all types. One connection can be added at a time; multiple connections will need to be added one at a time.
The upward-pointing arrows to the right of the address fields are what you’ll use to prioritize your contact’s addresses. We recognize the topmost address as the priority, which is an important indicator for outbound messages. Let’s assume your account has Phone Number, Twitter and Telegram channels connected and you send a message to 3 contacts, each with a different address priority. The channel that corresponds with each contact’s address priority will send them the message. That is to say, you’d have 3 channels processing 1 send message request; your Twitter channel will send to those with a Twitter address priority, your Telegram channel will send to those with a Telegram address priority, and so on. Otherwise, channel priority behavior remains the same: A contact’s address type priority will dictate which channel type will send messages to the contact.
If you have multiple channels of the same type connected to your account, the channel that the contact last initiated contact with will be prioritized. Contacts will be locked-in to a relationship with a specific channel (they’ll only received messages from this channel) if each of the following conditions is met:
- You have multiple channels of the same type connected to your account.
- The contact’s address type priority corresponds with the channel type (e.g. phone number) that possesses multiple channels (e.g. multiple phone numbers).
- The contact initiates contact through an incoming message.
Using a Contact Import
Contacts can be imported with multiple address types, but only one address for each type.
You can update a contact’s field values by including the contact field and its value in your import. Contact addresses, a type of default field value, can be added but not replaced via an import, so long as the UUID column contains the UUID(s) of the contact(s). Contact UUIDs can be obtained by exporting your contacts (UUIDs are included in each contact export).
We will return all of the information associated with your contact(s), including their UUID(s).
Replacing Addresses
At this time, contact addresses may only be replaced via the Contacts API Endpoint or a contact’s profile page as outlined above.