%% API-led integration reference architecture
%% Reference architecture: a reusable pattern, not a live client integration
flowchart TB
  subgraph z0["Integration platform (MuleSoft or other)"]
    gwy["API gateway and policies<br/>auth, rate limits"]
    xweb["Web and mobile API<br/>experience"]
    xpartner["Partner API<br/>experience"]
    xmcp["MCP server<br/>experience for AI"]
    papi["Process APIs<br/>orchestration and rules"]
    broker["Event broker or queue<br/>asynchronous"]
    errq["Error queue and replay<br/>dead-letter"]
    mon["Monitoring and tracing<br/>correlation IDs"]
    ssf["Salesforce system API<br/>REST, Bulk, Pub/Sub"]
    serp["ERP system API<br/>orders and invoices"]
    smkt["Marketing system API<br/>Marketing Cloud or Braze"]
  end
  subgraph z1["Systems of record"]
    sf["Salesforce<br/>CRM and service"]
    erp["ERP and finance<br/>orders, invoices"]
    mkt["Marketing platform<br/>messaging and journeys"]
  end
  web["Web and mobile apps<br/>customer channels"]
  portal["Partner portals<br/>external users"]
  agents["AI agents and MCP clients<br/>tool consumers"]
  web -->|"app requests"| gwy
  portal -->|"portal requests"| gwy
  agents -->|"tool calls"| gwy
  gwy -->|"routed calls"| xweb
  gwy -->|"routed calls"| xpartner
  gwy -->|"MCP requests"| xmcp
  xweb -->|"business requests"| papi
  xpartner -->|"business requests"| papi
  xmcp -->|"tool execution"| papi
  papi -->|"publish events"| broker
  broker -->|"failed messages"| errq
  errq -->|"alerts"| mon
  papi -->|"CRM calls"| ssf
  papi -->|"ERP calls"| serp
  broker -->|"marketing updates"| smkt
  ssf -->|"Salesforce APIs"| sf
  serp -->|"ERP interfaces"| erp
  smkt -->|"platform APIs"| mkt
  ssf -.->|"change events"| broker
  classDef salesforce stroke:#125BD8,fill:#e8f0fd
  class sf salesforce
  classDef engagement stroke:#5747AF,fill:#efedfa
  class mkt engagement
  classDef ai stroke:#5747AF,fill:#f6f4fd
  class agents,xmcp ai
  classDef integration stroke:#334155,fill:#eef2f6
  class xweb,xpartner,papi,broker,errq,ssf,serp,smkt integration
  classDef security stroke:#1f2937,fill:#f3f4f6
  class gwy,mon security
  classDef channel stroke:#2f8a3a,fill:#ffffff
  class web,portal channel
  classDef external stroke:#64748b,fill:#ffffff
  class erp external