Skip to main content

Company Configuration

Audience: Engineering · QA · Support · Management · Where in app: Internal (surfaced across Settings screens) · Plan availability: All plans (individual features gated)

Most tenant behavior is controlled by fields on the companies collection (CompanyModel, backend MongoDB). This is the canonical list of those fields, grouped by area. Use it to answer "is X enabled for this tenant / where do I configure Y?" and to map a Settings screen back to the field it writes.

Field names below are the stored config keys. Many map to a Settings UI screen but some are super-admin-only gates (often suffixed _allowed). When a value is plan- or agency-gated, verify against the live entitlement matrix.

Identity & branding​

  • company_name, website_url, industry, agent_type
  • timezone, timezone_offset
  • logo (FileModel ref)
  • affiliate_link, affiliate_link_enabled

Visibility / installation​

  • visibility — widget on/off
  • mobile_disable — hide on mobile
  • widget_installed, widget_installed_at

Widget design​

  • widget_design.* — message/button/header/footer/call-background colors, chatbot auto-trigger colors
  • primary_color, secondary_color, position (right/left)
  • launcher_style (bubble / middle / expended / bar / welcome / chat-pill / icon)
  • mobile_launcher_style
  • chat_window_type (extend/small), chat_window_color

Channels​

  • communication_options.allow_chat / allow_video_call / allow_audio_call
  • communication_options.chat_label / video_call_label / audio_call_label
  • communication_options.take_phone_number_before_call
  • communication_options.visitor_video_permissions
  • communication_options.take_over_permissions

Working hours​

  • working_hours[] — day, start_time (HH:MM), end_time (HH:MM)
  • Per-user override on users.working_hours

Online / offline copy​

  • online_title_text, online_title_text_sub_heading
  • offline_title_text, offline_title_text_sub_heading
  • chatbot_online_message, chatbot_online_questions[], chatbot_online_after_questions_message
  • chatbot_offline_message, chatbot_offline_questions[], chatbot_offline_after_questions_message

Contact-information capture​

  • contact_information_questions.name / email / phone — each enabled + question_text

Chatbot type​

  • chatbot_enabled — master switch
  • chatbot_type — basic or flow

AI chat​

  • ai_chat.setting (quick / advanced)
  • ai_chat.agent_instructions, agent_name, tone, response_size
  • ai_chat.post_chat_tags (Mixed: { builtin: { engaged }, custom: [{description, tag}] }) — post-chat GHL outcome tags; applied by ChatTranscriptEmailJob whenever GHL is connected (the widget_chat_tags_enabled gate was removed 2026-09-25). A blank builtin tag defaults to its key.

AI calling (outbound)​

  • ai_calling.enable, setting (quick / advanced)
  • ai_calling.agent_instructions, agent_name, tone, response_size, greeting_message
  • ai_calling.post_call_tags (Mixed) — post-call GHL outcome tags for widget AI voice calls; applied by AiCallGhlTranscriptSyncJob whenever GHL is connected (widget_call_tags_enabled removed 2026-09-25).

AI inbound call​

  • ai_inbound_call.enable, model, model_provider, agent_voice_id, agent_language

AI outbound campaigns​

  • ai_outbound_call_enabled (tenant toggle)
  • ai_outbound_call_allowed (admin gate)
  • ai_outbound_call_agents[] — multi-agent (each with prompt, voice, model, webhook_secret)

AI auto-trigger (chatbot pop-up)​

  • ai_auto_trigger.enable, ai_model, ai_model_provider
  • ai_auto_trigger.system_instructions, threshold (default 50)
  • ai_auto_trigger.default_messages
  • ai_auto_trigger.url_rules[] — url, trigger_type (chat/call), duration, message
  • ai_auto_trigger.agent_name, agent_photo

Call auto-trigger (auto-connect video)​

  • call_auto_trigger.is_activated, display_time (default 15s)
  • call_auto_trigger.auto_connect_video_file (FileModel ObjectId)
  • call_auto_trigger.has_audio, enable_ringtone
  • call_auto_trigger.auto_connect_agent_name, auto_connect_message
  • call_auto_trigger.call_background.background_color, background_image
  • call_auto_trigger.text_color

AI config​

  • ai_config.chat_model, chat_model_provider
  • ai_config.call_model, call_agent_voice_id
  • ai_config.call_routing (ai / human / ai_to_human / hybrid)
  • ai_config.chat_routing (ai / human / ai_to_human)
  • enable_calling_agent

Routing & queues​

  • chat_queue — bool, enable chat queueing
  • allow_twilio_calls, always_twilio_calls

Knowledge base (for AI agents)​

  • agent_knowledge_base_documents[] — file (FileModel), status, job_id, page_count, error, frontmatter

Page rules / widget rules​

  • widget_page_rules.is_enable, rules[], hide_on_pages[]
  • rules[].video_has_audio (Boolean, 2026-09) — whether the rule's media has a soundtrack; the widget hides its mute button when false (an uploaded image is converted to a silent MP4). Unset on older rules: the widget falls back to widgetvideo_audio when the rule reuses the company's video_file, otherwise true (rules used to accept video only).

White-label​

  • widget_whitelabel.is_enable, text, url
  • Agency-managed: agency_id, agency_self_account

Lead scoring​

