Integration guide for adding an AI chatbot to municipalities using Tyler Technologies products, including website CMS integration and connecting to EnerGov, Munis, and Citizen Self-Service portals.

Adding an AI Chatbot to Tyler Technologies Municipal Websites

Tyler Technologies is the largest software company focused exclusively on the public sector, serving over 40,000 government offices. If your municipality uses Tyler products—whether for your website, financial management (Munis), permitting (EnerGov), or citizen services—you're part of an ecosystem that can benefit significantly from AI chatbot integration.

This guide covers how to add CityDesk.AI to Tyler-powered websites and how to leverage Tyler's broader product suite to create a more capable citizen service chatbot.

Understanding Tyler's Municipal Technology Stack

Tyler offers multiple products that municipalities often use together:

Product	Function	Chatbot Relevance
Tyler CMS / Civic	Website content management	Primary integration point
EnerGov	Permitting, licensing, code enforcement	Permit status lookups
Munis	Financial management, utility billing	Payment and account info
Citizen Self-Service	Online portals for residents	Complement or integrate
Socrata	Open data platform	Data-driven answers
iasWorld	Property assessment	Property value questions

A chatbot integrated with your Tyler website becomes more powerful when it can also tap into these backend systems. We'll cover basic website integration first, then discuss deeper integrations.

Part 1: Website Integration

Identifying Your Tyler CMS Version

Tyler has acquired several website platforms over the years. Your site might run on:

Tyler Civic (newer cloud-based platform)
Tyler CMS (legacy on-premise system)
A non-Tyler CMS with Tyler backend systems (common setup)

The integration approach varies slightly by platform. If you're unsure which you have, check with your Tyler account representative or look at the admin URL structure.

Tyler Civic (Cloud) Integration

Tyler Civic is Tyler's modern, cloud-hosted website platform.

Step 1: Access Design Settings

Log in to your Tyler Civic admin dashboard
Navigate to Design > Site Settings or Theme Settings
Look for Custom Code or Script Injection options

Step 2: Add the Chatbot Script

In the footer scripts section, add:

<!-- CityDesk.AI Chatbot -->
<script
  src="https://cdn.citydesk.ai/widget/v2/chatbot.min.js"
  data-site-id="your-municipality-id"
  data-position="bottom-right"
  async>
</script>

Step 3: Save and Test

Save your changes
Open your public website in an incognito browser window
Verify the chatbot appears and responds correctly

Tyler CMS (Legacy) Integration

For older Tyler CMS installations:

Step 1: Access Template Management

Log in to your Tyler CMS admin panel
Navigate to Administration > Templates or Site Management > Master Pages
Select your active template for editing

Step 2: Locate the Footer Section

Find the closing </body> tag in your template. Insert the chatbot script immediately before it:

    <!-- Footer content above -->

    <!-- CityDesk.AI Chatbot -->
    <script
      src="https://cdn.citydesk.ai/widget/v2/chatbot.min.js"
      data-site-id="your-municipality-id"
      data-position="bottom-right"
      async>
    </script>
  </body>
</html>

Step 3: Publish and Clear Cache

Publish the template changes
Clear any server-side cache
Test in a new browser session

Non-Tyler CMS with Tyler Backend

Many municipalities use Tyler for ERP and permitting but host their website on a different platform (WordPress, CivicPlus, Granicus, etc.). In this case:

Follow the integration guide for your specific CMS platform
Continue reading Part 2 below for connecting Tyler backend data

Part 2: Connecting Tyler Backend Systems

The real power of a chatbot in a Tyler environment comes from connecting it to Tyler's operational systems. Citizens don't just want website information—they want to know their permit status, utility balance, or property assessment.

EnerGov Integration: Permit and License Status

If your municipality uses EnerGov for permitting, you can enable the chatbot to answer questions like:

"What's the status of my building permit?"
"Has my business license been approved?"
"What inspections are scheduled for my property?"

How It Works

CityDesk.AI can connect to EnerGov's Citizen Self-Service portal or API to retrieve permit information. When a citizen asks about their permit:

Chatbot asks for permit number or address
Chatbot queries EnerGov data
Chatbot returns current status, next steps, and any required actions

Setup Requirements

EnerGov Citizen Self-Service must be enabled
API access or screen integration configured
Contact CityDesk.AI support for EnerGov connector setup

Example Conversation

Citizen: What's the status of my permit?

Chatbot: I can look that up for you. What's your permit number or the property address?

Citizen: 123 Main Street

Chatbot: I found permit #BLD-2024-0892 for 123 Main Street. Current status: Under Review. It was submitted on January 3rd and is assigned to Plan Review. Estimated review completion is January 20th. Would you like information about what happens after the review?

Munis Integration: Utility Billing and Payments

For municipalities using Munis for utility billing:

"What's my water bill balance?"
"When is my payment due?"
"How do I set up autopay?"

Setup Requirements

Munis Citizen Self-Service or Tyler Payments integration
Account lookup capability (typically by address or account number)
Contact CityDesk.AI for Munis connector configuration

Citizen Self-Service Portal Coordination

Tyler's Citizen Self-Service (CSS) portals let residents handle transactions online. The chatbot complements CSS by:

Guiding citizens to the right portal: "To pay your utility bill online, go to [CSS link]. Would you like help with the payment process?"
Answering questions about the portal: "Yes, you can view your permit history in the Citizen Self-Service portal. You'll need to create an account first."
Handling queries that CSS can't: CSS is transactional; the chatbot handles informational questions that don't require login.

