ThunderPhone v3 ਹੁਣ ਲਾਈਵ ਹੈ।ਸੈਲਫ਼-ਸਰਵਿਸ—2¢/ਮਿੰਟ ਤੋਂ।ਐਲਾਨ ਪੜ੍ਹੋ

Developer cookbook

ਇਨਬਾਊਂਡ ਕਾਲਾਂ ਸੰਭਾਲੋ (API)

ਸ਼ੁਰੂ ਤੋਂ ਅੰਤ ਤੱਕ: ਇੱਕ ਏਜੰਟ ਕੌਂਫਿਗਰ ਕਰੋ, ਇਸਨੂੰ ਫ਼ੋਨ ਨੰਬਰ ਨਾਲ ਜੋੜੋ, ਕਾਲ ਲਵੋ ਅਤੇ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਦੀ ਜਾਂਚ ਕਰੋ।

ਤੁਹਾਡੇ ਟਰਮੀਨਲ ਤੋਂ, "AI ਨਾਲ ਫੋਨ ਦਾ ਜਵਾਬ ਦਿਓ" ਦਾ ਮਿਆਰੀ ਪ੍ਰਵਾਹ। ਤੁਸੀਂ ਇਹ ਕਰੋਗੇ:

  1. ਇੱਕ prompt ਅਤੇ ਵੌਇਸ ਨਾਲ ਏਜੰਟ ਬਣਾਓ।
  2. ਇੱਕ ਫੋਨ ਨੰਬਰ ਪ੍ਰੋਵਿਜ਼ਨ ਕਰੋ (ਜਾਂ ਆਪਣਾ ਲਿਆਓ) ਅਤੇ ਏਜੰਟ ਨੂੰ ਉਸਦਾ ਇਨਬਾਊਂਡ ਹੈਂਡਲਰ ਨਿਯੁਕਤ ਕਰੋ।
  3. ਨੰਬਰ 'ਤੇ ਕਾਲ ਕਰੋ। ਕਾਲ ਲੌਗ, ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਅਤੇ ਰਿਕਾਰਡਿੰਗ ਦੇਖੋ।

ਕੁੱਲ API ਕਾਲਾਂ: ਚਾਰ। ਕੁੱਲ ਸਮਾਂ: ਪੰਜ ਮਿੰਟ ਤੋਂ ਘੱਟ।

1. ਇੱਕ ਏਜੰਟ ਬਣਾਓ

