Обработване на входящи обаждания (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:

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. Демо номерата започват със 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.

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