Overview

Calldacity provides AI-powered features that integrate seamlessly with your NetSapiens portal. This guide walks you through the setup process for enabling:

• AI Agent – Intelligent voice receptionist
• AI Chatbot – UCaaS management assistant
• AI Integrations – Third-party platform connections
• Connect – Chrome extension for click-to-call and notifications

The integration works by injecting JavaScript into your NetSapiens portal, which loads the Calldacity AI components for authenticated users.

Prerequisites

Before beginning the integration, ensure you have:

• NetSapiens SNAPsolution v44.4+
• Administrator access to your NetSapiens portal
• Your Calldacity Tenant ID (provided in your welcome email)
• CSP configurations properly set (see CSP Configuration section)

Important: Test all configurations in a sandbox environment before deploying to production.

Integration Methods

Option 1: Hosted Script (Recommended)

The simplest method is to use our hosted script URL with your tenant-specific parameters.

1. Log into your NetSapiens portal as an administrator
2. Navigate to: Platform Configs → Configs Library
3. Add or modify the UI Config: PORTAL_EXTRA_JS
4. Set the value to your personalized URL received in your sign up email. Example:

   https://int-sb.calldacity.com/ucaas-overrides/prod/jsoverride.js?data-tenant-id=YOUR_TENANT_ID&data-tenant-url=https%3A%2F%2Fapi-oms.calldacit.com&data-api-url=https%3A%2F%2Fapi-oms.calldacity.com&data-chatbot-id=1&data-agent-name=Your+Company+Assistant&data-agent-intro=Hello+%7BdisplayName%7D%21+I%27m+your+Assistant.+How+can+I+help+you+today%3F

5. Save the configuration
6. Refresh your portal to verify the integration

Note: Replace YOUR_TENANT_ID with the Tenant ID provided in your welcome email. To adjust the url parameters for your branding see URL Parameters Reference. 

Option 2: Custom JavaScript File

If you already have a custom JavaScript file configured via PORTAL_EXTRA_JS, append the following code blocks to your existing file replacing with the values received in your sign up email. 

AI Receptionist (Voice Agent)

//==============================AI Receptionist Integration============================//
var aiScript = document.createElement('script');
aiScript.src = 'https://int-sb.calldacity.com/ucaas-overrides/prod/OC_AIAgent.js';
aiScript.setAttribute('data-tenant-id', 'YOUR_TENANT_ID');
aiScript.setAttribute('data-tenant-url', 'https://api-oms.calldacity.com');
document.head.appendChild(aiScript);
//==============================AI Receptionist Integration============================//

AI Chatbot (UCaaS Management Assistant)

//=================Admin Chatbot widget - UCaaS Management Assistant===================//
var adminChatbot = document.createElement('script');
adminChatbot.src = 'https://int-sb.calldacity.com/ucaas-overrides/prod/chatbot-widget.js';
adminChatbot.setAttribute('data-tenant-id', 'YOUR_TENANT_ID');
adminChatbot.setAttribute('data-api-url', 'https://api-oms.calldacity.com');
adminChatbot.setAttribute('data-chatbot-id', '1');
adminChatbot.setAttribute('data-agent-name', 'Your Company Assistant');
adminChatbot.setAttribute('data-agent-intro', 'Hello {displayName}! I\'m your Assistant. How can I help you today?');
document.head.appendChild(adminChatbot);
//=================Admin Chatbot widget - UCaaS Management Assistant===================//

AI Integrations Platform

//=================Integrator===================//
var integrator = document.createElement('script');
integrator.src = 'https://int-sb.calldacity.com/ucaas-overrides/prod/OC_Integration.js';
integrator.setAttribute('data-tenant-id', 'YOUR_TENANT_ID');
integrator.setAttribute('data-tenant-url', 'https://api-oms.calldacity.com');
document.head.appendChild(integrator);
//=================Integrator===================//

Important: Replace with the information received in your sign up email

URL Parameters Reference

When using the hosted script URL, the following parameters configure your integration:

Dynamic Placeholders

The data-agent-intro parameter supports dynamic placeholders:

• {displayName} – Replaced with the logged-in user's display name
• {domain} – Replaced with the user's domain

Example decoded intro message:

Hello {displayName}! I'm your Calldacity Assistant. I'm here to help you manage your {domain} domain and UCaaS operations. What can I assist you with today?

Note: URL parameters must be URL-encoded. Spaces become + or %20, and special characters like { become %7B.

Content Security Policy (CSP) Configuration

NetSapiens portals running SNAPsolution v44.4+ have Content Security Policy enabled by default. You must add the Calldacity domains to allow the integration scripts to load properly.

Required CSP Configurations

Add the following UI Configs at the appropriate scope level (System, Reseller, or Domain):

How to Add CSP Configurations

1. Log into your NetSapiens portal as an administrator
2. Navigate to: Reseller → Configs (or System level for global settings)
3. Click Add Config for each required configuration
4. Enter the Parameter name and Value as shown above
5. Save each configuration
6. Refresh your portal and test the integration

Important: When configuring multiple sources, use space-separated values (not comma-separated).

CSP Configuration Reference

For more information on CSP configuration, see the NetSapiens CSP Documentation.

Feature-Specific Scripts

Script URLs by Feature

Troubleshooting

Common Issues

Scripts Not Loading

Symptoms: AI features don't appear after configuration

Solutions:

• Verify CSP configurations are set correctly
• Check browser console for CSP violation messages (F12 → Console)
• Ensure the PORTAL_EXTRA_JS value is correctly formatted
• Clear browser cache and refresh

CSP Violation Errors

Symptoms: Console shows "Refused to load script..." or "Refused to connect..."

Solutions:

• Add missing domains to appropriate PORTAL_CSP_*_ADDITIONS configs
• Verify domains include https:// prefix
• Check for typos in domain names
• Ensure multiple domains are space-separated

Chatbot Not Displaying User Name

Symptoms: {displayName} appears literally instead of the user's name

Solutions:

• Verify the user is logged into the portal
• Check that the data-agent-intro parameter is properly URL-encoded
• Ensure curly braces are encoded as %7B and %7D

Viewing CSP Errors

1. Open Developer Tools (F12 or right-click → Inspect)
2. Go to the Console tab
3. Look for messages starting with "Refused to..."
4. Note which directive caused the block (script-src, connect-src, etc.)
5. Add the blocked domain to the corresponding PORTAL_CSP_*_ADDITIONS config

Testing Your Configuration

After setup, verify the integration by:

1. Logging into your portal as a regular user
2. Looking for the AI chatbot widget (typically bottom-right corner)
3. Checking the browser console for any errors
4. Testing chatbot responses with a simple query

Support

If you encounter issues not covered in this guide:

• Email: support@calldacity.com
• Documentation: https://support.calldacity.com 

Related Documentation

• NetSapiens CSP Configuration
• Injecting Custom CSS and JS in NetSapiens Portal