ਇਨਬਾਊਂਡ ਕਾਲਾਂ ਸੰਭਾਲੋ (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 ਦੇ ਪੂਲ ਤੋਂ ਇੱਕ ਡੈਮੋ ਨੰਬਰ ਪ੍ਰੋਵਿਜ਼ਨ ਕਰੋ:

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

ਅਗਲੇ ਕਦਮ