May 2023 - Version 3.39
  • 03 May 2023
  • 5 Minutes to read
  • Dark
    Light

May 2023 - Version 3.39

  • Dark
    Light

Article summary

Enhancements

Region-based Changes

The following changes were made to the activation of Blackthorn Messaging to accommodate differing regional requirements.

US

After you've completed the installation steps, it’s time to activate your Blackthorn Messaging account. When we say "activation," we are referring to a one-time process that will create a Messaging account and link it to your Salesforce org.

  1. Go to the Messaging Administration tab.

  2. You will see a dialog that asks if you already have a Messaging account. Click No, I need an account to indicate that you do not have a Messaging account.
    USBased Changes_1

  3. This will open the Account Registration dialog box.

    1. Set Account Region = “United States (US1)”.
    2. Review our Terms of Service and Privacy Policy.
    3. Click the I have read… checkbox.
    4. Click Activate Now.
      USBased Changes_2
  4. Click Yes, I have an account.
    USBased Changes_4

  5. Set Account Region = “United States (US1)”.

  6. Contact Blackthorn Support for the Account Number & API Key.

  7. Once you have the Account Number & API Key, enter them in the Account Number and API Key fields.

  8. Click Save. Your account is now registered and activated.
    USBased Changes_5

  9. To change the credentials, click the Change Credentials button.
    USBased Changes_6

  10. Update the fields as needed and click Proceed.
    USBased Changes_7

EMEA

After you've completed the installation steps, it’s time to activate your Blackthorn Messaging account. When we say "activation," we are referring to a one-time process that will create a Messaging account and link it to your Salesforce org.

  1. Go to the Messaging Administration tab.

  2. You will see a dialog that asks if you already have a Messaging account. Click No, I need an account to indicate that you do not have a Messaging account.
    EMEA Changes_1

  3. This will open the Account Registration dialog box.

    1. Set Account Region = “Europe (EU1)”.
    2. Review our Terms of Service and Privacy Policy.
    3. Click the I have read… checkbox.
    4. Click Activate Now.
      EMEA Changes_2
  4. Click Yes, I have an account.
    EMEA Changes_4

  5. Set Account Region = “Europe (EU1)”.

  6. Contact Blackthorn Support for the Account Number & API Key.

  7. Once you have the Account Number & API Key, enter them in the Account Number and API Key fields.

  8. Click Save.
    EMEA Changes_5

Your account is now registered and activated.

Card UI Changes

The UI for the Payment Methods section has been modified to be more user-friendly.
CardUICharge_1

  • Clicking the Add Card button opens a new window. This provides an easy and faster way to enter the First Name, Last Name, Card Number, Expiry Date, CVV and other details.
    CardUICharge_2

  • Alternatively, the user can click Choose Default Payment to make payments using the default Payment Method. Users can change the Payment Method at any time.
    CardUICharge_3

  • Once a card is set as the default Payment Method, it will remain the default Payment Method until changed.
    CardUICharge_4

  • User cannot delete a card if it is set as the default Payment Method.

  • Cards not set as the default Payment Method can be deleted at any time.
    CardUICharge_5

CardUICharge_6

Bug Fix

Community User Permission Set

Description

Users received the following error when trying to assign a Community user the standard Community permission set. “Can’t assign permission set Blackthorn Messaging Standard User - Community to user [name]. The user license doesn’t allow Assigned Apps”.

Resolution

To resolve this issue, we removed the Assigned Apps’ permissions. Complete the steps below to set up a Community user and share From Phone Numbers.

Setup Steps for Assigning Permission Sets to a Community User

  1. Click the Gear icon in the upper right-hand corner.
  2. Click Setup.
  3. Type “Permission Sets” in the Quick Find box.
  4. Click Permission Sets.
  5. Click Clone next to the permission set “Blackthorn Messaging Standard User – Community”.
  6. Set the Label to “Custom Blackthorn Messaging Standard User – Community”.
  7. Set the API Name to “Custom_Textey_Standard_User_Community”
  8. Click Save.
  9. Open the permission set that you just created.
  10. In the Apps section, click Assigned Apps.
  11. Click Edit.
  12. Remove the following Enabled Apps.
    • simplesms.Textey (simplesms__SimpleSMS)
    • simplesms.Textey (simplesms__Textey_ltng)
  13. Click Save.

You can now assign this permission set to Community users.

Create Community Users

  1. Create a new Account.

    1. Enter “Accounts” in the All Apps menu search.
    2. Click Accounts.
    3. Click New.
    4. Enter an Account Name. (We suggest using “Community Account”, but the Account Name can be anything.)
    5. Click Save.
  2. Create a new Contact.

    1. Enter “Contacts” in the All Apps menu search.
    2. Click Contacts.
    3. Click New.
    4. Enter a First Name and Last Name.
    5. Set Account Name to the Account created in Step 1.
    6. Enter a phone number in the Phone field.
    7. Click Save.
  3. Create a new user.

    1. In the Contact you just created, click the Enable Customer User button. (The button is only available if your org has Community access enabled.)
    2. Enter an Email.
    3. Enter a User Name
    4. Set License = “Customer Community Login”.
    5. Click Save.
  4. Assign a permission set.

    1. Click the Gear icon in the upper right-hand corner.
    2. Click Setup.
    3. Type “Permission Sets” in the Quick Find box.
    4. Click Permission Sets.
    5. Click the permission set you created in Setup Steps for Assigning
    6. Permission Sets to a Community User.
    7. Click Manage Assignments.
    8. Click Add Assignment to assign users to the permission set.
    9. Add the user you created in Step 3 and click Assign.

Sharing From Phone Number to the Community users

  1. Add an Account lookup to the Phone Number object.
    1. Click the Gear icon in the upper right-hand corner.
    2. Click Setup.
    3. Click the Object Manager tab.
    4. In the Quick Find box, enter “Phone Number”.
    5. Click Phone Number.
    6. Click the Fields & Relationships tab.
    7. Click New.
    8. Select Lookup Relationship.
    9. Click Next.
    10. Set Related To = “Account”.
    11. Click Next.
    12. Enter a Field Label and Field Name.
    13. Click Next.
    14. Click Next.
    15. Click Next.
    16. Click Save.
  2. Populate the Account in a Phone Number record.
    1. Go to the Messaging app.
    2. Open the Phone Number Tab that you want to share with a Community user.
    3. In the Account field, add the Account you created in Create Community Users – Step 1.
    4. Click Save.
      NOTE: If you want to make Phone Numbers available to other communities, clone the Phone Number record and add different Accounts to the Phone Number record.
  3. Your Phone Number sharing journey begins here.
    1. Go to Setup.
    2. In the Quick Find box, search for “Digital Experiences”.
    3. Open the Digital Experiences folder and click Settings.
    4. Scroll down to the Sharing Sets section.
    5. Click New.
    6. Set Label = “BT Messaging Phone Number Sharing”.
    7. Click into the Sharing Set Name field.
    8. In the Select Profiles section, select the profile of the Community users that you want to use the From Number.
      Example: Customer Community Login User and Customer Community Plus Login User
    9. In the Select Objects section, add the Phone Number object to the Selected Objects column.
      Note: The Phone Number object should be Public Read Only for Default External Access in OWD.
    10. In the Configure Access section, click Set-up.
      1. Set the Account for the user.
      2. Set Target Phone Number = “Account__c”.
      3. Set Access Level = “Read Only”.
      4. Click Update.
    11. Click Save.