VorinChat Developer Docs

API Keys, Signed Webhooks, and Sync Jobs

Connect VorinChat to CRMs, automation flows, and custom business systems with a workspace-scoped authentication and delivery layer.

Sign in for workspace setup Install docs

Inbound endpoint

Workspace-scoped sync API

POST endpoint https://chat.vorinvista.com/chat/integrations/events/
Authorization
Authorization: Bearer your_workspace_api_key
Content type
Content-Type: application/json

Inbound events

Supported sync payloads

contact.upsert conversation.note
{
  "event": "contact.upsert",
  "source": "hubspot",
  "external_id": "crm-contact-42",
  "payload": {
    "email": "[email protected]",
    "full_name": "Buyer Example",
    "custom_fields": {
      "plan": "Pro",
      "lifecycle_stage": "lead"
    }
  }
}
{
  "event": "conversation.note",
  "source": "salesforce",
  "payload": {
    "session_key": "abc123session",
    "note": "Customer already has an open renewal opportunity."
  }
}

Webhook signatures

Verify outbound deliveries

Event name header
X-VorinChat-Event: message.created
Delivery ID header
X-VorinChat-Delivery: uuid
Timestamp header
X-VorinChat-Timestamp: unix_seconds
Signature header
X-VorinChat-Signature: sha256=...

The signature is computed over `timestamp + "." + raw_body` using the webhook secret shown inside the staff integrations hub.

Outbound event catalog

What external systems can react to

* contact.created contact.updated conversation.started conversation.updated conversation.resolved message.created csat.submitted

WordPress

Ready now

Each website chat can export a ready WordPress plugin zip with the exact loader URL and widget key provisioned.

Shopify

Theme-layer path today

Use the generic loader inside a Custom Liquid block or the theme footer while the deeper app layer is still evolving.

Automation bridges

Webhook-first path

Make, Zapier-style relays, and custom middleware can consume signed events without needing direct database access.