Quickstart Guide

Integrate Evnao into your application in minutes. Learn how to authenticate, initialize a conversation, and pass custom metadata to the AI.

1. Get your API Keys

Before making any requests, you need to grab your API keys from the Dashboard Settings. Keep your Secret Key safe and never expose it in client-side code.

2. Initialize the Widget (React)

The easiest way to get started is by using our official React SDK. Simply wrap your application in the `EvnaoProvider` and drop the `ChatWidget` component anywhere in your tree.

import {  EvnaoProvider, ChatWidget  } from "@evnao/react";

export default function App() {
  return (
    <EvnaoProvider publishableKey="pk_live_xxxxxxxxx">
      <YourApplication />
      <ChatWidget
        theme="dark"
        metadata={{ 
          userId: "user_123",
          plan: "enterprise"
        }}
      />
    </EvnaoProvider>
  );
}

3. Passing Custom Metadata

When a user is logged in to your application, you should pass their data to Evnao via the `metadata` object. This context empowers the AI to resolve tickets without asking the user for their email, account ID, or subscription tier.