Socrata Open Data Integration

If you publish open data through Tyler's Socrata platform, the chatbot can answer data-driven questions:

"How many building permits were issued last year?"
"What's the average property value in my neighborhood?"
"Show me the city budget breakdown"

This requires connecting the chatbot to your Socrata datasets, enabling it to query and summarize public data.

Part 3: Configuration for Tyler Environments

Styling to Match Tyler Civic Themes

Tyler Civic sites have consistent design patterns. Match your chatbot:

<script
  src="https://cdn.citydesk.ai/widget/v2/chatbot.min.js"
  data-site-id="your-municipality-id"
  data-primary-color="#1a5276"
  data-font-family="Open Sans, sans-serif"
  data-header-text="City Services Assistant"
  async>
</script>

Handling Tyler's Session Management

Tyler products use session-based authentication. If your chatbot needs to reference authenticated data:

Don't pass session tokens to the chatbot - this creates security risks
Use separate API authentication for backend queries
Keep chatbot answers general when specific account data isn't available

For account-specific queries, the chatbot should:

Ask for a lookup identifier (permit number, address, account number)
Query the appropriate Tyler system
Return only the information the citizen requested

Accessibility Compliance

Tyler emphasizes WCAG compliance in their products. CityDesk.AI's chatbot includes:

Full keyboard navigation
Screen reader support with ARIA labels
Sufficient color contrast (configurable)
Resizable text
Focus management for modal interactions

No additional configuration is required for basic accessibility.

Part 4: Common Questions in Tyler Municipalities

Based on Tyler installations, these questions appear most frequently:

Permitting (EnerGov Users)

"How do I apply for a building permit?"
"What's required for a fence permit?"
"How long does permit review take?"
"When is my inspection scheduled?"
"Why was my permit denied?"

Utility Billing (Munis Users)

"How do I pay my water bill?"
"Why is my bill higher than usual?"
"How do I start/stop service?"
"What are the current utility rates?"
"How do I report a water leak?"

Property & Taxes (iasWorld Users)

"How is my property value determined?"
"When are property taxes due?"
"How do I appeal my assessment?"
"Where do I find my parcel number?"

General Municipal Services

"What are city hall hours?"
"How do I get a business license?"
"When is trash pickup?"
"How do I register for recreation programs?"

Part 5: Troubleshooting Tyler Integrations

Chatbot Not Appearing

Check: Script placement in template

Must be before </body>, not in <head>
Tyler Civic: verify custom scripts are enabled for your site

Check: Content Security Policy

Tyler sites may have CSP headers blocking external scripts
Work with your Tyler administrator to whitelist cdn.citydesk.ai

EnerGov/Munis Data Not Returning

Check: API connectivity

Verify the Tyler system APIs are accessible from the chatbot
Check that authentication credentials are current
Review API rate limits

Check: Data mapping

Permit numbers and account formats vary by Tyler configuration
Ensure the chatbot is parsing identifiers correctly

Slow Response Times

Cause: Backend system latency

Tyler systems, especially on-premise installations, may have slower response times than cloud services. Consider:

Setting appropriate timeout thresholds
Showing "looking that up for you..." messages during queries
Caching frequently-requested static data

Chatbot Conflicts with Tyler Elements

Symptom: Chatbot overlaps with Tyler CSS portal widget or other UI elements

Solution: Adjust chatbot position

data-position="bottom-left"
data-offset-bottom="100"

Or use delayed loading:

<script>
  window.addEventListener('load', function() {
    setTimeout(function() {
      var s = document.createElement('script');
      s.src = 'https://cdn.citydesk.ai/widget/v2/chatbot.min.js';
      s.dataset.siteId = 'your-municipality-id';
      document.body.appendChild(s);
    }, 1500);
  });
</script>

Part 6: Measuring Success

Key Metrics for Tyler Environments

Website Integration

Chatbot conversations per week
Most common questions asked
Questions requiring human escalation

EnerGov Integration

Permit status lookups via chatbot
Reduction in "what's my permit status" phone calls
Time saved per permit inquiry

Munis Integration

Utility account lookups via chatbot
Payment-related questions answered
Reduction in billing inquiry calls

ROI Calculation

For a typical Tyler municipality:

Metric	Before Chatbot	After Chatbot
Permit status calls/month	200	80
Avg. call duration	4 minutes	4 minutes
Staff time on status calls	13 hours/month	5 hours/month
Time saved	-	8 hours/month

When extended to utility billing, general inquiries, and other departments, the savings compound.

Next Steps

Basic Integration (Week 1)

Add chatbot to your Tyler website
Verify it learns from your existing content
Monitor initial questions to identify gaps

Content Optimization (Weeks 2-4)

Review unanswered questions in the dashboard
Add or improve website content for common topics
Create FAQ pages for frequent questions

Backend Integration (Month 2+)

Evaluate which Tyler systems would benefit most from chatbot integration
Start with EnerGov permit status (high volume, high citizen value)
Add Munis utility lookups if applicable
Consider Socrata data integration for open data queries

Ongoing Optimization

Weekly review of chatbot analytics
Monthly assessment of call/email volume changes
Quarterly ROI calculation

Ready to integrate CityDesk.AI with your Tyler Technologies environment? Contact our team for a consultation on your specific Tyler product configuration.

Adding an AI Agent and Chatbot to Tyler Technologies Municipal Websites