If you've been with us for some time, you may be on an older, legacy version of the NetSuite integration. In order to take advantage of regular product updates, 24/7 support, and new features, we advise all our users migrate to the latest version - the SMS for NetSuite SuiteApp.
Important - in order to proceed with the bundle migration, please be advised:
|
Identify Your Version
Before starting migration, check which bundle version you’re currently using:
1. Go to Customization > SuiteBundler > Search & Install Bundles > List
2. Search for MessageMedia:
3. Identify which version you're using and select the section below for specific migration instructions:
-
Versions 3.0.0 through to 3.8.4 = NetSuite Bundle
- Versions below 3.0.0 = NetSuite Legacy SOAP Bundle
Migrate from NetSuite Bundle | versions 3.0.0 through to 3.8.4
Step 1 | Backup MessageMedia Record Lists
1. Search for and select the MessageMedia SMS Template page in the top global search bar:
2. Click on the icon for Export - CSV or Export - Microsoft Excel and save the file somewhere safe:
3. Repeat for the following record lists:
- MessageMedia Metadata
- MessageMedia Preferences
- Batch SMS list
- MessageMedia API Credentials
- MessageMedia Webhook Config
Step 2 | Install and Setup the SMS for NetSuite SuiteApp
1. Follow the instructions to enable the required SuiteFlex features before installing the application, then return here to continue.
2. Follow the instructions to install the application, then return here to continue.
3. Follow the instructions to create an access token, then return here to continue.
Step 3 | Run the Migration Wizard
1. Go to Setup > MessageMedia Migration > Run Migration Scripts.
2. Select a single record type from the list and click Submit.
3. Wait for the record type to show as Completed in the Data Migration List to the right.
4. Repeat for the next record type until they all show as completed in the Data Migration Status List.
Note - for the Webhook Configuration record type, make sure to add in the Token ID and Token Secret created previously. |
Step 4 | Migrate Workflow Actions
All workflows with messaging actions must be migrated before uninstalling the old bundle, otherwise none of the workflows will migrate across. Note that these workflows will not be able to be retrieved once the old bundle is uninstalled.
1. Open the workflow containing a messaging action(s) and click the Edit.
2. Double click on the State that contains the Create record action to trigger a message.
3. Open the Create Record action with record type MessageMedia SMS Workflows.
4. Change the Record Type field from MessageMedia SMS Workflows to MM - SMS Workflow Job.
5. Take a screenshot of the parameters section to save the information. Example below:
6. Click on each field in the Field column and click Remove.
7. For each required item below, re-enter the field and proper value by referencing the screenshot you saved earlier:
- Record ID - In the Formula column, this will be the internal ID of the record you’re sending the SMS from. Such as {id} or {createdfrom.id}, depending on what record you’re sending the SMS from.
- Record Type - In the Text Column, this will be the record type of the record you’re sending the SMS from (i.e. "salesorder" or "supportcase").
- Entity ID - In the Formula column, this will be the internal ID of the entity you’re sending the message to (i.e. "{customer.id}" or "{id}").
- Entity Type - In the Text column, this will be the record type of the person you’re sending the message to (i.e. "customer" or "contact").
- SMS Template - In the selection column, this will be the SMS template that will be used to populate the message contents (the template type must match the “Record Type” field).
Important - if you leave any of the fields unchanged, the workflow action will reference the old bundle and will cause errors. |
7. Repeat the workflow migration steps for each workflow with MessageMedia SMS Workflows Create Record actions.
Step 5 | Uninstall the Old Bundle
1. Go to Customization > SuiteBundler > Search and Install Bundles > List.
2. Find the MessageMedia bundle (version 3.8.4 to 3.0.0).
3. Hover over the green icon on the left side.
4. Click on Uninstall.
Note - This process could take 1-2 hours depending on how many messages have been sent and received. |
RETURN TO TOP |
Migrate from NetSuite Legacy SOAP Bundle | versions below 3.0.0
Step 1 | Backup MessageMedia Record Lists
Important - Failure to backup your message history will result in the loss of all SMS message history when you perform the upgrade. |
1. Search for and select the MessageMedia SMS Template page in the top global search bar:
2. Click on the icon for Export - CSV or Export - Microsoft Excel and save the file somewhere safe:
3. Repeat for the following record lists:
- MessageMedia Metadata
- MessageMedia Group SMS list
4. Go to Setup > Company > General Preferences.
5. Go to the Custom Preferences subtab and save / screenshot the MessageMedia section.
Step 2 | Install and Setup the SuiteApp
Install and setup the SuiteApp by following the Quick Start Guide, then return here to continue.
Step 3 | Migrate Workflow Actions
All workflows with messaging actions must be migrated before uninstalling the old bundle, otherwise none of the workflows will migrate across. Note that these workflows will not be able to be retrieved once the old bundle is uninstalled.
1. Open the workflow containing a messaging action(s) and click the Edit.
2. Double click on the State that contains the Create record action to trigger a message.
3. Open the Create Record action with record type MessageMedia SMS Workflows.
4. Change the Record Type field from MessageMedia SMS Workflows to MM - SMS Workflow Job.
5. Take a screenshot of the parameters section to save the information. Example below:
6. Click on each field in the Field column and click Remove.
7. For each required item below, re-enter the field and proper value by referencing the screenshot you saved earlier:
- Record ID - In the Formula column, this will be the internal ID of the record you’re sending the SMS from. Such as {id} or {createdfrom.id}, depending on what record you’re sending the SMS from.
- Record Type - In the Text Column, this will be the record type of the record you’re sending the SMS from (i.e. "salesorder" or "supportcase").
- Entity ID - In the Formula column, this will be the internal ID of the entity you’re sending the message to (i.e. "{customer.id}" or "{id}").
- Entity Type - In the Text column, this will be the record type of the person you’re sending the message to (i.e. "customer" or "contact").
- SMS Template - In the selection column, this will be the SMS template that will be used to populate the message contents (the template type must match the “Record Type” field).
Important - if you leave any of the fields unchanged, the workflow action will reference the old bundle and will cause errors. |
7. Repeat the workflow migration steps for each workflow with MessageMedia SMS Workflows Create Record actions.
Step 4 | Uninstall the Old Bundle
1. Go to Customization > SuiteBundler > Search and Install Bundles > List
2. Find the MessageMedia bundle (version below 3.0.0).
3. Hover over the green icon on the left side.
4. Click on Uninstall.
Note - This process could take 1-2 hours depending on how many messages have been sent and received. |
RETURN TO TOP |
Comments
0 comments
Article is closed for comments.