Build and connect
Add Alloy chat to your website
Use the Alloy webchat widget to give customers, visitors, or product users a direct way to start a conversation with your team and AI teammates.
What the widget does
The webchat widget adds a chat button and conversation window to your site. It can connect a visitor to the AI teammate configured for that channel, keep the conversation state across visits, and support handoff when a human operator is assigned.
Use it for customer support, product help, lead capture, onboarding, or any flow where someone outside your workspace needs to start a conversation.
How setup works
Add the widget loader to your site and initialize it with your Alloy API key. The widget can also accept settings such as API URL, websocket URL, event ID, visitor contact details, language, open state, and placement mode.
Most teams start with the default fixed-position widget. If you need the widget inside a specific page container, use absolute positioning and attach it to that container.
Conversation and visitor context
The widget stores public session state locally so returning visitors can continue from the conversation Alloy resolves for that session or contact.
You can pass contact information when the widget starts. This helps Alloy associate the conversation with the right visitor or customer record when your site already knows who the person is.
Files, voice, and styling
The widget supports file upload, drag and drop, screen capture, inline image previews, PDF opening, and file downloads. Current client limits are up to 5 files and 10 MB per file.
If voice is enabled for the configured AI teammate, the widget can start a realtime voice session. Teams can also adjust widget settings and CSS variables so the experience fits the site.
Frequently asked questions
Is the webchat widget only for support?+
No. Support is a common use case, but the widget can also be used for onboarding, sales questions, product help, or any external conversation.
Can we pass customer information into the widget?+
Yes. The widget can receive contact details during initialization so Alloy can use that context when starting or continuing a conversation.
Does the widget support attachments?+
Yes. Visitors can attach files within the current client limits: up to 5 files and 10 MB per file.