ਇੱਕ ਏਜੰਟ prompt, ਵੌਇਸ ਅਤੇ ਉਤਪਾਦ ਟੀਅਰ ਨੂੰ ਇਕੱਠਾ ਕਰਦਾ ਹੈ ਜੋ ਕਾਲ ਚਲਾਉਣਗੇ। ਤੁਸੀਂ ਏਜੰਟ ਉੱਤੇ ਕਾਲ ਸੀਮਾਵਾਂ ਵੀ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ, ਜਿਵੇਂ ਕਿ max_call_duration_seconds ਅਤੇ ring_duration_seconds। ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਲਈ, ਤੁਸੀਂ max_hold_seconds ਵੀ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ ਤਾਂ ਜੋ ਏਜੰਟ ਕਾਲ ਖਤਮ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਹੋਲਡ ਉੱਤੇ ਉਡੀਕ ਕਰਨ ਦਾ ਸਮਾਂ ਸੀਮਿਤ ਰਹੇ। Bolt ਏਜੰਟ audio_tier, endpointing, ਅਤੇ intelligence ਨੂੰ ਵੀ ਸਮਰਥਨ ਦਿੰਦੇ ਹਨ ਤਾਂ ਜੋ ਉਹ ਕਿਵੇਂ ਸੁਣਦੇ ਅਤੇ ਜਵਾਬ ਦਿੰਦੇ ਹਨ ਇਸ ਨੂੰ ਕੰਟਰੋਲ ਕੀਤਾ ਜਾ ਸਕੇ: intelligence core ਜਾਂ pro ਹੁੰਦਾ ਹੈ, ਅਤੇ audio_tier (Hearing) lite, standard, plus ਜਾਂ max ਹੁੰਦਾ ਹੈ (Max ਆਮ ਤੌਰ ਉੱਤੇ ਉਪਲਬਧ ਨਹੀਂ ਹੈ)। ਪੁਰਾਣੇ ਮੁੱਲਾਂ (lite ਅਤੇ standard intelligence ਲਈ; hearing ਲਈ lean, hearing ਅਤੇ deep_hearing) ਨੂੰ ਹਾਲੇ ਵੀ ਸਵੀਕਾਰਿਆ ਜਾਂਦਾ ਹੈ। ਫੁੱਲ ਡੁਪਲੈਕਸ ਏਜੰਟ ਸਮਰਥਿਤ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਇੱਕੋ ਵੌਇਸ ਰੱਖਦੇ ਹਨ, ਇਸ ਲਈ ਉਹਨਾਂ ਕਾਲਾਂ ਉੱਤੇ ਹਰ-ਭਾਸ਼ਾ ਵੌਇਸ ਬਦਲਾਅ ਲਾਗੂ ਨਹੀਂ ਹੁੰਦਾ। ਏਜੰਟ ਏਜੰਟ ਦੇ ਬੋਲਣ ਤੋਂ ਪਹਿਲਾਂ ਪਹਿਲਾਂ ਤੋਂ ਰਿਕਾਰਡ ਕੀਤਾ ਇੰਟਰੋ ਅਤੇ ਵੱਧ ਤੋਂ ਵੱਧ ਦੋ ਰਿੰਗ ਚਲਾਉਣ ਲਈ intro_clip ਅਤੇ intro_ring_count ਨੂੰ ਵੀ ਸਮਰਥਨ ਦਿੰਦੇ ਹਨ। ਨਵੇਂ ਏਜੰਟਾਂ ਨੂੰ ਟਾਈਮ ਜ਼ੋਨ ਵੀ ਚਾਹੀਦਾ ਹੈ। ਜੇ ਤੁਹਾਡਾ ਏਜੰਟ ਬਹੁਭਾਸ਼ੀ ਹੈ, ਤਾਂ ਤੁਸੀਂ language_switching ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ ਤਾਂ ਜੋ ਇਹ ਕੰਟਰੋਲ ਕੀਤਾ ਜਾ ਸਕੇ ਕਿ ਇਹ ਭਾਸ਼ਾ ਬਦਲਣ ਤੋਂ ਪਹਿਲਾਂ ਪੁੱਛਦਾ ਹੈ ਜਾਂ ਕਾਲਰ ਦੀ ਭਾਸ਼ਾ ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੈ। ਤੁਸੀਂ ਖਾਸ ਸ਼ਬਦਾਂ ਨੂੰ ਕਿਵੇਂ ਬੋਲਣਾ ਹੈ ਅਤੇ ਕਿਹੜੇ ਸ਼ਬਦਾਂ ਨੂੰ ਸੁਣਨਾ ਹੈ ਇਸ ਨੂੰ ਕੰਟਰੋਲ ਕਰਨ ਲਈ ਏਜੰਟ ਉੱਤੇ words ਵੀ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ। ਹਰੇਕ ਕੌਂਫਿਗਰੇਸ਼ਨ ਫੀਲਡ ਲਈ Agents ਦੇਖੋ; ਘੱਟੋ-ਘੱਟ ਇਹ ਹੈ:

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

ਵਾਪਸ ਆਇਆ 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"}'

ਜਵਾਬ ਵਿੱਚ E.164 ਵਿੱਚ ਇੱਕ id ਅਤੇ ਇੱਕ number ਸ਼ਾਮਲ ਹੁੰਦਾ ਹੈ। 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}'

ਬਸ ਇੰਨਾ ਹੀ — ਨੰਬਰ ਸਰਗਰਮ ਹੈ। ਤੁਹਾਡੇ ਸੰਗਠਨ ਲਈ ਆਊਟਬਾਊਂਡ ਕਾਲਿੰਗ ਮਨਜ਼ੂਰ ਹੋਣ ਤੋਂ ਬਾਅਦ, ਤੁਸੀਂ ਉਸੇ PATCH ਵਿੱਚ outbound_agent_id ਵੀ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ। ਉਸ ਤੋਂ ਪਹਿਲਾਂ, API ਉਸ ਨਿਯੁਕਤੀ ਨੂੰ 400 ਨਾਲ ਅਸਵੀਕਾਰ ਕਰਦਾ ਹੈ।

ਜੇ ਤੁਸੀਂ ਇਨਬਾਊਂਡ ਕਾਲਾਂ ਨੂੰ ਸਥਿਰ inbound_agent_id ਦੀ ਬਜਾਏ ਕਿਸੇ ਕੌਂਫਿਗ ਵੈੱਬਹੁੱਕ ਰਾਹੀਂ ਰੂਟ ਕਰਦੇ ਹੋ, ਤਾਂ ਉਹ ਵੈੱਬਹੁੱਕ ਹੁਣ agent_id ਅਤੇ variables ਦੇ ਨਾਲ ਹਰ ਕਾਲ ਲਈ timezone ਵਾਪਸ ਕਰ ਸਕਦਾ ਹੈ। Bolt ਏਜੰਟਾਂ ਲਈ, ਤੁਸੀਂ API ਰਾਈਟਸ ਵਿੱਚ ਏਜੰਟ ਉੱਤੇ audio_tier, endpointing, ਅਤੇ intelligence ਵੀ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ। API ਅਜੇ ਵੀ endpointing ਲਈ ਉਪਨਾਮ ਵਜੋਂ ਪੁਰਾਣਾ eagerness ਨਾਮ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ। ਜੇ ਤੁਹਾਡਾ ਏਜੰਟ trigger="call_start" ਵਾਲੇ API ਕਨੈਕਸ਼ਨ ਵਰਤਦਾ ਹੈ, ਤਾਂ ThunderPhone ਹਰ ਫ਼ੋਨ ਕਾਲ ਦੀ ਸ਼ੁਰੂਆਤ ਵਿੱਚ, ਸਵਾਗਤ ਤੋਂ ਪਹਿਲਾਂ, ਉਨ੍ਹਾਂ ਦੇ ਸੁਰੱਖਿਅਤ ਕੀਤੇ call_start_arguments ਵਰਤ ਕੇ ਉਹ ਟੂਲ ਇੱਕ ਵਾਰ ਚਲਾ ਸਕਦਾ ਹੈ।

