Connect an inbox
Use the External Assistant API to turn email or support threads into suggested replies.
Start here
Connect outside tools to the knowledge and training inside a Bombyx organization.
Bombyx lets a third-party app talk to an organization’s Brain without pretending to be the website assistant.
The most common use is simple:
- Your app sends Bombyx a message, like a customer email.
- Bombyx reads the organization’s Brain and assistant training.
- Bombyx sends back a suggested reply.
- Your app decides what to do next.
Tiny but important: Bombyx suggests replies. It does not send the email, support reply, or sales message for you.
Production Base URL
Section titled “Production Base URL”Use this base URL for tool connector requests:
https://bombyxlabs.com/app/api/tool-connectors/v1Do not use the root /api/tool-connectors/v1 path for production integrations. The live Bombyx site has a Laravel and WordPress split, so /app/api/... is the safe public route.
What To Build First
Section titled “What To Build First”Search organization memory
Use the Memory API when your tool needs focused context before it acts.
Use MCP
Use the MCP Connector when your agent or local tool already speaks Model Context Protocol.
Install the assistant
Use the Website Assistant install guide for WordPress or direct script installs.
Before You Start
Section titled “Before You Start”You need a Bombyx owner or admin to create a tool connector and token in the app.
Ask them for:
- A bearer token that starts with
btx_ - The connector’s enabled capabilities
- The chatbot ID, if the organization has more than one assistant
Tokens are shown once. If the token was lost, rotate it and use the new one.