VorinChat Developer Docs

Connect VorinChat to Other Tools

This page is for whoever handles your technical setup -- feel free to forward it to your developer. It covers connecting VorinChat to a CRM, automation tool, or any other system you use, so conversations and contacts can flow in both directions automatically.

Sign in for workspace setup Install docs

Sending data in

Where to send updates from your other systems

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

Inbound events

What you can send us

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 workspace integrations page.

Sending data out

What VorinChat can notify your other systems about

* 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

Works today, dedicated app coming later

Add the install script inside a Custom Liquid block or your theme's footer -- a full Shopify app is planned for later.

Automation tools

Works with Zapier, Make, and similar tools

These events can trigger automations in tools like Zapier or Make, or in your own backend -- no direct access to our database needed.