We're excited to announce updates to TextIt's contacts module. The contacts module, which comprises all logic related to the people who interact with your account via a channel, allows you to assign them any number of attributes, including the individual's name, phone number, and any other information pertinent to your use case. What's more, each contact's attributes can be updated in real time as they interact with your workflows, or through our contacts API endpoint, which can update values using information provided by any of the other web services your organization might be using.
Added Flexibility - Contact Addresses
Each contact has an address, or URN, to which messages from your TextIt account are sent. Addresses represent the ways in which you can connect with each contact. The most common address type is a Phone Number, though a contact can also have a Twitter Handle, Telegram Identifier, Email Address, and any External Identifier you wish to add. Before, contacts were limited to one address per address type, though they could be assigned multiple address types. Now, each contact can be assigned multiple addresses of the same type - meaning you can now assign multiple phone numbers to a single contact. This addresses the concerns of users who deploy in countries where contacts frequently change phone numbers to take advantage of rotating airtime deals, or possess dual SIM phones or even multiple phones. In these cases, a contact's addresses can be prioritized, in which case they'll appear on a contact's profile page in the order in which they're prioritized:
Adding and Prioritizing Addresses
To accommodate these changes, we've restructured the settings menu in each contact's profile page:
- 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 possess multiple channels (e.g. multiple phone numbers).
- The contact initiates contact through an incoming message.
Custom Field Editing
With the Update Contact dialogue now exclusively dedicated to editing a contact's default fields and addresses, custom fields have been given their own dialogue. Whereas custom fields can be created via the "Manage Fields" button on the contacts tab, they can now be manually updated via the settings menu in each contact's profile:
Contact Imports & Exports
Contacts can be imported with multiple address types, but only one address for each type:
Contact addresses can be added 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 or using List Contacts request in the API Explorer:
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.
As always, if you have any questions about what's possible or suggestions on how to make things easier, let us know! Look out for additional updates in the coming weeks.