---
title: "เริ่มต้นใช้งานอย่างรวดเร็ว (API)"
description: "รับสายโทรศัพท์สายแรกด้วย AI เอเจนต์: รับคีย์ API สร้างเอเจนต์ จัดสรรหมายเลขโทรศัพท์ และโทรทดสอบแบบสด ทั้งหมดผ่าน REST API"
---

คู่มือนี้จะแนะนำคำขอ REST ทั้งสี่รายการที่ใช้ในการรับสายโทรศัพท์สายแรกของคุณด้วย AI เอเจนต์

<Info>
  คุณจะต้องมี[บัญชี ThunderPhone](https://app.thunderphone.com)
  สมัครใช้งานฟรีและใช้เวลาไม่ถึงหนึ่งนาที ต้องการคลิกแทนการใช้ curl หรือไม่
  [คู่มือเริ่มต้นใช้งานแดชบอร์ด](/th/quickstart-dashboard)ช่วยให้คุณรับสายแรกได้เช่นกัน
  โดยไม่ต้องเขียนโค้ด
</Info>

## ขั้นตอนที่ 1: รับคีย์ API

<Steps>
  <Step title="ลงชื่อเข้าใช้">
    เปิด[app.thunderphone.com](https://app.thunderphone.com)
  </Step>
  <Step title="ไปที่คีย์">
    ไปที่ **องค์กร → คีย์** ในแดชบอร์ด
  </Step>
  <Step title="สร้างคีย์">
    คลิก **สร้างคีย์** ตั้งชื่อ แล้วคัดลอกค่า
    `sk_live_...` คีย์แบบเต็มจะแสดง **เพียงครั้งเดียว** — จัดเก็บไว้
    ในตัวจัดการข้อมูลลับของคุณทันที
  </Step>
</Steps>

<Tip>
  ติดปัญหาหรือไม่ [สร้างคีย์ API ของเซิร์ฟเวอร์](/th/guides/api-keys)จะแนะนำ
  ขั้นตอนนี้โดยละเอียดทีละขั้นตอน และผู้ช่วยร่วมในแอปสามารถ
  ชี้ให้เห็นตัวควบคุมแต่ละรายการแบบเรียลไทม์ได้
</Tip>

ตลอดคู่มือนี้ ให้แทนที่ `sk_live_YOUR_API_KEY` ด้วยค่าที่คุณ
เพิ่งคัดลอก คีย์จะระบุองค์กรของคุณโดยอัตโนมัติ ดังนั้นคุณไม่จำเป็นต้องใส่รหัสองค์กรใน URL

## ขั้นตอนที่ 2: สร้างเอเจนต์

เอเจนต์กำหนดวิธีที่ AI จัดการบทสนทนา — พรอมป์ต์ เสียง
ระดับผลิตภัณฑ์ เครื่องมือ และสิทธิ์การใช้งานวิดเจ็ต

<CodeGroup>
```bash cURL
curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":   "Customer Support",
    "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    "voice":  "john",
    "product": "spark"
  }'
```

```python Python
import os, requests

agent = requests.post(
    "https://api.thunderphone.com/v1/agents",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={
        "name":   "Customer Support",
        "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
        "voice":  "john",
        "product": "spark",
    },
).json()
print("Agent id:", agent["id"])
```

```javascript Node.js
const agent = await fetch("https://api.thunderphone.com/v1/agents", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.THUNDERPHONE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name:    "Customer Support",
    prompt:  "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    voice:   "john",
    product: "spark",
  }),
}).then((r) => r.json());
console.log("Agent id:", agent.id);
```
</CodeGroup>

<Tip>
  ระดับผลิตภัณฑ์: `spark` ปรับให้เหมาะกับต้นทุน `bolt` สำหรับความเร็ว และ
  `storm-base` / `storm-extra` สำหรับความสามารถในการวิเคราะห์พรอมป์ต์ที่ซับซ้อน ดู
  [เอเจนต์](/api-reference/agents#product-tiers-at-a-glance)สำหรับการเปรียบเทียบ
  แบบเต็ม
</Tip>

## ขั้นตอนที่ 3: จัดเตรียมหมายเลขโทรศัพท์

คำขอนี้ขอหมายเลขจาก ThunderPhone และกำหนดเอเจนต์ใหม่ของคุณเป็นตัวจัดการสายเรียกเข้า (หากต้องการนำหมายเลขของคุณเองจากผู้ให้บริการ VoIP มาใช้ โปรดดู [การเชื่อมต่อ VoIP](/api-reference/voip-connections) แทน)

<CodeGroup>
```bash cURL
# First provision
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

# Then assign the agent you created in Step 2
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/<id-from-previous> \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'
```

```python Python
number = requests.post(
    "https://api.thunderphone.com/v1/phone-numbers",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"area_code": "415"},
).json()
requests.patch(
    f"https://api.thunderphone.com/v1/phone-numbers/{number['id']}",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"inbound_agent_id": agent["id"]},
)
print("Your ThunderPhone number:", number["number"])
```
</CodeGroup>

หมายเลขใหม่ของคุณเริ่มต้นด้วย `status="provisioning"` และเปลี่ยนเป็น `active` ภายในไม่กี่วินาที เมื่อคุณปิดเบราว์เซอร์ หมายเลขก็พร้อมรับสายแล้ว

## ขั้นตอนที่ 4 (ไม่บังคับ): ตั้งค่าเว็บฮุก

สำหรับเหตุการณ์แบบเรียลไทม์ (การกำหนดเส้นทางสายแบบไดนามิก การประมวลผลหลังการโทร) ให้เพิ่มปลายทางเว็บฮุก สมัครรับเฉพาะเหตุการณ์ที่คุณต้องการ

```bash
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label":  "Prod webhook",
    "url":    "https://your-server.com/thunderphone-webhook",
    "events": ["telephony.incoming", "telephony.complete"]
  }'
```

การตอบกลับมี `secret` ที่แสดงเพียงครั้งเดียว ให้คัดลอกไปยังระบบจัดการข้อมูลลับของคุณ ใช้ข้อมูลลับนั้นเพื่อตรวจสอบส่วนหัว `X-ThunderPhone-Signature` ในคำขอขาเข้า (ดู [ภาพรวมเว็บฮุก](/th/webhooks/overview))

## ขั้นตอนที่ 5: ทดสอบเอเจนต์ของคุณ

โทรไปยังหมายเลขที่คุณเพิ่งจัดเตรียม เอเจนต์จะรับสาย แนะนำตัว และทำตามพรอมป์ต์ของคุณ

ตรวจสอบสายหลังจากสิ้นสุด:

```bash
curl https://api.thunderphone.com/v1/calls \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

ดูรายละเอียดของสายที่ต้องการเพื่อดึงข้อความถอดเสียงและ URL ของไฟล์บันทึกเสียง:

```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

---

## ขั้นตอนถัดไป

<CardGroup cols={2}>
  <Card title="เพิ่มเครื่องมือฟังก์ชัน" icon="screwdriver-wrench" href="/th/tools/overview">
    ให้เอเจนต์เรียก API ของคุณระหว่างการสนทนา
  </Card>
  <Card title="โทรออก" icon="arrow-up-right" href="/api-reference/outbound-calls">
    เริ่มการโทรจากโค้ดของคุณเอง
  </Card>
  <Card title="จัดการเว็บฮุก" icon="bolt" href="/th/webhooks/overview">
    ตอบสนองต่อเหตุการณ์การโทรแบบเรียลไทม์
  </Card>
  <Card title="ข้อมูลอ้างอิง API ฉบับเต็ม" icon="book" href="/api-reference/introduction">
    เอกสารสำหรับทุกปลายทางสาธารณะ
  </Card>
</CardGroup>