Guidance Needed: Publishing Convai Avatar URL, Web App Integration, and Capturing User Responses

Hi Convai team,

We’re currently on a Scale Plan and actively working on integrating a Convai avatar into our web application. I had a few implementation-level queries and would really appreciate your guidance:

:one: Publishing Avatar URL

I’d like to publish a URL for the avatar created in the Convai Dashboard (under my account). However, I noticed three visibility options:

  • Public
  • Private
  • Unlisted

Could you please clarify the differences between these options?
Which one should I use if I want to:

  • Embed the avatar into my web application
  • Allow end users to interact with it (one-on-one conversations)
  • Keep the experience secure, but accessible only via the web app

:two: Web App Integration

My plan is to integrate the avatar URL into a custom-built React/Vite frontend. Users should be able to converse directly with the avatar from the browser.

Are there any best practices, SDKs, or embed mechanisms you recommend for this scenario?

:three: Capturing User Conversation

Post conversation, I need to capture the user’s inputs/responses and forward them to our backend API for processing, storage, and analytics.

Is there a supported way to listen to or intercept user utterances or conversation transcripts from Convai’s hosted avatar?

:compass: Looking for Direction

I’d appreciate any documentation, examples, or architectural guidance you can share to:

  • Choose the correct publish setting
  • Embed avatars securely in production
  • Capture conversation data programmatically

Thanks in advance for the support!

— Shubham

Hello @Shubham_Vaidya,

Thank you for reaching out and for the detailed breakdown of your integration goals. It’s great to hear you’re actively building with Convai!

Currently, the Embed Experience feature is available exclusively to our Enterprise customers. We recommend scheduling a call with our sales team. During the call, we’d be happy to walk you through potential solutions, technical customizations, and deployment best practices tailored to your project needs.

You can book a meeting here: https://calendly.com/convai-intro/hi