How the FeedSync Companion matches and updates agents and staff

Every listing from your CRM names its agents. The FeedSync Companion links each listing to the right agent on your website, creates any agent you don't have yet, and leaves the details you've edited on your site alone. Here's how it works, and what to do when you want your CRM's agent details on the site.

1. Choose what an agent becomes

Go to FeedSync › Settings › Import and set Agent Creation:

Setting What it does
Do not create agents Nothing is created. The listing just carries the agent's CRM username.
Create WordPress users Each agent becomes a WordPress user, linked to their listings.
Create users and staff directory entries A WordPress user and an EPL Staff Directory entry (if you use the Staff Directory add-on).
Create staff directory only (no users) A Staff Directory entry, no WordPress user.

Agent Creation in FeedSync › Settings › Import

2. How an agent is matched

FeedSync gives every agent a permanent FeedSync agent ID that stays the same when their email changes, when they move between feeds, and when agents are merged. The Companion matches an agent on your site in this order:

  1. The FeedSync agent ID (or the ID of an agent profile that was merged into it). Once an agent is matched, the ID is stamped on their user and Staff Directory entry, so from then on they're always found by it.
  2. The agent's CRM username, for agents first linked before the ID existed.
  3. The agent's email address, but only if the name matches too.

If none of those match, a new agent is created.

Agents who share an office email. Many agencies give every agent the same email (sales@agency.com.au). WordPress only allows one user per email, so when a second agent arrives with an email that already belongs to someone else, the Companion gives them their own account with a tagged address (sales+jane-smith@agency.com.au). Most email providers deliver mail sent to a tagged address to the main inbox, but not all of them do, so send a test email to one before relying on it. Agents with the same name get unique usernames.

3. What a listing update changes

When a listing comes in from your CRM:

  • A new agent is created with everything the CRM sends: name, email, phones, position and social links.
  • An agent you already have is only linked to the listing (and stamped with their FeedSync agent ID). Their name, email, phones, position and social links stay as edited on your website.

The Companion doesn't bring agent photos across from your CRM, so a photo you add to an agent on your site is never replaced.

So you can tidy up an agent's profile on the site and the next listing won't undo it.

4. Bring your CRM's agent details across: Sync Agents

When you do want the CRM's details on your site (a new phone number, a new position), go to FeedSync › Dashboard and press Sync Agents. It reads every agent in your FeedSync feeds and updates the existing users and Staff Directory entries with the CRM's details, as well as creating any that are missing.

Sync Agents needs an Agent Creation setting other than Do not create agents.

Fix an agent who was linked wrongly

If listings point at the wrong agent, fix the agent on the listing in your CRM. When the listing next comes through from FeedSync, the Companion relinks it to the right agent; photos are only downloaded again if they've changed. If a listing still shows the wrong agent after that, contact support and we'll send its agents through again.