Skip to main content

Integrations

Connect Deway with your analytics and notification tools to track events and stay informed.

Available Integrations​

Deway supports the following integrations:

IntegrationTypeDescription
MixpanelAnalyticsTrack chat and walkthrough events
AmplitudeAnalyticsProduct analytics with US/EU data residency
SegmentCDPSend events to your data warehouse
Google AnalyticsAnalyticsTrack conversations in GA
HubSpotCRMSync conversation data to CRM
SlackNotificationsGet notified about conversations
WebhooksCustomSend events to custom endpoints
WoopraAnalyticsCustomer journey analytics

Setting Up Integrations​

Step 1: Navigate to Integrations​

Go to Settings > Integrations in the admin dashboard.

Step 2: Select an Integration​

Click on the integration you want to configure.

Step 3: Enter Credentials​

Each integration requires specific credentials:

IntegrationRequired Credentials
MixpanelToken, Region (US/EU)
AmplitudeAPI Key, Data Location (US/EU)
SegmentWrite Key, Region (US/EU)
Google AnalyticsTracking ID
HubSpotAPI Key
SlackWebhook URL
WebhooksEndpoint URL
WoopraDomain

Step 4: Enable​

Toggle the integration to Enabled and save.

Events Sent​

Deway sends the following events to your integrations:

Chat Events​

Triggered when users interact with the chat widget.

EventDescription
chatsChat session created or updated

Properties:

  • chat_id - Unique chat identifier
  • actor - user or assistant
  • chat_type - Type of chat interaction
  • tenant_id - Your tenant identifier
  • timestamp - Event timestamp

Walkthrough Progress Events​

Triggered when users progress through AI-guided walkthroughs.

EventDescription
walkthrough-progressUser completed a walkthrough step

Properties:

  • walkthrough_job_to_be_done - The Job the user is working toward
  • step_index - Current step number
  • step_title - Step description
  • tenant_id - Your tenant identifier
  • timestamp - Event timestamp

Data Residency​

For analytics integrations, you can choose data residency:

RegionDescription
USData stored in United States
EUData stored in European Union

Select the region that matches your compliance requirements.

Use Cases​

Track Conversation Metrics​

Send chat events to your analytics platform to:

  • Measure AI assistant usage
  • Track conversation volume over time
  • Segment users by chat engagement

Measure Job Completion​

Use walkthrough-progress events to:

  • Track completion rates for Jobs
  • Identify drop-off points
  • Measure time-to-completion

Alert on Important Events​

Use Slack or webhooks to:

  • Get notified when users need support
  • Alert on high-volume chat periods
  • Monitor for specific user behaviors

Sync with CRM​

Use HubSpot integration to:

  • Add conversation history to contact records
  • Track customer engagement scores
  • Trigger workflows based on chat activity

Testing Integrations​

After enabling an integration:

  1. Open your application with the Deway SDK installed
  2. Start a conversation with the AI assistant
  3. Check your integration platform for incoming events
  4. Verify event properties match expected values

Troubleshooting​

Events Not Appearing​

  1. Verify credentials are correct
  2. Check the integration is enabled
  3. Ensure users are identified (Deway.identify())
  4. Wait a few minutes (some platforms have delays)

Wrong Data Location​

  1. Check the region setting matches your platform configuration
  2. Some platforms require data residency to be set at project creation
  3. Contact the platform support if events go to wrong region

Missing Properties​

  1. Ensure the SDK is properly initialized
  2. Verify users are identified before starting conversations
  3. Check for JavaScript errors in browser console

Next Steps​