Skip to content
Sam Docs

Integrations

The Integrations page lets you push Sam events into your own tools. Integrations are a Pro plan feature. Starter and Growth plans don’t see this section in the sidebar. Trial users get full access during their 7-day evaluation.

Slack notifications

Get notified in Slack when Sam captures a lead, opens a callback request, or hands off to a human.

Setup:

  1. In Slack, create an Incoming Webhook for the channel you want notifications in.
  2. Copy the webhook URL.
  3. In Sam → Integrations → Slack, paste the URL and choose which events trigger a notification:
    • New lead captured
    • Callback request submitted
    • Conversation escalated to human
  4. Save.

A test message will be sent to confirm the webhook works.

Custom webhooks

For deeper integrations (CRM, helpdesk, custom apps), use custom webhooks. Sam will POST a JSON payload to your endpoint when an event fires.

Events you can subscribe to:

  • conversation.started
  • conversation.closed
  • lead.captured
  • callback.requested
  • handover.requested

Payload format — every webhook includes:

  • event — the event slug
  • tenant_id — your account ID
  • widget_id — which widget triggered it
  • data — the event payload (conversation, lead, or message data)
  • timestamp — ISO 8601

Setup:

  1. Integrations → Webhooks → Add webhook.
  2. Enter your endpoint URL (must be https://).
  3. Select events.
  4. (Recommended) Set a signing secret — Sam will sign each payload with HMAC SHA-256 in the X-Sam-Signature header so you can verify the request.
  5. Save.

Failed deliveries are retried with backoff for up to 24 hours.

API access

Pro accounts also get an API key for programmatic access to conversations, leads, and widget config. Generate keys in Settings → API.

API documentation lives at api.viasam.app/docs (coming soon — for now, contact support@viasam.app for early access).

Don’t see Integrations in your sidebar?

Integrations are gated to Pro. If you’re on Starter or Growth, upgrade in Billing to enable them. Trial users see Integrations during their 7-day evaluation.