ਤੁਹਾਡੀਆਂ ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਲਈ ਕਾਲਬੈਕ

ਜਦੋਂ ਕੋਈ ਵਿਅਕਤੀ ਉਸ ਨੰਬਰ 'ਤੇ ਵਾਪਸ ਕਾਲ ਕਰਦਾ ਹੈ ਜਿਸ ਨੇ ਪਿਛਲੇ 30 ਦਿਨਾਂ ਵਿੱਚ ਉਸ ਨੂੰ ਕਾਲ ਕੀਤੀ ਸੀ, ਤਾਂ ਕਾਲ ਦਾ ਜਵਾਬ ਦੇਣ ਵਾਲੇ ਏਜੰਟ ਨੂੰ ਉਸ ਕਾਲ ਬਾਰੇ ਇੱਕ ਛੋਟਾ ਪਿਛੋਕੜ ਨੋਟ ਮਿਲਦਾ ਹੈ: ਉਹ ਕਦੋਂ ਕੀਤੀ ਗਈ ਸੀ, ਕਿਸ ਏਜੰਟ ਦੁਆਰਾ ਕੀਤੀ ਗਈ ਸੀ ਅਤੇ ਕੀ ਹੋਇਆ ਸੀ (ਕੋਈ ਜਵਾਬ ਨਹੀਂ, ਵੌਇਸਮੇਲ ਜਾਂ ਗੱਲਬਾਤ)। ਜਿਸ ਨੰਬਰ ਲਈ ਕੋਈ ਇਨਬਾਊਂਡ ਏਜੰਟ ਨਹੀਂ ਹੈ, ਉਹ ਉਹੀ ਵੇਰਵੇ ਤੁਹਾਡੇ ਕਨਫਿਗ ਵੈੱਬਹੁੱਕ ਨੂੰ returning_call ਵਜੋਂ ਭੇਜਦਾ ਹੈ। ਜੇ ਉਸ ਨੰਬਰ ਲਈ ਕੋਈ ਵੈੱਬਹੁੱਕ ਨਹੀਂ ਹੈ, ਜਾਂ ਵੈੱਬਹੁੱਕ ਦਾ ਸਮਾਂ ਸਮਾਪਤ ਹੋ ਜਾਂਦਾ ਹੈ ਜਾਂ ਉਸ ਤੱਕ ਪਹੁੰਚ ਨਹੀਂ ਹੋ ਸਕਦੀ, ਤਾਂ ਕਾਲ ਖਤਮ ਹੋਣ ਦੀ ਬਜਾਏ ਉਸ ਏਜੰਟ ਕੋਲ ਜਾਂਦੀ ਹੈ ਜਿਸ ਨੇ ਪਹਿਲਾਂ ਕਾਲ ਕੀਤੀ ਸੀ। ਕਾਲਰ ID ਨਕਲੀ ਹੋ ਸਕਦੀ ਹੈ, ਇਸ ਲਈ ਪਹਿਲੀ ਕਾਲ ਦਾ ਸਾਰ ਅਤੇ ਵੇਰੀਏਬਲ ਸਿਰਫ਼ ਉਦੋਂ ਸਾਂਝੇ ਕੀਤੇ ਜਾਂਦੇ ਹਨ ਜਦੋਂ ਕੋਈ ਐਡਮਿਨ ਸੰਗਠਨ → ਆਮ → ਕਾਲਬੈਕਸ ਦੇ ਅਧੀਨ ਪਹਿਲੀ ਕਾਲ ਦੇ ਵੇਰਵੇ ਸਾਂਝੇ ਕਰੋ ਚਾਲੂ ਕਰਦਾ ਹੈ। ਵੇਖੋ ਕਾਲਬੈਕਸ।

4. ਕਾਲ ਲਓ

