Macha

How Do You Connect Salesforce to Intercom for an AI Agent? (2026)

Abbas, Customer Support & AI, Macha

Written by

Ankeet Guha, Co-founder & CTO, Macha

Reviewed by

Published August 5, 2026

Updated October 6, 2026

Intercom's native Salesforce app syncs leads, contacts, cases and tasks for human teammates on the Advanced and Expert plans. For an AI agent that looks up and updates Salesforce records on its own inside a conversation, you add a Custom Tool that calls the Salesforce REST API.

Key takeaways

  • Intercom's native Salesforce app runs on the Advanced and Expert plans and needs a Salesforce edition with API access, such as Enterprise or Unlimited.
  • The Salesforce app for Intercom creates leads, cases and tasks and syncs attributes both ways, but a teammate's click or a Workflow triggers each action, not an AI agent.
  • Salesforce blocks the creation of new Connected Apps from Spring '26 unless Salesforce Support enables it, while existing connected apps keep working.
  • A Macha Custom Tool calls the Salesforce REST API with OAuth 2.0, so an AI agent can run a SOQL query by email, and Write tools that update a case or log an activity require confirmation before they run.
  • On the trial and every Macha plan, the Macha team builds and tests the Salesforce tools and the agent for you, at about $0.40 a ticket including setup and a dedicated success manager who handles your changes.
How Do You Connect Salesforce to Intercom for an AI Agent? (2026)

You connect Salesforce to Intercom in one of two ways: install Intercom's own Salesforce app, which is available on the Advanced and Expert plans and syncs leads, contacts, accounts, cases and tasks, or give an AI agent a Custom Tool that queries the Salesforce REST API live inside the conversation. The native app serves human teammates and rule-based automations; the Custom Tool is for an agent that decides for itself when to look something up.

Intercom's Salesforce appMacha Custom Tool
Intercom planAdvanced or ExpertAny Intercom plan Macha connects to
Salesforce editionOne with API access (Enterprise, Unlimited, or Professional with the API add-on)Same: it calls the REST API
What it doesShows Salesforce data in the Inbox, creates leads, cases and tasks, syncs attributes both waysRuns the exact query or write you define, when the AI agent decides it's needed
Who triggers itA teammate's click, a Workflow or a global triggerThe AI agent, mid-conversation
WritesFixed set: lead, case, taskAny endpoint you define, behind a confirmation step
SetupAn admin installs it from the Intercom App StoreDone for you by the Macha team, with a dedicated success manager, included
Framing first. Macha runs on top of the Intercom you already use. It's an AI-agent layer, not an Intercom or Salesforce replacement. Fin and your Inbox keep working as they do; Macha reads the conversation, reasons, and reaches into Salesforce to answer or act.

Want the broader picture on connecting any app to Intercom? See our pillar on building custom Intercom integrations. This piece focuses on giving your AI agent live Salesforce access.

What does Intercom's native Salesforce app do?

Intercom offers a native Salesforce app in the App Store, and it does more than display data. Per Intercom's help article on using the Salesforce app (checked 24 September 2026), it can:

  • Show a live Salesforce panel in the Inbox: name, email and owner for a contact; domain and country for an account; owner, stage, close date and amount for an opportunity.
  • Sync attributes in the direction you choose, Intercom to Salesforce or Salesforce to Intercom.
  • Route conversations to the lead owner automatically.
  • Create a Salesforce lead with one click, create a case for an existing contact, and send a conversation or note to Salesforce as a task.
  • Create and update cases automatically from Workflows and global triggers.

Requirements matter here. Intercom's install guide says the app is available on the Advanced and Expert plans, and it needs a Salesforce edition with API access. Group, Contact and Professional editions lack API access unless you buy it as an add-on on Professional. One more thing worth knowing: from the Spring '26 release, Salesforce blocks the creation of new Connected Apps unless you ask Salesforce Support, and points customers to External Client Apps instead. Existing connected apps keep working, but setup steps in older guides may no longer match what you see.

