ਆਉਟਬਾਊਂਡ ਕਾਲਾਂ ਕਰੋ (API)

ਆਉਟਬਾਊਂਡ ਕਾਲਿੰਗ ਤੁਹਾਨੂੰ ThunderPhone ਨੂੰ ਇੱਕ ਟਿਕਾਣਾ ਨੰਬਰ ਅਤੇ ਏਜੰਟ ਕਨਫਿਗਰੇਸ਼ਨ ਦੇਣ ਦਿੰਦੀ ਹੈ ਤਾਂ ਜੋ AI ਤੁਹਾਡੀ ਥਾਂ ਕਾਲ ਕਰੇ। ਆਮ ਵਰਤੋਂ ਦੇ ਮਾਮਲੇ:

• ਅਪਾਇੰਟਮੈਂਟ ਪੁਸ਼ਟੀਆਂ
• ਸਰਵੇ ਕਾਲਬੈਕ
• ਮਿਸਡ ਕਾਲ ਤੋਂ ਬਾਅਦ "ਦੂਜੀ ਕੋਸ਼ਿਸ਼" ਵਾਲੇ ਫਾਲੋ-ਅੱਪ
• ਡਿਸਪੈਚ-ਸਟਾਈਲ ਸੂਚਨਾਵਾਂ

ਪੂਰਵ-ਲੋੜਾਂ

1. ਇੱਕ VoIP ਨੰਬਰ ਲਿਆਓ

   ਆਉਟਬਾਊਂਡ ਕਾਲਿੰਗ ਲਈ ਤੁਹਾਡੇ ਕੋਲ from_number ਇੱਕ VoIP ਕਨੈਕਸ਼ਨ ਰਾਹੀਂ ਹੋਣਾ ਲਾਜ਼ਮੀ ਹੈ। ਡੈਮੋ ਨੰਬਰ ਸਿਰਫ਼ ਇਨਬਾਊਂਡ ਲਈ ਹਨ। ਵੇਖੋ ਆਪਣੇ ਨੰਬਰ ਲਿਆਓ।

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

   ਆਉਟਬਾਊਂਡ-ਅਨੁਕੂਲ prompt ਵਿੱਚ ਏਜੰਟ ਆਮ ਤੌਰ 'ਤੇ ਪਹਿਲਾਂ ਆਪਣੀ ਪਛਾਣ ਅਤੇ ਮਕਸਦ ਦੱਸਦਾ ਹੈ — "ਸਤ ਸ੍ਰੀ ਅਕਾਲ, ਇਹ Acme ਹੈ ਜੋ ਤੁਹਾਡੀ ਕੱਲ੍ਹ ਦੁਪਹਿਰ 3 ਵਜੇ ਦੀ ਅਪਾਇੰਟਮੈਂਟ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨ ਲਈ ਕਾਲ ਕਰ ਰਿਹਾ ਹੈ…" outbound_speak_order ਨੂੰ agent_first ਉੱਤੇ ਸੈੱਟ ਕਰੋ (ਡਿਫਾਲਟ)।

3. ਪਾਜ਼ਿਟਿਵ ਬੈਲੈਂਸ ਰੱਖੋ

   ਜੇ ਬੈਲੈਂਸ ≤ $0.00 ਹੋਵੇ ਤਾਂ ਆਉਟਬਾਊਂਡ ਕਾਲਾਂ 402 Payment Required ਵਾਪਸ ਕਰਦੀਆਂ ਹਨ। ਇਸ ਰਾਹੀਂ ਟੌਪ ਅੱਪ ਕਰੋ POST /v1/billing/top-up ਜਾਂ ਆਟੋ-ਰੀਲੋਡ ਯੋਗ ਕਰੋ।

ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਨਾਲ ਕਾਲ ਕਰੋ

ਸਭ ਤੋਂ ਸੌਖਾ ਤਰੀਕਾ — ID ਰਾਹੀਂ ਏਜੰਟ ਦਾ ਹਵਾਲਾ ਦਿਓ:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "agent_id":    12
  }'

