Outlook Hello Contacts | VBA Macro #33

Share on facebook
Share on twitter
Share on linkedin
Starting an email with a Hello can look more personable with some VBA code! The Hello Contacts Outlook macro automates the entry of the text Hello followed by the First Name of the recipient you are emailing. This Outlook macro uses the recipient’s email address to loop through all the existing contact records for a matching email address. If a match is found the contact’s First Name field value is used in the beginning of the email. This macro can be fired from a custom button or trigger automatically when replying to an email. To utilize the Hello Contacts macro, you will need to add contacts in Outlook.  If you haven’t created an Outlook contact before checkout this link to see the multiple ways to do this. You can create a contact directly from an email message, with an import, or manually from scratch.

See it in Action!

Watch this video to see this macro in action.

The Code

Here is the code for this macro. Make sure the following References are setup before running it: Visual Basic For Applications, Microsoft Outlook 16.0 Object Library, Microsoft Office 16.0 Object Library, Microsoft Word 16.0 Object Library
***Recent Code Updates
07.26.2021 Updated ContactItem variable to Dim As Outlook.ContactItem. Removed olInspector variable. Help Outlook resolve recipients if code is running using Recipients.ResolveAll.
09.12.2021 With an update to Office 365 SMTP Email Addresses were no longer being recognized in the code. Made a handful of updates to handle this going forward. Now looking for Recipient.Address containing “EXCHANGE ADMINISTRATIVE GROUP” to determine if SMTP PropertyAccessor needs to be used to evaluate actual Email Address. In Outlook Contact also looking to Email Display Name instead of Email Address when evaluating SMTP. This required an update to SetColumns to include Email1DisplayName. Thoughts were that Recipient.DisplayType = olRemoteUser would help but didn’t seem to resolve the issue so removing for now.
Copy the Code
'Leverage & Lean "Less Clicks, More Results"
Sub HelloContacts()
Const PR_SMTP_ADDRESS As String = "http://schemas.microsoft.com/mapi/proptag/0x39FE001E"
' Means that these variables are in use
Dim ContactEmailAddress As String '
Dim ContactItem As Outlook.ContactItem '
Dim ContactItems As Items '
Dim ContactName As String '
Dim EmailCurrent As Outlook.MailItem '
Dim HelloContacts As String '
Dim objApp As Application '
Dim objNS As NameSpace '
Dim olDocument As Word.Document '
Dim olInspector As Outlook.Inspector '
Dim olSelection As Word.Selection '
Dim Recipient As Recipient '
Dim RecipientEmail As Object '
Dim RecipientEmailAddress As String '
Dim SMTPCheck As Boolean '
Dim SMTP As Outlook.PropertyAccessor '
On Error GoTo LeverageLean
Set olInspector = Application.ActiveInspector()
Set RecipientEmail = olInspector.CurrentItem
RecipientEmail.Recipients.ResolveAll 'Ensure Outlook has resolved all recipients before capturing RecipientEmailAddress
For Each Recipient In RecipientEmail.Recipients 'Loop through all the Recipients
If Recipient.Type = olTo And RecipientEmailAddress = "" Then 'If the Recipient is in the To field
If InStr(1, Recipient.Address, "EXCHANGE ADMINISTRATIVE GROUP") > 0 Then
SMTPCheck = True
Set SMTP = Recipient.PropertyAccessor
RecipientEmailAddress = SMTP.GetProperty(PR_SMTP_ADDRESS) 'Capture the first Recipient listed in the To field
ElseIf InStr(1, Recipient.Address, "EXCHANGE ADMINISTRATIVE GROUP") = 0 Then
RecipientEmailAddress = Recipient.Address 'Capture the first Recipient listed in the To field
End If
End If
Next Recipient
Set objApp = CreateObject("Outlook.Application")
Set objNS = objApp.GetNamespace("MAPI")
Set ContactItems = objNS.GetDefaultFolder(olFolderContacts).Items 'Set Contacts Folder
ContactItems.SetColumns ("Email1Address, Email1DisplayName, FirstName") 'Set Columns to only look to a Contact's Primary Email Address and First Name value
For Each ContactItem In ContactItems 'Loop through the Contacts Items
If SMTPCheck = True Then
ContactEmailAddress = ContactItem.Email1DisplayName 'Set the Contact's Email Address using Display Name to help with SMTP Address
ElseIf SMTPCheck = False Then
ContactEmailAddress = ContactItem.Email1Address 'Set the Contact's Email Address
End If
If InStr(1, ContactEmailAddress, RecipientEmailAddress) > 0 Then
ContactName = ContactItem.FirstName 'Set the ContactName with the Contact's First Name
End If
If ContactName = "" Then 'If no Contact Name is found
HelloContacts = "Hello," & vbNewLine & vbNewLine
ElseIf ContactName <> "" Then 'If a Contact Name is found
HelloContacts = "Hello " & ContactName & "," & vbNewLine & vbNewLine & vbNewLine
End If
Set olDocument = Application.ActiveInspector.WordEditor
Set olSelection = olDocument.Application.Selection
olSelection.TypeText HelloContacts 'Enter Hello Contacts at the beginning of the email
Set ContactItem = Nothing
Set ContactItems = Nothing
Set objApp = Nothing
Set objNS = Nothing
Set olDocument = Nothing
Set olInspector = Nothing
Set olSelection = Nothing
Set SMTP = Nothing
Exit Sub
MsgBox (Err.Number & " - " & Err.Description & vbNewLine & vbNewLine & "Don't hesitate to email me: brentschneider@leveragelean.com")
End Sub
'Stay Awesome!