ਆਪਣੇ ਫੋਨ ਤੋਂ ਨੰਬਰ ਡਾਇਲ ਕਰੋ। ਏਜੰਟ ਕਾਲ ਚੁੱਕਦਾ ਹੈ, ਤੁਹਾਡੇ prompt ਅਨੁਸਾਰ ਆਪਣਾ ਪਰਿਚਯ ਦਿੰਦਾ ਹੈ, ਅਤੇ ਗੱਲਬਾਤ ਸ਼ੁਰੂ ਹੋ ਜਾਂਦੀ ਹੈ।

ਜਦੋਂ ਕਾਲ ਚੱਲ ਰਹੀ ਹੁੰਦੀ ਹੈ, ਇਹ GET /v1/calls ਵਿੱਚ status="in_progress" ਨਾਲ ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ। ਕਾਲ ਖ਼ਤਮ ਹੋਣ 'ਤੇ, ਰਿਕਾਰਡ end_reason, duration_seconds, billable_minutes, ਅਤੇ (ਆਖ਼ਿਰਕਾਰ) ਇੱਕ ਰਿਕਾਰਡਿੰਗ URL ਅਤੇ AI ਗ੍ਰੇਡ ਨਾਲ ਅੱਪਡੇਟ ਹੁੰਦਾ ਹੈ।

ਇਨਬਾਊਂਡ ਕਾਲਾਂ ਤੁਹਾਡੀ ਸੰਸਥਾ ਦੀ ਇਕੱਠੇ ਕਾਲਾਂ ਦੀ ਸੀਮਾ ਵਿੱਚ ਗਿਣੀਆਂ ਜਾਂਦੀਆਂ ਹਨ (ਮੂਲ ਰੂਪ ਵਿੱਚ 20 ਕਾਲਾਂ ਪ੍ਰਗਤੀ ਵਿੱਚ ਹੁੰਦੀਆਂ ਹਨ, ਜੋ ਆਊਟਬਾਊਂਡ, ਵੈੱਬ ਅਤੇ ਟੈਸਟ ਕਾਲਾਂ ਨਾਲ ਸਾਂਝੀਆਂ ਹੁੰਦੀਆਂ ਹਨ)। ਸੀਮਾ 'ਤੇ ਪਹੁੰਚਣ ਵਾਲੀ ਕਾਲ ਨੂੰ ਏਜੰਟ ਦੇ ਜਵਾਬ ਦੇਣ ਤੋਂ ਪਹਿਲਾਂ ਅਸਵੀਕਾਰ ਕਰਕੇ ਕੱਟ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ, ਇਸ ਦਾ ਬਿਲ ਨਹੀਂ ਬਣਦਾ, ਅਤੇ ਇਸਨੂੰ concurrent_call_limit_reached ਅੰਤ ਕਾਰਨ ਵਾਲੀ ਅਸਫਲ ਕਾਲ ਵਜੋਂ ਦਰਜ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਜੇ ਤੁਹਾਨੂੰ ਵੱਧ ਸੀਮਾ ਦੀ ਲੋੜ ਹੋਵੇ ਤਾਂ support@thunderphone.com ਨੂੰ ਈਮੇਲ ਕਰੋ।

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 ਵੈੱਬਹੁੱਕ ਦੀ ਗਾਹਕੀ ਲਈ ਹੈ, ਤਾਂ ਤੁਹਾਨੂੰ ਉਹੀ ਡਾਟਾ ਤੁਹਾਡੇ ਸਰਵਰ ਨੂੰ POST ਦੇ ਰੂਪ ਵਿੱਚ ਮਿਲੇਗਾ — ਵੇਖੋ call.complete।

ਜੇ ਤੁਹਾਡੇ ਏਜੰਟ ਵਿੱਚ ਐਕਸਟ੍ਰੈਕਸ਼ਨ ਫੀਲਡਾਂ ਕਨਫਿਗਰ ਕੀਤੀਆਂ ਹਨ, ਤਾਂ ਪੂਰੀ ਹੋਈ ਕਾਲ ਦੇ ਪੇਲੋਡ ਵਿੱਚ ਸੰਰਚਿਤ ਐਕਸਟ੍ਰੈਕਟ ਕੀਤਾ ਡਾਟਾ ਵੀ ਸ਼ਾਮਲ ਹੋ ਸਕਦਾ ਹੈ। ਕਾਲ ਸੰਖੇਪ ਉਸ ਭਾਸ਼ਾ ਵਿੱਚ ਲਿਖੇ ਜਾਂਦੇ ਹਨ ਜੋ ਤੁਹਾਡੀ ਸੰਸਥਾ ThunderPhone ਵਿੱਚ ਵਰਤਦੀ ਹੈ, ਜਦ ਤੱਕ ਏਜੰਟ ਉਸ ਸੈਟਿੰਗ ਨੂੰ ਓਵਰਰਾਈਡ ਨਾ ਕਰੇ।


ਅਗਲੇ ਕਦਮ