Обработвайте входящи обаждания (API)

От край до край: конфигурирайте агент, задайте му телефонен номер, приемете обаждане и прегледайте транскрипта.

Стандартният процес „отговорете на обаждане с AI“ от вашия терминал. Ще:

1. Създадете агент с подкана и глас.
2. Осигурите (или добавите свой) телефонен номер и ще зададете агента като негов обработващ входящите обаждания.
3. Ще се обадите на номера. Ще прегледате дневника на обажданията, транскрипцията и записа.

Общо API извиквания: четири. Общо време: под пет минути.

1. Създайте агент#

Агентът обединява подканата, гласа и продуктовото ниво, които ще обработват обаждането. Вижте Агенти за всички полета за конфигуриране; минималното необходимо е:

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "spark"
  }'

Запазете върнатото id — ще ви трябва в стъпка 2.

2. Вземете телефонен номер#

Ако просто ви е нужен номер, на който да се обаждате, вземете номер на ThunderPhone от пула на ThunderPhone:

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"}'

Отговорът включва id и number във формат E.164. Номерата на ThunderPhone започват със status="provisioning" и стават active в рамките на няколко секунди — извършвайте периодични заявки към GET /v1/phone-numbers/{id}, за да следите промяната, ако е необходимо.

3. Задайте агента#

Свържете агента от стъпка 1 с входящата посока на номера:

curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

Това е всичко — номерът е активен. Можете също да зададете outbound_agent_id в същата PATCH заявка, така че номерът да е готов и за изходящи обаждания.

4. Приемете обаждане#

Наберете номера от телефона си. Агентът отговаря, представя се според вашата подкана и разговорът започва.

Докато обаждането е активно, то се показва в GET /v1/calls със status="in_progress". Когато приключи, записът се актуализира с end_reason, duration_seconds, billable_minutes и (впоследствие) URL адрес за запис и AI оценка.

5. Прегледайте резултатите#

Извлечете списъка със скорошни обаждания:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Вземете транскрипцията:

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

И URL адреса на записа (краткотраен, подписан):

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

Ако сте се абонирали за telephony.complete webhook, ще получите същите данни като POST заявка към вашия сървър — вижте call.complete.

Следващи стъпки#