Macro Monday

Here is the Macro Monday video this macro was featured in. Watch this video to learn how to get the most out of this macro and start using it today!


Although you can create a custom button to trigger the Hello Contacts macro on command you can also automate this macro with some additional VBA code.

Here is the additional code that can be used to fire this macro with Outlook’s Reply and Reply All buttons. Copy and Paste this VBA code into your Outlook Session and restart Outlook. You must make your Hello Contacts macro Public so it can be called within your Outlook Session.
'Leverage & Lean "Less Clicks, More Results"
Option Explicit
Private WithEvents oExpl As Explorer
Private WithEvents oItem As MailItem
Dim bDiscardEvents As Boolean
Dim oResponse As MailItem
Private Sub Application_Startup()
Set oExpl = Application.ActiveExplorer
bDiscardEvents = False

'Call the Macros listed below:
'Call MacroName
End Sub
Private Sub oExpl_SelectionChange()
On Error Resume Next
Set oItem = oExpl.Selection.Item(1)
End Sub
Sub oItem_Reply(ByVal Response As Object, Cancel As Boolean)
On Error GoTo LeverageLean
Cancel = True
bDiscardEvents = True

'Display current email selection
Set oResponse = oItem.Reply

'Call the Macros listed below:
'Call MacroName

Exit Sub


End Sub
Sub oItem_ReplyAll(ByVal Response As Object, Cancel As Boolean)
On Error GoTo LeverageLean
Cancel = True
bDiscardEvents = True

'Display current email selection
Set oResponse = oItem.ReplyAll

'Call the Macros listed below:
'Call MacroName

Exit Sub


End Sub
'Stay Awesome!

First time using VBA?

The Developer Tab is an additional section of the ribbon when activated allows you access to Visual Basic in Applications like Access, Excel, Outlook, PowerPoint, Word.
Setup Now
Once the Developer Tab is available you will have the capability to update your security to allow Macros to run in the current application.
Setup Now
A sub of code is a collection of objects and variables. For the code to successfully run a library of references needs to be set.
Setup Now
Subscribe as an Insider to receive additional rights.
If you like our content and want to show your support tip us here!

Contact Us

Looking to improve your computer processes?
Leverage & Lean is here to help!

Leverage & Lean

Is focused on improving computer processes by Leveraging programming and applying Lean principles. It is our goal to make you more efficient and effective on your computer producing “Less Clicks and More Results!”