The Codex CRM Panel in Outlook

The Codex CRM panel in Outlook

Available once an administrator turns it on. The panel appears in Outlook only after an administrator deploys the add-in to you and journeys are enabled.

Most of your email starts in Outlook, not in Codex. The Codex CRM panel brings the CRM into Outlook with two buttons: one that tracks a message you are writing, and one that saves a message you received to a person’s timeline. This lesson covers both buttons, the choices in the panel, and the sentences it shows.

What you need first

The panel works for a user who:

  • holds the CRM User role;
  • has connected Microsoft 365 (Module 1);
  • has an enabled CRM mailbox;
  • uses a supported Outlook: Outlook on the web, the new Outlook for Windows, Outlook for Windows (classic) in a recent build, or Outlook for Mac.

Outlook on iOS and Android is not supported. An older Outlook shows “This version of Outlook does not support the Codex sign-in.”

The two buttons

The add-in adds a Codex CRM group to the message window, with one button in each mode:

Mode Button What it does
Writing a message Track in CRM Tracks the message for the person you choose, so opens and clicks are recorded
Reading a message Save to CRM Saves the message to the timeline of the person you choose

Both open the same panel, titled Codex CRM.

The panel

  • Person: Codex lists the CRM people who match the message. If none match, the panel says “No person in Codex matches this message. Search by name or email address.”
  • Search for a person: finds a person by name or email address.
  • Opportunity: optional. Choose an opportunity of the person’s company, or leave No opportunity.
  • Attach to the open journey: followed by the journey’s name: a checkbox that appears when the person has an open journey you may act on. If the journey belongs to someone else, the panel says “This person has an open journey that belongs to someone else.”

Then select the button at the bottom, Track in CRM or Save to CRM.

Track in CRM

Use it on a message you are writing:

  1. Finish writing the message, including its links.
  2. Select Track in CRM in the ribbon, choose the person, and select Track in CRM in the panel.
  3. The panel puts a tracked version of the body into the message, with tracked links, the open pixel, and the opt-out line, and marks the message so Codex can recognize it. The panel shows Tracked.
  4. Send the message from Outlook as usual.

Codex never sends the message. Outlook sends it, from your own address. After it leaves, the next mailbox reading finds the copy in Sent Items, files it on the person’s timeline marked Tracked in Outlook, and starts tracking the conversation. Your signature, added by Signature365 after the message leaves, is untouched.

Selecting Track in CRM again on the same draft returns the same record and adds no second pixel. If the panel says “The message was tracked, but Outlook did not accept the tracking header. Select Track in CRM again to retry.”, select it again.

Save to CRM

Use it on a message you received:

  1. Open the message and select Save to CRM.
  2. Choose the person and select Save to CRM in the panel.
  3. The panel shows Saved.

Codex reads the message from your mailbox through your own connection and files it on the person’s timeline marked Saved from Outlook. It keeps the addresses, subject, times, the cleaned text, and the names, sizes, and types of attachments. It never stores the content of an attachment and never changes the message.

The rules the panel keeps

  • Ordinary CRM email is always allowed. The panel never refuses a message. For a person who is on the suppression list or marked Do Not Contact, Track in CRM writes no record, the panel says “This email will not be tracked for this person.”, and the message goes out as written.
  • One tracked person per message. With several recipients, the panel says “This message has more than one recipient. Only the person chosen is tracked.”
  • No duplicates. Saving a message already on the person’s timeline answers “Already saved.”
  • Outside mail only. A message whose participants are all Isidore addresses is not saved: “This message has no outside participants, so it was not saved.”
  • Stale drafts. A tracked draft that is never sent is marked failed after seven days, and an Outlook Draft Stale exception opens.

Panel sentences and fixes

Sentence Fix
“Connect Microsoft 365 in Codex first.” Connect on the Microsoft 365 page
“This account cannot use the Codex CRM.” Ask an administrator for the CRM role
“No Codex mailbox is set up for this account.” Ask an administrator to enable your mailbox
“Sign in to Codex again.” Close the panel and open it again

What you should remember

  • Track in CRM is for a message you are writing. Save to CRM is for a message you received.
  • Finish the message first, track it, then send it from Outlook. Codex never sends it.
  • Timeline entries read Tracked in Outlook and Saved from Outlook.
  • A suppressed or Do Not Contact person’s message goes out untracked. The panel never blocks a message.
  • Attachments are listed by name, never stored.

The next lesson covers your Bookings page and the meetings Codex notices on your calendar.