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

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

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

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

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

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

ਇੱਕ ਏਜੰਟ prompt, ਆਵਾਜ਼ ਅਤੇ ਉਤਪਾਦ ਟੀਅਰ ਨੂੰ ਇਕੱਠਾ ਕਰਦਾ ਹੈ ਜੋ ਕਾਲ ਨੂੰ ਚਲਾਉਣਗੇ। ਤੁਸੀਂ ਏਜੰਟ ਉੱਤੇ max_call_duration_seconds ਅਤੇ ring_duration_seconds ਵਰਗੀਆਂ ਕਾਲ ਸੀਮਾਵਾਂ ਵੀ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ। ਨਵੇਂ ਏਜੰਟਾਂ ਲਈ ਸਮਾਂ ਖੇਤਰ ਵੀ ਲੋੜੀਂਦਾ ਹੈ। ਹਰੇਕ ਕੌਂਫਿਗਰੇਸ਼ਨ ਫੀਲਡ ਲਈ ਏਜੰਟ ਵੇਖੋ; ਘੱਟੋ-ਘੱਟ ਲੋੜ ਇਹ ਹੈ:

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

ਜਵਾਬ ਵਿੱਚ 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 ਦੀ ਬਜਾਏ config webhook ਰਾਹੀਂ ਰੂਟ ਕਰਦੇ ਹੋ, ਤਾਂ ਉਹ webhook ਹੁਣ ਹਰ ਕਾਲ ਲਈ agent_id ਅਤੇ variables ਦੇ ਨਾਲ timezone ਵੀ ਵਾਪਸ ਕਰ ਸਕਦਾ ਹੈ।

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।

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

ਅਗਲੇ ਕਦਮ#