Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blackbox.dasha.ai/llms.txt

Use this file to discover all available pages before exploring further.

Add your agent to any website. Users talk or chat with the agent directly in the browser — no phone number needed. What you’ll learn: Quick setup, embedding code, and platform-specific installation.
The widget works on any HTTPS website. Voice calls require HTTPS; text chat works on HTTP.

​
Quick start

1

Create web integration

Go to Agents → Select your agent → Web Integrations → Add Integration
2

Add allowed origins

Add your website domains: https://example.com, https://www.example.com
3

Enable features

Toggle AllowWebCall, AllowWebChat, or both
4

Generate token

Save → Authentication tab → Generate Token → Copy immediately (shown once)
5

Embed on site

Add before the closing </body> tag:
<blackbox-agent
  server-url="https://blackbox.dasha.ai"
  token="YOUR_TOKEN"
  position="bottom-right"
  theme="dark"
></blackbox-agent>
<script src="https://blackbox.dasha.ai/widget/blackbox-widget-v3.min.js" defer></script>
That’s it. The widget appears on your site, ready for voice and chat conversations.

​
Platform-specific installation

Widget Configuration

Complete guide: React, Next.js, WordPress, attributes, features, and security

​
Widget attributes

AttributeRequiredDescription
server-urlYesDasha BlackBox API server
tokenYesWeb integration token
positionNobottom-right, bottom-left, top-right, top-left
themeNolight or dark

Widget Customization

Complete guide: CSS variables, JavaScript API, and branding

​
Security

Never use * wildcard for all origins in production. This allows anyone to use your widget.
Configure specific domains in the Origins tab:
  • https://example.com — exact match
  • https://*.example.com — all subdomains
  • http://localhost:3000 — local development

Configuring Webhooks

Complete webhook configuration and security guide

​
Troubleshooting

IssueSolution
Widget not loadingCheck token is correct, integration is enabled
Origin blocked errorAdd exact domain to origins (include https://)
Voice not workingVerify site uses HTTPS, check mic permission

Common Issues

Complete troubleshooting guide

​
What’s next

Widget Configuration

Configure features, tokens, and security

Widget Customization

Customize styling and behavior

Production Checklist

Pre-launch verification

Call History

Track widget usage