ਆਉਣ ਵਾਲੀਆਂ ਕਾਲਾਂ ਸੰਭਾਲੋ (API)

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

ਤੁਹਾਡੇ ਟਰਮੀਨਲ ਤੋਂ ਫੋਨ ਦਾ "AI ਨਾਲ ਜਵਾਬ ਦੇਣ" ਵਾਲਾ ਮਿਆਰੀ ਫਲੋ। ਤੁਸੀਂ:

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

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

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

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

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 ਵੀ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ ਤਾਂ ਜੋ ਨੰਬਰ ਆਊਟਬਾਊਂਡ ਕਾਲ ਕਰਨ ਲਈ ਵੀ ਤਿਆਰ ਹੋਵੇ।

4. ਇੱਕ ਕਾਲ ਲਵੋ#

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

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

ਅਗਲੇ ਕਦਮ#