Fit assessment for a described business (vendor self-assessment, can say no)

Deterministic assessment per the locked fit contract. Reads approved product facts only; never fetches the described website. primary_need is one of website_assistant, customer_service, lead_generation, appointments, faq, multilingual, agency, white_label, full_omnichannel_helpdesk. Rate limited per IP.

post/api/agents/fit

Request

  • Base URL: https://smartwebchat.eu
  • URL: https://smartwebchat.eu/api/agents/fit
  • Auth: none required

Request body

marketstring

Country or market of the business, e.g. 'DE', 'de-AT', 'NL', 'US'. Free text; only the language part is matched against the published website languages.

localestring

Language tag for the returned URLs, e.g. 'en', 'fr-CA', 'it', 'pt-BR'. Any well-formed tag is accepted; languages without a published website fall back to 'de'. The language never changes the verdict.

primary_need'website_assistant' | 'customer_service' | 'lead_generation' | 'appointments' | 'faq' | 'multilingual' | 'agency' | 'white_label' | 'full_omnichannel_helpdesk' required

What the business mainly needs the assistant for.

website_platformstring

Website system as stated by the caller, e.g. 'wordpress'. Echoed back only; never fetched or verified.

number_of_client_assistantsinteger

How many separate businesses or client assistants are to be served. More than one points to the agency plan.

requires_white_labelboolean

Smartwebchat branding must be removed.

requires_custom_widget_domainboolean

The widget must run on the caller's own domain.

requires_full_omnichannel_inboxboolean

A full omnichannel inbox or helpdesk across channels is required.

requires_direct_calendar_writeboolean

The assistant must write appointments directly into a calendar.

sensitive_professional_contextboolean

The business handles sensitive professional data (e.g. health, legal, tax).

requested_ai_provider'default' | 'mistral' | 'openai' | 'anthropic' | 'other'

The language model provider the caller wants. 'default' is the vendor's EU standard configuration.

Response

Fit assessment

schema_version'1.0' required
fit'good_fit' | 'partial_fit' | 'not_fit' | 'needs_review' required
reasonsstring[] required
limitationsstring[] required
recommended_plan'business' | 'agency' | 'white_label' | 'none' | 'needs_review' required
relevant_urlsstring[] required
trial_urlstring uri nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.