Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mycelium-ai.co/llms.txt

Use this file to discover all available pages before exploring further.

Salesforce uses a webhook receiver (paid runtime). No open-source ingest skill ships in the current substrate.

​
Webhook receiver (paid runtime)

Real-time push via Salesforce Platform Events or Outbound Messages. 
POST /webhooks/salesforce/{tenant_id}
Signature: Platform Events arrive via the Streaming API (CometD long-poll or SSE). The runtime uses a connected app with OAuth 2.0 JWT Bearer flow to maintain a subscription. Outbound Messages sign via SOAP X-SFDC-Signature.

​
Setup

  1. In Salesforce, create a Connected App with OAuth scopes: api, refresh_token.
  2. Generate a certificate for the JWT Bearer flow and upload to the Connected App.
  3. Configure Platform Events: define which standard or custom events to subscribe to.
  4. Add to the runtime env:
    • SALESFORCE_CLIENT_ID_{TENANT_ID}
    • SALESFORCE_PRIVATE_KEY_{TENANT_ID} (PEM, base64-encoded)
    • SALESFORCE_USERNAME_{TENANT_ID}
    • SALESFORCE_INSTANCE_URL_{TENANT_ID} (e.g., https://myorg.my.salesforce.com)

​
Events ingested

Salesforce objectMemory categoryNotes
OpportunitydecisionStage changes, closed-won/lost
CaseexceptionCase opened = exception; closed = resolved
Contact / AccountrelationshipCRM entity created or updated
TaskfactActivity log entries
Custom eventsconfigurableDefine mapping in connectors/salesforce.yaml

​
Retry behavior

Failed deliveries land in the per-tenant dead-letter folder. Replay via: 
POST /admin/webhooks/replay/{tenant_id}/{event_id}