Chat quickstart

You are a helpful customer support agent for TechFlow, a software company. 
Your role:
- Answer common questions about our products
- Help troubleshoot basic issues  
- Escalate complex problems to human agents
Keep responses concise and helpful. Always maintain a friendly, professional tone.

$
curl -X POST https://api.vapi.ai/chat \
>
  -H "Authorization: Bearer YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "assistantId": "your-assistant-id",
>
    "input": "Hi, I need help with my TechFlow account"
>
  }'

1
{
2
  "id": "chat_abc123",
3
  "assistantId": "your-assistant-id",
4
  "messages": [
5
    {
6
      "role": "user",
7
      "content": "Hi, I need help with my TechFlow account"
8
    }
9
  ],
10
  "output": [
11
    {
12
      "role": "assistant",
13
      "content": "I'd be happy to help with your TechFlow account! What specific issue are you experiencing?"
14
    }
15
  ],
16
  "createdAt": "2024-01-15T09:30:00Z",
17
  "updatedAt": "2024-01-15T09:30:00Z"
18
}

$
curl -X POST https://api.vapi.ai/chat \
>
  -H "Authorization: Bearer YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "assistantId": "your-assistant-id",
>
    "previousChatId": "chat_abc123",
>
    "input": "I forgot my password and can't log in"
>
  }'

$
curl -X POST https://api.vapi.ai/chat \
>
  -H "Authorization: Bearer YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "assistantId": "your-assistant-id", 
>
    "previousChatId": "chat_abc123",
>
    "input": "What was my original question?"
>
  }'

You are a helpful customer support agent for {{companyName}}.
Your role:
- Answer questions about {{companyName}}'s products
- Help customers with their {{serviceType}} needs
- Escalate to human agents when needed
Current customer tier: {{customerTier}}

$
curl -X POST https://api.vapi.ai/chat \
>
  -H "Authorization: Bearer YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "assistantId": "your-assistant-id",
>
    "input": "I need help with my account",
>
    "assistantOverrides": {
>
      "variableValues": {
>
        "companyName": "TechFlow Solutions",
>
        "serviceType": "software",
>
        "customerTier": "Premium"
>
      }
>
    }
>
  }'

1
interface ChatMessage {
2
  role: 'user' | 'assistant';
3
  content: string;
4
}
5
6
interface ChatApiResponse {
7
  id: string;
8
  assistantId: string;
9
  messages: ChatMessage[];
10
  output: ChatMessage[];
11
  createdAt: string;
12
  updatedAt: string;
13
  orgId?: string;
14
  sessionId?: string;
15
  name?: string;
16
}
17
18
interface ChatResponse {
19
  chatId: string;
20
  response: string;
21
  fullData: ChatApiResponse;
22
}
23
24
async function sendChatMessage(
25
  message: string, 
26
  previousChatId?: string
27
): Promise<ChatResponse> {
28
  const response = await fetch('https://api.vapi.ai/chat', {
29
    method: 'POST',
30
    headers: {
31
      'Authorization': 'Bearer YOUR_API_KEY',
32
      'Content-Type': 'application/json'
33
    },
34
    body: JSON.stringify({
35
      assistantId: 'your-assistant-id',
36
      input: message,
37
      ...(previousChatId && { previousChatId })
38
    })
39
  });
40
41
  if (!response.ok) {
42
    throw new Error(`HTTP error! status: ${response.status}`);
43
  }
44
45
  const chat: ChatApiResponse = await response.json();
46
  return {
47
    chatId: chat.id,
48
    response: chat.output[0].content,
49
    fullData: chat
50
  };
51
}
52
53
// Usage example
54
const firstMessage = await sendChatMessage("Hello, I need help");
55
console.log(firstMessage.response);
56
57
const followUp = await sendChatMessage("Tell me more", firstMessage.chatId);
58
console.log(followUp.response);

$
curl -X POST https://api.vapi.ai/chat \
>
  -H "Authorization: Bearer YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "assistantId": "your-assistant-id",
>
    "input": "What are your business hours?"
>
  }'

$
curl -X POST https://api.vapi.ai/chat \
>
  -H "Authorization: Bearer YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "assistantId": "your-assistant-id",
>
    "input": "My app keeps crashing when I try to export data"
>
  }'