Question 1

What is Companin?

Accepted Answer

Companin is an AI operations platform that lets you build, deploy, and manage AI assistants for your product or team. You can create assistants with custom personas, feed them knowledge from your own files and data, and embed them anywhere via a simple widget or API.

Question 2

How do I get started?

Accepted Answer

Sign up for an account, create your first assistant, upload some knowledge, and grab your widget embed code. The whole setup takes about 5 minutes — check out our quickstart guide at /docs/quickstart for a step-by-step walkthrough.

Question 3

Do I need to be a developer to use Companin?

Accepted Answer

Not at all! The dashboard lets you create and manage assistants without writing any code. If you want to integrate via the API or embed the widget in a custom way, some technical knowledge helps — but the basics are no-code.

Question 4

How long does it take to set up?

Accepted Answer

Most teams are up and running in under 5 minutes. Creating an assistant, adding knowledge, and embedding the widget are all straightforward from the dashboard.

Question 5

What can a Companin assistant do?

Accepted Answer

A Companin assistant can answer questions, guide users through workflows, handle support queries, and pull answers from your knowledge base — all in a conversational chat interface. You can configure its tone, language, and the tasks it focuses on.

Question 6

How do I create and customize an assistant?

Accepted Answer

Head to the Features page in your dashboard, click "Create Assistant", and fill in the persona details — name, tone, language, and default tasks. You can update these anytime.

Question 7

Can I give the assistant a specific persona or tone?

Accepted Answer

Yes. You can define the assistant's name, communication style, and default behavior from the dashboard. Want it to sound formal and precise, or friendly and casual? That's up to you.

Question 8

What file types can I upload to the knowledge base?

Accepted Answer

You can upload documents (PDF, DOCX, TXT), add URLs for the assistant to index, and create Q&A pairs directly in the dashboard. The assistant uses this content to answer user questions accurately.

Question 9

Can I add Q&A pairs directly?

Accepted Answer

Yes — the Knowledge Operations page lets you write question-and-answer pairs by hand. This is great for covering specific topics you know users will ask about.

Question 10

How do I embed the widget on my website?

Accepted Answer

Copy the embed snippet from your dashboard and add it to your site's HTML. The widget loads automatically and connects to your assistant. Full instructions are in our widget integration docs at /docs/quickstart.

Question 11

How does API authentication work?

Accepted Answer

API requests use an X-API-Key and X-API-Secret header pair. You can generate and manage your API keys from the dashboard. Widget sessions use short-lived JWT tokens issued per session.

Question 12

What are the rate limits?

Accepted Answer

The default limit is 1,000 requests per hour per organization. If you need higher limits, reach out to us and we can adjust them for your plan.

Question 13

Can I track usage and analytics via the API?

Accepted Answer

Yes. The analytics API gives you access to request logs, usage aggregates, conversation metrics, and rate-limit events. See the API reference at /docs/api-reference for endpoint details.

Question 14

Do you support webhooks?

Accepted Answer

Yes — webhooks let you receive real-time events from your assistants (e.g. new messages, session starts). Configuration details are in the advanced usage docs at /docs/advanced.

Question 15

Is my data encrypted?

Accepted Answer

Yes. All data is encrypted in transit over HTTPS and at rest in our PostgreSQL database. Passwords are hashed and never stored in plain text.

Question 16

Who can access my conversations?

Accepted Answer

Only your organization's members can access your conversation data through the dashboard. We do not sell your data to third parties or use it to train models outside your organization.

Question 17

Is Companin GDPR compliant?

Accepted Answer

Yes. We follow GDPR principles — you have the right to access, correct, and delete your data. For data deletion requests or compliance questions, contact us directly.

Question 18

Can I delete my data?

Accepted Answer

Yes. You can delete individual conversations, knowledge base content, and assistants from the dashboard. To delete your entire account and all associated data, contact our support team.

Question 19

The widget isn't showing up — what do I do?

Accepted Answer

First, check that your client-id, assistant-id, and config-id attributes are set correctly in the embed snippet. Make sure the script tag is loading on the page (check your browser's network tab). If you're in dev mode, make sure dev is set to true. See our troubleshooting guide at /docs/troubleshooting for more.

Question 20

My assistant isn't responding correctly. How do I fix it?

Accepted Answer

Check that your knowledge base is populated and up to date. If the assistant is giving unexpected answers, review the persona settings and Q&A pairs. You can also test the assistant directly in the dashboard before going live.

Question 21

I'm hitting rate limits. What should I do?

Accepted Answer

The default is 1,000 requests/hour per org. Check your usage in the analytics dashboard. If you're regularly hitting the limit, contact us to discuss higher limits for your plan.

Question 22

Why am I getting authentication errors?

Accepted Answer

Double-check your API key and secret — both are required in the request headers (X-API-Key and X-API-Secret). If you recently regenerated your keys, make sure you've updated them everywhere. Widget sessions use JWTs which expire — ensure your session flow is requesting fresh tokens.

Question 23

How do I contact support?

Accepted Answer

Use the feedback form on the platform — available on the home page. We aim to respond within one business day.

Question 24

How do I report a bug or request a feature?

Accepted Answer

Use the feedback form on the main page — you can tag your submission as a bug report or feature request. We read every submission.

Question 25

Where can I find the full documentation?

Accepted Answer

The full docs are at /docs. They cover everything from widget setup and configuration to the full API reference, advanced usage, and troubleshooting.

Frequently Asked Questions

Getting Started

Features & Assistants

API & Integration

Security & Privacy

Troubleshooting

Support