ਜਵਾਬ:

{ "call_id": 987654321, "status": "initiated" }

ਇਨਲਾਈਨ ਕਨਫਿਗ ਨਾਲ ਕਾਲ ਕਰੋ

ਜੇ ਤੁਹਾਨੂੰ ਇੱਕ ਵਾਰ ਲਈ ਅਜਿਹਾ prompt ਚਾਹੀਦਾ ਹੈ ਜਿਸਨੂੰ ਏਜੰਟ ਵਜੋਂ ਸੇਵ ਕਰਨਾ ਲਾਭਦਾਇਕ ਨਹੀਂ, ਤਾਂ ਇਸ ਦੀ ਬਜਾਏ config ਦਿਓ। ਇਸਦੀ ਸ਼ਕਲ call.incoming ਵੈੱਬਹੁੱਕ ਦੀ ਜਵਾਬ ਸਕੀਮਾ ਨਾਲ ਮਿਲਦੀ ਹੈ:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155550199",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

ਕਾਲ ਨੂੰ ਫਾਲੋ ਕਰੋ

ਨਾਲ ਹੀ, telephony.complete ਵੈੱਬਹੁੱਕ ਨੂੰ ਸਬਸਕ੍ਰਾਈਬ ਕਰੋ — ਕਾਲ ਖਤਮ ਹੋਣ ਬਾਰੇ ਜਾਣਨ ਦਾ ਸਭ ਤੋਂ ਤੇਜ਼ ਤਰੀਕਾ। ਜੇ ਤੁਸੀਂ ਇਨਬਾਊਂਡ ਵੈੱਬਹੁੱਕ ਸਵੀਕਾਰ ਨਹੀਂ ਕਰ ਸਕਦੇ, ਤਾਂ ਹਰ ਕੁਝ ਸਕਿੰਟਾਂ ਬਾਅਦ GET /v1/calls/{call_id} ਪੋਲ ਕਰੋ; ਕਾਲ ਖਤਮ ਹੋਣ ਤੋਂ ਬਾਅਦ ਰਿਕਾਰਡ ਵਿੱਚ end_reason, duration_seconds, ਅਤੇ ਰਿਕਾਰਡਿੰਗ URL ਸ਼ਾਮਲ ਹੁੰਦੇ ਹਨ।

ਸੰਭਾਲਣ ਯੋਗ ਅਸਫਲਤਾ ਮੋਡ

ਹੋਲਡ ਸਮਾਂ ਨਿਯੰਤਰਿਤ ਕਰਨਾ

ਹੌਲੀ ਪ੍ਰਤੀਕਿਰਿਆ ਕਰਨ ਵਾਲੇ ਪ੍ਰਾਪਤਕਰਤਾ ਕਰਕੇ ਲੰਬੀਆਂ ਚੱਲਣ ਵਾਲੀਆਂ ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਨੂੰ (IVR ਟ੍ਰੀਜ਼, ਕਤਾਰਾਂ) max_hold_seconds ਨਾਲ ਸੀਮਿਤ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ:

{
  "from_number": "+15551234567",
  "to_number":   "+14155550199",
  "agent_id":    12,
  "max_hold_seconds": 120
}

ਜੇ ਪਿਛਲੇ N ਸਕਿੰਟਾਂ ਵਿੱਚ ਕੋਈ ਮਨੁੱਖੀ ਆਡੀਓ ਪ੍ਰਾਪਤ ਨਹੀਂ ਹੋਈ, ਤਾਂ ਏਜੰਟ ਕਾਲ ਡਿਸਕਨੈਕਟ ਕਰ ਦਿੰਦਾ ਹੈ। ਡਿਫਾਲਟ 900 (15 ਮਿੰਟ) ਹੈ।

ਅਗਲੇ ਕਦਮ