Integrations & Webhooks#

Novaza Desk exposes conversation and contact events to external systems via webhooks and a dedicated integration hub. This lets you synchronize Desk data with CRMs, analytics pipelines, notification tools, and custom backends without polling the API.

Webhooks#

Webhooks deliver JSON payloads to a URL you control whenever a subscribed event fires.

Configure at Desk → Settings → Integrations → Webhooks → Add Webhook:

Webhook URL — your HTTPS endpoint
Subscribed events — one or more of:
- conversation_created
- conversation_updated
- conversation_status_changed
- message_created
- message_updated
- contact_created
- contact_updated

Each delivery includes the full event payload and a signed header so your endpoint can verify authenticity. Failed deliveries are retried with exponential backoff.

Integration Hub#

The Integration Hub (Desk → Settings → Integrations) provides pre-built connectors to external systems. Each integration is configured with OAuth or an API token and then operates in the background.

Connector categories available:

Team messaging — route new-conversation notifications into a chat channel
Dialogflow-style NLP — forward visitor messages to a conversational AI service for intent classification and suggested replies
CRM sync — push contacts and conversation summaries to an external customer database
Calendar / scheduling — detect meeting-request intents and surface available slots

Public API#

For bespoke needs, the public Desk API exposes full CRUD over contacts, conversations, messages, inboxes, labels, teams, and custom attributes. API tokens are generated per agent under Profile → Access Token. All endpoints use REST conventions, JSON bodies, and Bearer-token authentication over HTTPS.