companies.lead_score:

  • visited_heigh_intent_page, user_initiated_call
  • call_auto_connect_accepted, chat_auto_connect_accepted
  • call_greater_than, chat_greater_than
  • booked_meeting, shared_email, shared_phone
  • industry_match, product_searched
  • returned_visitor (weight 50)
  • pages_visited_exceeded (weight 50), pages_visited_threshold (default 3)
  • notification_sent

Lead intelligence / B2B enrichment​

  • lead_intelligence (master), lead_intelligence_allowed (default 40)
  • rb2b_enabled, rb2b_allowed (default 20)
  • snitcher_enabled, snitcher_allowed (default 20)
  • allow_clearbit
  • clearbit_contact_ghl.enable, synced_at
  • happier_leads_config — website_id, client_id, private_key

Identity graph​

  • identity_graph_allowed (super-admin gate)
  • identity_graph_use_custom_config
  • identity_graph_config.enabled, enabled_sections[], custom_intro
  • identity_graph_config.max_recent_pages / max_past_conversations / max_extracted_facts
  • identity_graph_config.verification_policy (permissive / moderate / strict / regulated)
  • identity_graph_config.accept_inbound_call_verification
  • identity_graph_config.capture_website_forms

See Identity Graph for what these control.

Knox (Nox admin assistant)​

  • knox.enabled — default true, no UI writes it; scopes Nox background jobs only (Nox itself is on for every company)
  • knox.target_market
  • knox.tracked_pages[], watchlist_companies[], high_value_pages[]
  • knox.alert_thresholds.* — rage_click_spike_count, intent_score_floor, visit_count_alert, anomaly_std_dev, form_abandonment_rate_alert, dead_click_threshold
  • knox.digest_schedule.enabled, day, time_local
  • knox.baseline_metrics (Mixed — nightly rollup of "what's normal")

See What is Nox and Daily Brief.

Notifications​

  • notifications.chat_transcript, call, missed_call
  • notifications.reports_email.enabled, frequency, last_sent_at
  • notifications.daily_recap_email.enabled, last_sent_at
  • notifications.slack_new_visitor, slack_hot_lead
  • send_chat_transcript, chat_transcript_emails_to[]
  • billing_emails[]

Integrations​

  • hubspot.access_token / refresh_token / hub_id / scopes[]
  • go_high_level.access_token / refresh_token / location_id / company_id / secret_key / calendar_id / booking_enabled
  • ghl_self_account — alternative GHL self-service flow
  • calendly_integration.access_token / refresh_token / owner_uri / event_type_uri / event_type_duration / scheduling_url
  • google_calendar_integration.access_token / refresh_token
  • zapier.secret, zapier.webhooks[] (url, event, zap_id)
  • webhooks_enabled

See CRM Integration.

Booking​

  • booking_button — show the booking button in the widget

Billing​

  • registered_package_id (Package ref)
  • manual_ai_credits_calculation.credits_calculation, number_of_credits
  • stripe_customer_id
  • free_period_minutes (default 10)
  • grace_period_claimed
  • signup_wallet_grant_pending / signup_wallet_granted_at — the one-time $10 direct-signup grant (Wallet)
  • appsumo_license_key, appsumo_paused — AppSumo Licensing

Agency​

  • agency_id (Agency ref)
  • agency_self_account (bool) — the agency's own site; for self-serve agencies this is the signup's own business (Agency overview)
  • created_via — 'platform_api' when created by the agency's Platform API (shrinks /setup to password + auto-filled "Your business"); absent otherwise
  • industry_details.agent_name / industry_details.default_description — also filled from the Platform API create call or the agency's client defaults

Super-admin gates​

Still per-company: bot_flow_enabled (also fanned out per agency from agency.bot_flow_enabled), identity_graph_allowed, the *_allowed limits, partner_certification_enabled, agent_k_lab_enabled, agent_k_pacing_visible, agent_k_provider, snitcher_enabled, gdpr_protection_enabled, and voice_engine_enabled — which since 70b732400 (2026-09-30) defaults to true for new companies (every speech-to-speech provider allowed; a super admin can still turn it off). Readers compare === true and lean() skips schema defaults, so an existing company with no stored value still reads as off.

Removed 2026-09-25 (backend f1d39fb38, frontend 021eae6b, ms-ai 2f15c50f8) — fields, PUT /company/:_id/<toggle> routes, and every check deleted; the feature is on for every company:

Removed fieldOld routeNow
agent_k_beta_enabled/agent-k-betaai_agent_k.enabled is the only switch; /company/agent-k/onboarding-enable is just client setup's wallet check (402 on an empty wallet)
nox_activity_enabled/nox-activityNox Activity for all (agency client permission pages.nox_activity still applies)
nox_config_enabled/nox-configsettings-by-chat for all
verified_visitor_badge_enabled/verified-visitor-badgeVerifiedVisitorBadge.vue renders on identity_trust === 'verified' alone
widget_call_tags_enabled/widget-call-tagspost-call tags whenever GHL is connected
widget_chat_tags_enabled/widget-chat-tagspost-chat tags whenever GHL is connected
leadconnector_chat_start_url_enabled/leadconnector-chat-start-urlCrmSyncHelper posts the "Chat started from" note for every GHL-connected company

Removed 2026-10-09 (backend 1f9742dc8, frontend ac19403a): nox_funnel_beta_enabled and PUT /company/:_id/nox-funnel-beta — the tenant's nox_funnel.enabled is the only funnel switch (FunnelStageService.getConfig() returns null while it's off).

scripts/grandfather-agent-k-auto-push.js keeps its old beta filter on purpose.