Skip to main content

30 docs tagged with "chatbot"

View all tags

Add Chatbot for a New Church

Provision the chatbot for a church after purchase — create the organization_settings row with correct schema, configure the widget, and provide embed code to the church admin

AI Front Desk — Voice + Chatbot Expected Output Acceptance Spec

APPROVED — Stage 1 agent research, pre-populated from the AI Front Desk Provisioning handoff (2026-05-21), the eight locked Phase-0 founder decisions, the AI Front Desk and Local Authority offer pages, the voice-agent code (resolve_route, the funeral/vet vertical pattern, moderation.py), the chatbot stream route, and the confirmed `local_business_*` production schema, then resolved in the founder Stage-2 interview (2026-05-21). Defines the EXPECTED OUTPUT — what a caller, a website visitor, and the business owner experience — for the per-business AI voice agent and website chatbot that the AI Front Desk + Local Authority packages promise. The voice agent is the church-built, multi-tenant, LIFE-SAFETY-tier LiveKit agent (one deployed agent serves church / funeral / vet / local-business). All 16 decisions (8 Phase-0 architecture/scope + 8 Stage-2 resolutions) are folded in; CLAUDE.md Rule #17 is satisfied — the customer-facing build is cleared.

Anthropic Integration

How Claude models (Haiku 4.5 primary, claude-sonnet fallback) are used across the chatbot, voice agent Care Agent, content generation scripts, and the Claude CLI for batch tasks

Cal.com Integration

Cal.com scheduling integration used by the chatbot and voice agent to book pastoral appointments — per-church booking link configuration and how the booking tool is triggered

Chat Message Flow

End-to-end flow for a single chatbot message — moderation, agent selection, RAG retrieval, tool execution, and streaming response from /api/chatbot/stream

Chatbot Agent Routing

How the chatbot routes each incoming message to the correct specialist agent (Coordinator, Care, Stewardship, Discipleship) — intent detection, persona loading, and agent handoff logic

Chatbot Agents

The 4 chatbot agent types (Coordinator, Care, Stewardship, Discipleship) — their personas, domain expertise, allowed tool sets, and how the routing system selects the correct agent

Chatbot Architecture

Technical architecture of the chatbot request pipeline — moderation, RAG retrieval, agent routing, tool calling, streaming response, and the LLM provider strategy (Claude primary / GPT-4o-mini fallback)

Chatbot Conversation Pipeline — Complete Code Trace

Definitive source of truth for the entire chatbot request lifecycle, from HTTP request arrival to response return. Every code path, every tool, every third-party call, every expected result. Generated 2026-04-02 from a full read of every file in the pipeline.

Chatbot Moderation System

Multi-layer content moderation for the chatbot — blocklist patterns, LLM-based abuse detection, user restriction tracking, and crisis escalation to 988 / church staff

Chatbot Operations Runbooks

Index of chatbot ops runbooks — provision new churches, debug responses, manage knowledge base content, handle care escalations, and disable/suspend chatbots

Chatbot Overview

Product overview of the ChurchWiseAI Chatbot — ministry-focused AI assistant for churches that handles visitor care, prayer requests, pastoral appointments, and church-specific Q&A

Chatbot Tier Restrictions

How chatbot capabilities are gated by plan tier (Starter/Pro/Suite) and context (PewSearch demo, Pro Website, standalone) — tool availability, agent access, and anti-cannibalization rules

Chatbot Tools

All 39 chatbot tools organized by category and plan tier — prayer request capture, pastoral appointments, event registration, giving info, visitor contact, and church-specific lookups

Chatbot UX Model

Three chatbot UX surfaces — hosted Care Hub (/care/[slug]), embedded chat widget (/chat/[slug]), and agent-specific pages — plus the HEAR pastoral conversation protocol

Chatbot Widget Configuration

JavaScript embed widget configuration — script tag installation, positioning options, color theming, CORS requirements, and the "Powered by ChurchWiseAI" branding rules by tier

Debug Chatbot Issues

Diagnose chatbot problems — wrong responses, tools not saving, widget not loading, LLM errors — using Vercel logs, Supabase queries, and the RAG debug flow

Disable or Suspend a Church's Chatbot

Temporarily disable or fully suspend a church's chatbot via organization_settings — for non-payment, debugging, church request, or policy violation

Handle a Chatbot Care Agent Escalation

Respond to a Care Agent escalation notification — review the conversation, contact the church admin, follow up with the person in need, and log the outcome

Prayer Request Follow-Up

Review and action prayer requests from voice_prayer_requests (shared by voice + chatbot) — triage by urgency, notify church pastoral staff, and log follow-up completion

Pre-Conversation Journey — Complete Map

Everything that happens from "pastor hears about ChurchWiseAI" through "visitor sends first message or call is answered." Covers the church admin setup journey (Track A) and the visitor discovery journey (Track B), and traces how admin-entered config flows into every AI response.

Pro Website Chatbot Integration

How the ChurchWiseAI chatbot widget is embedded in Pro Website pages — tier-based feature restrictions, the anti-cannibalization rules, and the upgrade prompt for Pro Website-only churches

Query Product Analytics for Reporting

Supabase SQL queries for product metrics — chatbot conversation counts, voice call volume, ITW page views, premium church counts, and cross-property revenue summary

Update Knowledge Base Content for a Church

Add or update FAQ and knowledge base entries in unified_rag_content for a specific church — SQL inserts, embedding generation, and verifying the chatbot answers correctly