Add Venanto to a customer site without a support loop.

Pick the smallest integration that works.

Generate a limited install key.

Use an API key from Console > Tools. `allowed_origin` should be the exact browser origin that will host the widget.

curl -X POST https://venanto.com/api/v1/install-keys \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "label": "Main website",
    "allowed_origin": "https://www.example.com"
  }'

The response includes a one-time install key, widget snippet, and script URL for custom sites.

Use the plugin when you want the fewest moving parts.

1. Download `vilrio-chat.zip` from the console or `/static/downloads/vilrio-chat.zip?v=0.2.6`.
2. Upload it in WordPress Plugins, then activate `Venanto Chat`.
3. Open Settings > Venanto Chat and click `Connect Venanto`.
4. Sign in to Venanto, choose the bot for this site, and return to WordPress.
5. Choose title, accent color, suggestions, and whether the chat opens automatically.
6. Send a test message on the live site and check install activity in Venanto.

Manual connection fields remain available inside the plugin only as an advanced fallback.

Backend chat uses the same bot, knowledge, tools, and audit history.

Prefer `Authorization: Bearer YOUR_VILRIO_KEY`. Existing server integrations can also send `X-Venanto-Api-Key: YOUR_VILRIO_KEY`. Create the narrowest key that fits the integration.

curl -X POST https://venanto.com/api/v1/chat \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "message": "What are your hours?",
    "external_user_ref": "customer-42"
  }'

Available API permissions cover bot lookup, install-key creation, chat, knowledge updates, and answer testing.

Index first, test answers second, then publish.

curl -X POST https://venanto.com/api/v1/knowledge \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "title": "Service FAQ",
    "content": "Emergency requests should be handed to staff immediately.",
    "source_type": "api"
  }'

curl -X POST https://venanto.com/api/v1/answer-test \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bot_id":123,"query":"What happens in an emergency?"}'

Keep powerful credentials away from browsers.