Where does the native app stop?

  • The actions are fixed. You get the lead, case and task actions the app exposes, not the specific query or write your workflow needs ("is this account past due?" or "update the renewal field on the opportunity"). Leads are the only record type it creates from Intercom; contact creation happens in Salesforce.
  • A human or a rule pulls the trigger. A teammate clicks "Create Lead", or a Workflow fires on a condition you set in advance. An AI agent can't decide to look something up mid-conversation, pass the right parameters, and reason over the result.
  • Some syncs are one-way. Auto Case Creation only sends data from Intercom to Salesforce; the Salesforce case ID doesn't come back to the conversation without a custom build on the Intercom REST API.

For a lot of teams, the native app is the right tool. For anyone who wants their AI agent to actually use Salesforce, there's a lighter, more flexible path.

What should an AI agent do with Salesforce?

The high-value version of this integration isn't a displayed field. It's the agent doing the work. A customer messages Intercom; the agent recognizes them, looks up their live Salesforce account by email, and answers "yes, your Enterprise plan includes that" or "I can see your renewal is next month", grounded in Salesforce, not a stale copy. That's what a Custom Tool enables.

How do you connect Salesforce to an AI agent with a Custom Tool?

A Custom Tool is a single action you define once and point at Salesforce's REST API. No marketplace app, no code.

1. Point it at the Salesforce API. Salesforce exposes a REST API (with OAuth 2.0); you give Macha the endpoint and credentials. The built-in Sidekick can scaffold the request from a plain-English description if you'd rather not fill in the form.

Macha's Build with AI Sidekick for Custom Tools, suggesting starting points like 'Connect Stripe to look up payments'
Macha's Build with AI Sidekick for Custom Tools, suggesting starting points like 'Connect Stripe to look up payments'

2. Define the action. Give it a label and a description the AI uses to decide when to call it, e.g. "Get the Salesforce account, plan, and renewal date for a customer by email". Set the method and URL (a SOQL query against the Salesforce REST API, with an {{email}} placeholder), and choose Read or Write. A lookup is a Read; updating a case or logging to an opportunity is a Write, which requires confirmation before it runs.

Macha's Create Custom Tool builder: a label, a description, method GET, a URL with a placeholder, and Type set to Read
Macha's Create Custom Tool builder: a label, a description, method GET, a URL with a placeholder, and Type set to Read

3. The agent uses it live. Once the tool exists, the agent calls it mid-conversation, passes the customer's email, and reasons over the Salesforce record it gets back, then answers the question or takes the next step.

How do you keep Salesforce writes safe?

Because a Custom Tool can reach into Salesforce, the guardrails matter: Read tools (lookups) are free to call; Write tools (update a case, log an activity, change a field) require confirmation. Each tool is scoped to one action and permissioned per agent, and Macha keeps a record of every run. Salesforce's OAuth handles credentials, so secrets never live in the conversation.

Teams usually build a few Salesforce tools and group them (a lookup, a "log conversation to opportunity," a "flag account") alongside tools for their other systems.

A Custom Tools list in Macha showing tools grouped by service, each tagged Read or Write with its own API endpoint.
A Custom Tools list in Macha showing tools grouped by service, each tagged Read or Write with its own API endpoint.

Should you use the native app or a Custom Tool?

  • Use the native Salesforce app if you're on Intercom Advanced or Expert and want Salesforce data in the Inbox, one-click lead and case creation, and conversation logging for human agents.
  • Use a Custom Tool when you want your AI agent to look up live Salesforce data or take an action from the conversation, or you need a specific query or write the native app doesn't expose. The two can coexist. Macha is the done-for-you option: the Macha team builds and tests the Salesforce tools and the agent on your Intercom, then runs it in safe mode, with drafts as internal notes, until the drafts are right. That's included on the trial and every plan at about $0.40 a ticket, which covers setup and a dedicated success manager who handles your changes.

What else can the agent do once it reaches Salesforce?

The same pattern covers more: check an account's plan or entitlement before answering, read the open opportunity and owner to route a VIP, log the conversation to the account timeline, or flag churn risk. And because Custom Tools aren't Salesforce-specific, the same approach connects your billing system, data warehouse, or internal API. See the Custom Tools integration directory for 200+ tools, or the full pillar on building custom Intercom integrations.

Ready to try it? See how Custom Tools work, browse the integration directory, or start a free trial ($50 of usage, no credit card) and wire up your first Salesforce tool today.

Frequently asked questions

Does Intercom have a native Salesforce integration? Yes. The Salesforce app in the Intercom App Store shows Salesforce data in the Inbox, syncs attributes, creates leads and cases, and logs conversations as tasks. It's available on the Advanced and Expert plans. A Custom Tool adds live, agent-driven lookups and actions.

Which Salesforce edition do I need? One with API access. Intercom names Enterprise and Unlimited; Professional needs the API add-on, and Group and Contact editions don't work. A Custom Tool calls the same REST API, so the same rule applies.

Do I need an engineer to connect Salesforce to Intercom this way? No. On the trial and every plan, the Macha team builds and tests the Salesforce tools for you. To build one yourself, you describe the action in plain English and Macha's Sidekick scaffolds the Salesforce request, OAuth, and parameters. Technical teams can go deeper with full control over the SOQL query, headers, and response mapping.

Can the agent update Salesforce, or only read it? Both. Reads (lookups) run freely; writes, such as updating a case or logging an activity, require a confirmation step, and you control which agents can use them.

Is it secure? Yes. The tool is scoped to a single action, permissioned per agent and authenticated via Salesforce OAuth, and Macha records every run.

Macha

About Macha

Macha is an AI agent platform that works on top of the help desk you already use (Zendesk, Freshdesk, Gorgias, Front, Intercom or HubSpot) and connects to the rest of your stack, even your own internal systems. It is done for you: the Macha team analyzes your past tickets, builds the knowledge base and the agents, and runs them in safe mode until the drafts are right. Pricing is about $0.40 a ticket, and that includes setup and a dedicated success manager who handles your changes. Learn more about Macha →

Zendesk
5.0 on Zendesk Marketplace

Loved by support teams worldwide

See what support teams are saying about Macha AI.

The application seems excellent to me! We are still testing, and we need support for some details and they were extremely efficient too!

Daniela Costa

Daniela Costa

Head of Support, Seabra

Macha has been a great addition to our support toolkit. It generates clear, well-organized responses that fit naturally into our workflow. One feature we particularly appreciate is its ability to automatically reply in the same language as the ticket.

Marius F

Marius F

Support Head, Zentana

We've been using Macha for a little while now and it's been really great addition so far! It's powerful, convenient, and makes getting work done a lot easier for our agents.

Alexander Wedén

Alexander Wedén

Head of Support

Support team is very helpful and responsive. Really enjoy how lightweight this is within Zendesk itself vs other more intrusive tools.

Cathleen Wright

Cathleen Wright

Zendesk Admin, Cortex IO

So far it's pretty good! Our queries are a little nuanced, so we can't always use it, but it's got enough utility for us. It can even incorporate our bilingual country with greetings in a second language.

Jae Oliver

Jae Oliver

Head of Support, Wise

Really enjoying using Macha, it has made a noticeable difference to our support team in a short amount of time. I really like the ticket summary feature, saves us a lot of time.

Harry Jackson

Harry Jackson

Head of Support, Crumb

Macha AI is a great addition to my workspace! It's powerful, convenient, and it really makes productivity so much easier for our agents!

Dave G

Dave G

Head of Support, Cyber Power Systems

Very impressed! AI integration for Zendesk has certainly come a long way and Macha seems to set the standard for now. This will for sure save lot of time in our support team.

Pauli Juel

Pauli Juel

Head of CS, Dokument24

Macha has been working great for us so far! The auto-responses are accurate and our resolution time has dropped significantly.

Lana T

Lana T

Zendesk Admin, Swotzy

Macha AI is a great addition. The knowledge base feature means our agents always have the right answers at their fingertips.

Mischa Wolf

Mischa Wolf

Head of Support, Topi

We're enjoying this integration so far. It's made our support team more efficient and our customers get faster responses.

Paula G

Paula G

Head of Customer Support, Xly Studio

The team enjoys using it. It saves considerable time on common questions and the integration options are excellent.

Kilian Leister

Kilian Leister

Support Head, Didriksons

Get your AI agents set up for you.

Book a 20-minute call with our team. We'll show you where we would start on your Intercom and how the setup works. Setup and a dedicated success manager come with the trial and every plan.

Live in under a week
Safe mode until you approve
About $0.40 a ticket