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

Webhooks

telephony.incoming / web.incoming

ਬਲਾਕਿੰਗ webhook ਜੋ ਇਨਬਾਊਂਡ ਕਾਲ ਦੀ ਸੰਰਚਨਾ ਨੂੰ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਢਾਲਦਾ ਹੈ।

ਜਦੋਂ ਇੱਕ ਇਨਬਾਊਂਡ ਫ਼ੋਨ ਕਾਲ ਉਸ ਨੰਬਰ 'ਤੇ ਪਹੁੰਚਦੀ ਹੈ ਜਿਸ ਲਈ ਕੋਈ ਏਜੰਟ ਅਸਾਈਨ ਨਹੀਂ ਹੈ (ਤੁਹਾਡੀਆਂ ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਦਾ ਜਵਾਬ ਦੇਣ ਵਾਲੇ ਕਾਲਰਾਂ ਲਈ ਕਾਲਬੈਕਸ ਵੇਖੋ), ਜਾਂ ਇੱਕ ਵੈੱਬ ਵਿਜੇਟ ਸੈਸ਼ਨ ਪਬਲਿਸ਼ ਕਰਨ ਯੋਗ ਕੀ 'ਤੇ mode="webhook" ਵਿੱਚ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ, ਤਾਂ ThunderPhone ਤੁਹਾਡੇ ਲੇਗੇਸੀ ਵੈੱਬਹੁੱਕ URL ਨੂੰ ਇੱਕ ਬਲੌਕ ਕਰਨ ਵਾਲੀ telephony.incoming / web.incoming ਬੇਨਤੀ ਭੇਜਦਾ ਹੈ ਅਤੇ ਕਨਫ਼ਿਗਰੇਸ਼ਨ ਜਵਾਬ ਦੀ ਉਡੀਕ ਕਰਦਾ ਹੈ: ਇੱਕ ਫ਼ੋਨ ਕਾਲ ਲਈ ਵੱਧ ਤੋਂ ਵੱਧ 13 ਸਕਿੰਟ, ਜਿਸ ਵਿੱਚ ਇੱਕ ਰੀਟ੍ਰਾਈ ਸ਼ਾਮਲ ਹੈ, ਅਤੇ ਇੱਕ ਵਿਜੇਟ ਸੈਸ਼ਨ ਲਈ ਵੱਧ ਤੋਂ ਵੱਧ 10 ਸਕਿੰਟ (ਟਾਈਮਆਉਟ ਅਤੇ ਰੀਟ੍ਰਾਈਜ਼ ਵੇਖੋ)। ਹਰ ਕਾਲ ਲਈ prompt, ਆਵਾਜ਼ ਅਤੇ ਟੂਲਾਂ ਨੂੰ ਗਤੀਸ਼ੀਲ ਤੌਰ 'ਤੇ ਚੁਣਨ ਲਈ ਇਸ ਅਦਾਨ-ਪ੍ਰਦਾਨ ਦੀ ਵਰਤੋਂ ਕਰੋ — ਪੂਰੇ ਪੈਟਰਨ ਲਈ ਗਤੀਸ਼ੀਲ ਕਾਲ ਕਨਫ਼ਿਗਰੇਸ਼ਨ ਗਾਈਡ ਵੇਖੋ।

ਕਿਸੇ ਏਜੰਟ ਨੂੰ ਸੌਂਪਿਆ ਗਿਆ ਨੰਬਰ ਉਸੇ ਏਜੰਟ ਨਾਲ ਜਵਾਬ ਦਿੰਦਾ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਆਪਣਾ ਕਾਲ ਸੈਟਅੱਪ webhook ਹੁੰਦਾ ਹੈ, ਤਾਂ ਏਜੰਟ ਦੇ ਵੇਰੀਏਬਲਾਂ ਅਤੇ ਕਾਲ ਦੇ ਸੰਦਰਭ ਨੂੰ ਭਰਨ ਲਈ ਉਹੀ ਬਲੌਕਿੰਗ ਅਦਲਾ-ਬਦਲੀ ਪਹਿਲਾਂ ਏਜੰਟ ਦੇ URL 'ਤੇ ਚਲਦੀ ਹੈ।

ਸਮਾਂ-ਸੀਮਾਵਾਂ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ਾਂ

ਜਲਦੀ ਜਵਾਬ ਦਿਓ: ਜਦੋਂ ਤੁਸੀਂ ਫੈਸਲਾ ਕਰ ਰਹੇ ਹੋ, ਕਾਲਰ ਲਾਈਨ ਉੱਤੇ ਉਡੀਕ ਕਰ ਰਿਹਾ ਹੈ।

ਫ਼ੋਨ ਕਾਲ (telephony.incoming) ਲਈ:

  • ਪਹਿਲੀ ਕੋਸ਼ਿਸ਼ ਵਿੱਚ ਵੱਧ ਤੋਂ ਵੱਧ 10 ਸਕਿੰਟ ਲੱਗ ਸਕਦੇ ਹਨ।
  • ਜੇ ਇਸ ਦੀ ਸਮਾਂ-ਸੀਮਾ ਖਤਮ ਹੋ ਜਾਂਦੀ ਹੈ, ਕਨੈਕਟ ਨਹੀਂ ਹੋ ਸਕਦਾ, ਜਾਂ 5xx, 408 ਜਾਂ 429 ਜਵਾਬ ਮਿਲਦਾ ਹੈ, ਤਾਂ ThunderPhone ਇੱਕ ਵਾਰ ਹੋਰ ਕੋਸ਼ਿਸ਼ ਕਰਦਾ ਹੈ। ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਨੂੰ ਪੂਰੇ ਐਕਸਚੇਂਜ ਲਈ 13-ਸਕਿੰਟ ਦੇ ਬਜਟ ਵਿੱਚੋਂ ਬਚਿਆ ਹੋਇਆ ਸਮਾਂ ਮਿਲਦਾ ਹੈ: ਸਮਾਂ-ਸੀਮਾ ਖਤਮ ਹੋਈ ਪਹਿਲੀ ਕੋਸ਼ਿਸ਼ ਤੋਂ ਬਾਅਦ ਲਗਭਗ 3 ਸਕਿੰਟ, ਤੇਜ਼ੀ ਨਾਲ ਅਸਫਲ ਹੋਣ ਤੋਂ ਬਾਅਦ ਲਗਭਗ ਪੂਰੇ 13 ਸਕਿੰਟ। ਜਦੋਂ 2 ਸਕਿੰਟ ਤੋਂ ਘੱਟ ਸਮਾਂ ਬਚਦਾ ਹੋਵੇ, ਤਾਂ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਨਹੀਂ ਕੀਤੀ ਜਾਂਦੀ।
  • ਕੋਈ ਹੋਰ 4xx ਜਵਾਬ, ਆਕਾਰ ਸੀਮਾ ਤੋਂ ਵੱਧ ਜਵਾਬ, ਜਾਂ ਉਹ 2xx ਜਿਸਦਾ ਬਾਡੀ ਵੈਧ ਕੌਨਫਿਗਰੇਸ਼ਨ ਨਹੀਂ ਹੈ, ਅੰਤਿਮ ਹੁੰਦਾ ਹੈ ਅਤੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਨਹੀਂ ਕੀਤੀ ਜਾਂਦੀ।
  • ਦੋਵੇਂ ਕੋਸ਼ਿਸ਼ਾਂ ਇੱਕੋ ਬਾਡੀ, ਇੱਕੋ X-ThunderPhone-Signature, ਅਤੇ ਇੱਕੋ X-ThunderPhone-Idempotency-Key ਹੈਡਰ (telephony-incoming-<call_id>) ਭੇਜਦੀਆਂ ਹਨ, ਇਸ ਲਈ ਸਾਈਡ ਇਫੈਕਟ ਵਾਲਾ ਹੈਂਡਲਰ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਨੂੰ ਪਛਾਣ ਸਕਦਾ ਹੈ।

ਜੇ ਕੋਈ ਵਰਤਣਯੋਗ ਕਨਫਿਗਰੇਸ਼ਨ ਨਹੀਂ ਆਉਂਦੀ, ਤਾਂ ਕਾਲਰ ਨੂੰ ਖਾਮੋਸ਼ ਲਾਈਨ 'ਤੇ ਛੱਡਣ ਦੀ ਬਜਾਏ ਕਾਲ ਤੁਰੰਤ ਖਤਮ ਕਰ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ। ਇਹ ਕਾਲ ਇਤਿਹਾਸ ਵਿੱਚ end_reason inbound_config_webhook_failed ਵਾਲੀ ਅਸਫਲ, ਬਿਨਾਂ ਬਿਲ ਕੀਤੀ ਕਾਲ ਵਜੋਂ ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ, ਅਤੇ ਆਮ telephony.complete ਇਵੈਂਟ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ। ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਕਾਲ ਦਾ ਪੰਨਾ, ਅਤੇ GET /v1/calls/{call_id} ਵਿੱਚ config_webhook_failure, ਦੱਸਦੇ ਹਨ ਕਿ ਤੁਹਾਡੇ ਵੇਬਹੁੱਕ ਨੇ ਕੀ ਕੀਤਾ: {kind, attempts, http_status, host, source}, ਜਿੱਥੇ kind http_error, timeout, connection, dns, tls, response_too_large, blocked_url, other, invalid_json, non_object_json ਜਾਂ invalid_config ਹੁੰਦਾ ਹੈ, host ਤੁਹਾਡੇ ਵੇਬਹੁੱਕ ਦਾ ਹੋਸਟ ਨਾਮ ਹੁੰਦਾ ਹੈ, ਅਤੇ source number (ਇਹ ਵੇਬਹੁੱਕ) ਜਾਂ agent_setup (ਏਜੰਟ ਦਾ ਕਾਲ ਸੈਟਅੱਪ ਵੇਬਹੁੱਕ) ਹੁੰਦਾ ਹੈ। invalid_config ਲਈ, reason ਦੱਸਦਾ ਹੈ ਕਿ ਜਵਾਬ ਕਿਉਂ ਵਰਤਿਆ ਨਹੀਂ ਜਾ ਸਕਿਆ ਅਤੇ fields ਸੰਬੰਧਿਤ ਫੀਲਡਾਂ ਦੇ ਨਾਮ ਦਿੰਦਾ ਹੈ: no_agent (ਨਾ agent_id ਨਾ ਹੀ prompt; fields ਅਣਡਿੱਠੀਆਂ ਕੀਜ਼ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ, ਜਿਵੇਂ ਗਲਤ ਸਪੈਲਿੰਗ ਵਾਲਾ agentId), agent_not_found, agent_id_not_integer, unexpected_fields (agent_id ਦੇ ਨਾਲ variables, context, timezone ਅਤੇ language ਤੋਂ ਇਲਾਵਾ ਹੋਰ ਕੀਜ਼), invalid_variables, invalid_context, invalid_language, unsupported_language, invalid_config_fields ਜਾਂ agent_settings_invalid। ਨਹੀਂ ਤਾਂ reason null ਹੁੰਦਾ ਹੈ ਅਤੇ fields ਖਾਲੀ ਹੁੰਦਾ ਹੈ। ਇੱਕੋ ਅਪਵਾਦ ਉਹ ਹੈ ਜਦੋਂ ਐਕਸਚੇਂਜ ਖੁਦ ਅਸਫਲ ਹੋਣ 'ਤੇ ਕੋਈ ਕਾਲਰ ਤੁਹਾਡੀ ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਵਿੱਚੋਂ ਕਿਸੇ ਨੂੰ ਵਾਪਸ ਕਾਲ ਕਰਦਾ ਹੈ: ਵਾਪਸੀ ਕਾਲਾਂ ਵੇਖੋ।

ਵਿਜਿਟ ਸੈਸ਼ਨ (web.incoming) ਨੂੰ ਵੱਧ ਤੋਂ ਵੱਧ 10 ਸਕਿੰਟ ਦੀ ਇੱਕੋ ਕੋਸ਼ਿਸ਼ ਮਿਲਦੀ ਹੈ। ਜੇ ਇਹ ਅਸਫਲ ਹੁੰਦੀ ਹੈ, ਤਾਂ ਸੈਸ਼ਨ ਬੇਨਤੀ 502 ਜਾਂ 422 ਨਾਲ ਅਸਫਲ ਹੁੰਦੀ ਹੈ।

ਬੇਨਤੀ ਪੇਲੋਡ

ਫ਼ੋਨ ਕਾਲਾਂ ਲਈ (telephony.incoming):

{
  "type": "telephony.incoming",
  "data": {
    "call_id":     987654321,
    "from_number": "+14155550199",
    "to_number":   "+15551234567"
  }
}
ਫੀਲਡਕਿਸਮਵੇਰਵਾ
call_idਪੂਰਨ ਅੰਕਕਾਲ ਆਈਡੀ — ਇਸ ਕਾਲ ਲਈ ਸਾਰੀਆਂ ਘਟਨਾਵਾਂ ਵਿੱਚ ਸਥਿਰ
from_numberਸਟ੍ਰਿੰਗE.164 ਕਾਲਰ ਨੰਬਰ
to_numberਸਟ੍ਰਿੰਗE.164 ਮੰਜ਼ਿਲ (ਤੁਹਾਡੇ ThunderPhone ਨੰਬਰਾਂ ਵਿੱਚੋਂ ਇੱਕ)
returning_callਆਬਜੈਕਟਸਿਰਫ਼ ਉਦੋਂ ਮੌਜੂਦ ਹੁੰਦਾ ਹੈ ਜਦੋਂ ਇਸ ਨੰਬਰ ਨੇ ਪਿਛਲੇ 30 ਦਿਨਾਂ ਵਿੱਚ ਕਾਲਰ ਨੂੰ ਕਾਲ ਕੀਤੀ ਹੋਵੇ। ਕਾਲਬੈਕ ਵੇਖੋ
sip_headersਆਬਜੈਕਟਸਿਰਫ਼ ਉਦੋਂ ਮੌਜੂਦ ਹੁੰਦਾ ਹੈ ਜਦੋਂ ਕਾਲ X-* ਜਾਂ User-to-User SIP ਹੈਡਰਾਂ ਵਾਲੇ ਮੈਨੁਅਲ SIP ਕਨੈਕਸ਼ਨ ਰਾਹੀਂ ਆਈ ਹੋਵੇ: ਛੋਟੇ ਅੱਖਰਾਂ ਵਿੱਚ ਹੈਡਰ ਨਾਮ → ਮੁੱਲ। SIP ਹੈਡਰ ਵੇਖੋ

ਵੈੱਬ ਵਿਜਿਟ ਸੈਸ਼ਨਾਂ ਲਈ (web.incoming), data ਫ਼ੋਨ ਨੰਬਰਾਂ ਦੀ ਬਜਾਏ ਏਮਬੈਡਿੰਗ ਪੇਜ ਦੀ ਪਛਾਣ ਕਰਦਾ ਹੈ:

{
  "type": "web.incoming",
  "data": {
    "call_id": 987654322,
    "origin_domain": "https://example.com",
    "publishable_key_prefix": "pk_live_a1b2"
  }
}
ਫੀਲਡਕਿਸਮਵੇਰਵਾ
call_idਪੂਰਨ ਅੰਕਕਾਲ ID
origin_domainਸਟ੍ਰਿੰਗਵਿਜੇਟ ਨੂੰ ਹੋਸਟ ਕਰਨ ਵਾਲੇ ਪੰਨੇ ਦਾ ਔਰਿਜਿਨ, ਜਿਵੇਂ ਬ੍ਰਾਊਜ਼ਰ ਨੇ ਭੇਜਿਆ ਹੈ। ਗੈਰ-ਬ੍ਰਾਊਜ਼ਰ ਕਲਾਇੰਟ ਕੋਈ ਵੀ ਮੁੱਲ ਭੇਜ ਸਕਦਾ ਹੈ, ਇਸ ਲਈ ਇਸਨੂੰ ਇਸ ਗੱਲ ਦਾ ਸਬੂਤ ਨਾ ਮੰਨੋ ਕਿ ਬੇਨਤੀ ਕਿੱਥੋਂ ਆਈ ਹੈ
publishable_key_prefixਸਟ੍ਰਿੰਗਸੈਸ਼ਨ ਖੋਲ੍ਹਣ ਵਾਲੀ ਪਬਲਿਸ਼ੇਬਲ ਕੀ ਦੇ ਪਹਿਲੇ ਅੱਖਰ
language, primary_languageਸਟ੍ਰਿੰਗਜਦੋਂ ਵਿਜੇਟ ਸੈਸ਼ਨ ਨੇ ਭਾਸ਼ਾ ਓਵਰਰਾਈਡ ਦੀ ਬੇਨਤੀ ਕੀਤੀ ਹੋਵੇ ਤਾਂ ਮੌਜੂਦ ਹੁੰਦਾ ਹੈ
voiceਸਟ੍ਰਿੰਗਜਦੋਂ ਵਿਜੇਟ ਸੈਸ਼ਨ ਨੇ ਵੌਇਸ ਓਵਰਰਾਈਡ ਦੀ ਬੇਨਤੀ ਕੀਤੀ ਹੋਵੇ ਤਾਂ ਮੌਜੂਦ ਹੁੰਦਾ ਹੈ
website_contextਸਟ੍ਰਿੰਗਜਦੋਂ ਵਿਜੇਟ ਨੇ ਸੈਸ਼ਨ-ਵਿਸ਼ੇਸ਼ ਪੰਨਾ ਸੰਦਰਭ ਭੇਜਿਆ ਹੋਵੇ ਤਾਂ ਮੌਜੂਦ ਹੁੰਦਾ ਹੈ

ਓਵਰਰਾਈਡ ਫੀਲਡਾਂ (language, voice, website_context, ਅਤੇ ਕੋਈ ਵੀ ਬ੍ਰਾਊਜ਼ਰ variables) ਕੇਵਲ ਤਦੋਂ ਆਉਂਦੀਆਂ ਹਨ ਜਦੋਂ ਪਬਲਿਸ਼ੇਬਲ ਕੀ ਉਹਨਾਂ ਨੂੰ ਆਪਣੇ ਬ੍ਰਾਊਜ਼ਰ ਓਵਰਰਾਈਡਾਂ ਵਿੱਚ ਮਨਜ਼ੂਰੀ ਦਿੰਦੀ ਹੈ। ਕੀ ਵੱਲੋਂ ਮਨਜ਼ੂਰ ਨਾ ਕੀਤੀ ਗਈ ਕਿਸੇ ਫੀਲਡ ਵਾਲੀ ਸੈਸ਼ਨ ਬੇਨਤੀ ਇਸ ਵੈੱਬਹੁੱਕ ਨੂੰ ਕਾਲ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਅਸਵੀਕਾਰ ਕਰ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ।


ਜਵਾਬ ਸਕੀਮਾ

ਇਸ ਕਾਲ ਲਈ ਏਜੰਟ ਸੰਰਚਨਾ ਦਾ ਵਰਣਨ ਕਰਨ ਵਾਲਾ JSON ਆਬਜੈਕਟ ਵਾਪਸ ਕਰੋ। prompt ਅਤੇ voice ਲਾਜ਼ਮੀ ਹਨ; ਬਾਕੀ ਸਭ ਕੁਝ ਵਿਕਲਪਿਕ ਹੈ।

{
  "prompt":  "You are a helpful booking assistant for Acme Restaurant.",
  "voice":   "john",
  "product": "spark",
  "background_track": null,
  "tools":   []
}
ਫੀਲਡਕਿਸਮਲਾਜ਼ਮੀਵੇਰਵਾ
promptਸਟ੍ਰਿੰਗਹਾਂਏਜੰਟ ਨੂੰ ਚਲਾਉਣ ਵਾਲਾ ਸਿਸਟਮ prompt
voiceਸਟ੍ਰਿੰਗਹਾਂGET /v1/voices ਤੋਂ ਵੌਇਸ ਆਈਡੀ, ਉਦਾਹਰਨ ਲਈ john। voice_name ਨੂੰ ਉਪਨਾਮ ਵਜੋਂ ਸਵੀਕਾਰਿਆ ਜਾਂਦਾ ਹੈ। ਅਣਜਾਣ ਵੌਇਸਾਂ ਪ੍ਰਮਾਣਿਕਤਾ ਵਿੱਚ ਅਸਫਲ ਹੁੰਦੀਆਂ ਹਨ ਅਤੇ ਕਾਲ ਰੱਦ ਕਰ ਦਿੰਦੀਆਂ ਹਨ
productਸਟ੍ਰਿੰਗਨਹੀਂbolt ਭੇਜੋ। ਮੂਲ ਰੂਪ ਵਿੱਚ spark ਹੁੰਦਾ ਹੈ, ਜੋ ਇੱਕ ਪੁਰਾਣਾ ਮੁੱਲ ਹੈ ਅਤੇ ਅਜੇ ਵੀ storm-base, storm-base-with-ack, storm-extra ਅਤੇ storm-extra-with-ack ਨਾਲ ਸਵੀਕਾਰਿਆ ਜਾਂਦਾ ਹੈ
thinking_levelਸਟ੍ਰਿੰਗਨਹੀਂminimal, base (ਮੂਲ ਰੂਪ ਵਿੱਚ), ਜਾਂ extra। ਪੁਰਾਣੇ storm-* ਉਤਪਾਦ ਮੁੱਲਾਂ ਵਿੱਚ, storm-extra* extra ਨੂੰ ਲਾਜ਼ਮੀ ਕਰਦਾ ਹੈ ਅਤੇ ਹੋਰ storm-* base ਨੂੰ ਲਾਜ਼ਮੀ ਕਰਦੇ ਹਨ
audio_context_modeਸਟ੍ਰਿੰਗਨਹੀਂfull (ਮੂਲ ਰੂਪ ਵਿੱਚ) ਜਾਂ reduced
watchdog_enabledਬੂਲੀਅਨਨਹੀਂਇਸ ਕਾਲ ਲਈ ਨਿਗਰਾਨੀ ਸਮਰੱਥ ਕਰੋ। ਮੂਲ ਰੂਪ ਵਿੱਚ false
additional_audio_contextਬੂਲੀਅਨ | ਨੱਲਨਹੀਂਸਿਰਫ਼ ਸਭ ਤੋਂ ਤਾਜ਼ਾ ਵਾਰੀ ਦੀ ਬਜਾਏ ਕਾਲਰ ਆਡੀਓ ਦੀਆਂ ਪਿਛਲੀਆਂ ਕੁਝ ਵਾਰੀਆਂ ਸ਼ਾਮਲ ਕਰੋ, ਜਿਸ ਨਾਲ ਥੋੜ੍ਹੀ ਲੇਟੈਂਸੀ/ਲਾਗਤ ਵਧਣ ਦੇ ਬਦਲੇ ਸੁਧਾਰ ਅਤੇ ਸਪੈਲਿੰਗ/ਨੰਬਰ-ਪ੍ਰਧਾਨ ਡਾਟਾ ਇਕੱਠਾ ਕਰਨਾ ਬਿਹਤਰ ਹੁੰਦਾ ਹੈ। ਇਨਬਾਊਂਡ ਸੈਸ਼ਨਾਂ ਲਈ ਮੂਲ ਰੂਪ ਵਿੱਚ ਚਾਲੂ ਅਤੇ ਆਊਟਬਾਊਂਡ ਫ਼ੋਨ ਕਾਲਾਂ ਲਈ ਬੰਦ ਹੁੰਦਾ ਹੈ; null ਮੂਲ ਸੈਟਿੰਗ ਰੱਖਦਾ ਹੈ
storm_feedback_modeਸਟ੍ਰਿੰਗਨਹੀਂnone, acknowledgement (ਮੂਲ ਰੂਪ ਵਿੱਚ), ਜਾਂ tick: ਜਦੋਂ audio_tier plus ਜਾਂ max ਹੋਵੇ ਤਾਂ ਧੀਮਾ ਜਵਾਬ ਤਿਆਰ ਕੀਤੇ ਜਾਣ ਦੌਰਾਨ ਕਾਲਰ ਕੀ ਸੁਣਦਾ ਹੈ
languageਸਟ੍ਰਿੰਗਨਹੀਂprimary_language ਲਈ ਸੰਖੇਪ ਰੂਪ। agent_id ਦੇ ਨਾਲ ਵੀ ਮਨਜ਼ੂਰ ਹੈ, ਜਿੱਥੇ ਇਹ ਉਹ ਭਾਸ਼ਾ ਹੈ ਜਿਸ ਵਿੱਚ ਇਹ ਕਾਲ ਸ਼ੁਰੂ ਹੁੰਦੀ ਹੈ ਅਤੇ ਉਸ ਲਈ ਏਜੰਟ ਦੀ ਵੌਇਸ ਵਿੱਚ ਬੋਲੀ ਜਾਂਦੀ ਹੈ; ਹਰ ਕਾਲ ਲਈ ਭਾਸ਼ਾ ਸੈਟ ਕਰੋ ਵੇਖੋ
primary_languageਸਟ੍ਰਿੰਗਨਹੀਂਭਾਸ਼ਾ ਕੋਡ, ਸਧਾਰਨ ਕੀਤਾ ਹੋਇਆ (ਮੂਲ ਰੂਪ ਵਿੱਚ en)। ਹੱਲ ਨਾ ਹੋ ਸਕਣ ਵਾਲੇ ਕੋਡ ਕਾਲ ਨੂੰ ਰੱਦ ਕਰਦੇ ਹਨ
has_additional_languagesਬੂਲੀਅਨਨਹੀਂਮੂਲ ਰੂਪ ਵਿੱਚ false
additional_languagesਸਟ੍ਰਿੰਗ ਦੀ ਐਰੇਨਹੀਂਵਾਧੂ ਭਾਸ਼ਾਵਾਂ ਜਿਨ੍ਹਾਂ ਵਿੱਚ ਏਜੰਟ ਬਦਲ ਸਕਦਾ ਹੈ
native_voice_switchingਬੂਲੀਅਨਨਹੀਂਮੂਲ ਰੂਪ ਵਿੱਚ false। ਜਦੋਂ ਕਾਲ ਕਿਸੇ ਹੋਰ ਭਾਸ਼ਾ ਵਿੱਚ ਬਦਲਦੀ ਹੈ, ਤਾਂ ਕੌਂਫਿਗਰ ਕੀਤੀ ਵੌਇਸ ਰੱਖਣ ਦੀ ਬਜਾਏ ਉਸ ਭਾਸ਼ਾ ਦੀ ਮੂਲ ਵੌਇਸ ਨਾਲ ਬਦਲੋ (ਲਿੰਗ ਅਨੁਸਾਰ ਮੇਲ ਕੀਤੀ ਹੋਈ)
language_switchingਸਟ੍ਰਿੰਗ | ਨੱਲਨਹੀਂask_first (ਮੂਲ ਰੂਪ ਵਿੱਚ) ਜਾਂ follow_caller; null, ask_first ਦੇ ਸਮਾਨ ਹੈ। ਬਹੁ-ਭਾਸ਼ੀ ਏਜੰਟ ਦੂਜੇ ਵਿਅਕਤੀ ਵੱਲੋਂ ਆਪਣੀ ਕਿਸੇ ਹੋਰ ਭਾਸ਼ਾ ਵਿੱਚ ਬੋਲਣ ਨੂੰ ਕਿਵੇਂ ਸੰਭਾਲਦਾ ਹੈ। ਜਦੋਂ ਉਹ ਭਾਸ਼ਾ ਮੰਗਦੇ ਹਨ ਜਾਂ ਉਸ ਵਿੱਚ ਪੂਰਾ ਵਾਕ ਬੋਲਦੇ ਹਨ ਤਾਂ ask_first ਤੁਰੰਤ ਬਦਲਦਾ ਹੈ, ਅਤੇ "sí" ਵਰਗੀ ਛੋਟੀ ਗੱਲ ਤੋਂ ਬਾਅਦ ਪੁੱਛਦਾ ਹੈ ਕਿ ਕੀ ਉਸੇ ਵਿੱਚ ਜਾਰੀ ਰੱਖਣਾ ਹੈ। follow_caller ਉਹਨਾਂ ਦੀ ਬੋਲੀ ਹੋਈ ਕਿਸੇ ਵੀ ਕੌਂਫਿਗਰ ਕੀਤੀ ਭਾਸ਼ਾ ਵਿੱਚ ਬਦਲ ਜਾਂਦਾ ਹੈ, ਭਾਵੇਂ ਸਿਰਫ਼ ਇੱਕ ਸ਼ਬਦ ਹੀ ਹੋਵੇ। ਸਿਰਫ਼ ਉਦੋਂ ਲਾਗੂ ਹੁੰਦਾ ਹੈ ਜਦੋਂ additional_languages ਸੈਟ ਹੋਵੇ
audio_tierਸਟ੍ਰਿੰਗ | ਨੱਲਨਹੀਂਸਿਰਫ਼ product: "bolt" ਲਈ। ਸੁਣਨ: ਏਜੰਟ ਕਾਲਰ ਨੂੰ ਕਿੰਨੀ ਧਿਆਨ ਨਾਲ ਸੁਣਦਾ ਹੈ। standard (ਮੂਲ ਰੂਪ ਵਿੱਚ; "" ਅਤੇ null ਦਾ ਇੱਕੋ ਅਰਥ ਹੈ) ਜ਼ਿਆਦਾਤਰ ਕਾਲਾਂ ਲਈ ਢੁਕਵਾਂ ਹੈ (PHI ਪ੍ਰੋਸੈਸ ਕਰਨ ਵਾਲੀਆਂ ਕਾਲਾਂ ਸਿਰਫ਼ BAA-ਕਵਰ ਕੀਤੇ ਪ੍ਰਦਾਤਾਵਾਂ ਦੀ ਵਰਤੋਂ ਕਰਦੀਆਂ ਹਨ)। lite ਸਭ ਤੋਂ ਸਸਤਾ ਹੈ ਅਤੇ ਵੱਧ ਵਾਰ ਗਲਤ ਸੁਣਦਾ ਹੈ। plus ਮੁਸ਼ਕਲ ਵਾਰੀਆਂ ਵਿੱਚ ਵੱਧ ਧਿਆਨ ਨਾਲ ਸੁਣਦਾ ਹੈ, ਜਿਨ੍ਹਾਂ ਲਈ ਲਗਭਗ 1–2 ਸਕਿੰਟ ਵੱਧ ਲੱਗਦੇ ਹਨ। max ਸਭ ਤੋਂ ਮੁਸ਼ਕਲ ਆਡੀਓ ਅਤੇ ਦੁਰਲੱਭ ਭਾਸ਼ਾਵਾਂ ਲਈ ਹੈ; ਹਰ ਜਵਾਬ ਨੂੰ 3–4 ਸਕਿੰਟ ਲੱਗਦੇ ਹਨ ਅਤੇ ਕਾਲ pro ਇੰਟੈਲੀਜੈਂਸ ਚਲਾਉਂਦੀ ਹੈ (intelligence ਨੂੰ ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ)। max ਆਮ ਤੌਰ ਤੇ ਉਪਲਬਧ ਨਹੀਂ ਹੈ: ਜਿਸ ਸੰਸਥਾ ਲਈ ਇਹ ਸਮਰੱਥ ਨਹੀਂ ਕੀਤਾ ਗਿਆ, ਉਸ ਲਈ ਕਾਲ plus ਅਤੇ ਤੁਹਾਡੇ ਨਾਮਿਤ intelligence ਨਾਲ ਚੱਲਦੀ ਹੈ (ਇਸ ਨਾਲ ਆਊਟਬਾਊਂਡ ਕਾਲ ਬੇਨਤੀ 400 ਨਾਲ ਰੱਦ ਹੁੰਦੀ ਹੈ)। ਪੁਰਾਣੇ ਮੁੱਲ lean (ਲਾਈਟ), hearing (ਪਲੱਸ) ਅਤੇ deep_hearing (ਮੈਕਸ) ਅਜੇ ਵੀ ਸਵੀਕਾਰ ਕੀਤੇ ਜਾਂਦੇ ਹਨ। ਹੋਰ ਉਤਪਾਦ ਇਸਨੂੰ ਅਣਡਿੱਠਾ ਕਰਦੇ ਹਨ
endpointingਸਟ੍ਰਿੰਗ | ਨੱਲਨਹੀਂfaster (200 ms), fast (300 ms), normal (500 ms, ਮੂਲ ਰੂਪ ਵਿੱਚ) ਜਾਂ patient (800 ms); null, normal ਦੇ ਸਮਾਨ ਹੈ। ਕਾਲਰ ਦੇ ਰੁਕਣ ਤੋਂ ਬਾਅਦ ਜਵਾਬ ਲਈ ਮਾਡਲ ਨੂੰ ਪੁੱਛਣ ਤੋਂ ਪਹਿਲਾਂ Bolt v2 ਏਜੰਟ ਕਿੰਨਾ ਸਮਾਂ ਉਡੀਕ ਕਰਦਾ ਹੈ। ਛੋਟੀ ਉਡੀਕ ਨਾਲ ਜਲਦੀ ਜਵਾਬ ਮਿਲ ਸਕਦਾ ਹੈ, ਪਰ ਇਸ ਨਾਲ ਵੱਧ ਬੇਨਤੀਆਂ ਭੇਜੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਜਿਨ੍ਹਾਂ ਨੂੰ ਕਾਲਰ ਦੇ ਅਗਲੇ ਸ਼ਬਦ ਪੁਰਾਣਾ ਕਰ ਦਿੰਦੇ ਹਨ, ਜਿਸ ਨਾਲ ਮਾਡਲ ਦੀ ਲਾਗਤ ਵਧਦੀ ਹੈ। ਹੋਰ ਉਤਪਾਦ ਇਸਨੂੰ ਅਣਡਿੱਠਾ ਕਰਦੇ ਹਨ
eagernessਸਟ੍ਰਿੰਗ | ਨੱਲਨਹੀਂਅਪ੍ਰਚਲਿਤ: 19 ਅਕਤੂਬਰ, 2026 ਤੱਕ endpointing ਦਾ ਨਾਮ, ਅਜੇ ਵੀ ਪੜ੍ਹਿਆ ਜਾਂਦਾ ਹੈ। ਜਦੋਂ endpointing ਸੈਟ ਹੋਵੇ ਤਾਂ ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ
intelligenceਸਟ੍ਰਿੰਗ | ਨੱਲਨਹੀਂcore ਜਾਂ pro (ਮੂਲ ਰੂਪ ਵਿੱਚ); null, pro ਦੇ ਸਮਾਨ ਹੈ। Bolt v2 ਪਾਈਪਲਾਈਨ ਉੱਤੇ bolt ਏਜੰਟ ਆਪਣੀਆਂ ਹਿਦਾਇਤਾਂ ਦੀ ਕਿੰਨੀ ਭਰੋਸੇਯੋਗਤਾ ਨਾਲ ਪਾਲਣਾ ਕਰਦਾ ਹੈ। core ਲਈ ਪਹਿਲੇ ਸ਼ਬਦ ਤੱਕ ~700 ms ਲੱਗਦੇ ਹਨ, ਇਹ ਸਭ ਤੋਂ ਸਸਤਾ ਅਤੇ ਥੋੜ੍ਹਾ ਘੱਟ ਭਰੋਸੇਯੋਗ ਹੈ (PHI ਵਜੋਂ ਸੰਭਾਲੀਆਂ ਜਾਣ ਵਾਲੀਆਂ ਕਾਲਾਂ ਵਿੱਚ ~900 ms ਅਤੇ ਘੱਟ ਭਰੋਸੇਯੋਗ); pro ਲਈ ~900 ms ਲੱਗਦੇ ਹਨ; ਕੋਰ ਦੇ ਉਹ ਜਵਾਬ ਜੋ ਸਿਰਫ਼ ਟੂਲ ਨੂੰ ਕਾਲ ਕਰਦੇ, ਪ੍ਰੋ ਨੂੰ ਸੌਂਪੇ ਜਾਂਦੇ ਹਨ। ਪੁਰਾਣੇ ਮੁੱਲ lite (ਕੋਰ) ਅਤੇ standard (ਪ੍ਰੋ) ਅਜੇ ਵੀ ਸਵੀਕਾਰ ਕੀਤੇ ਜਾਂਦੇ ਹਨ, ਅਤੇ ਰਿਟਾਇਰ ਕੀਤੇ plus ਅਤੇ max pro ਉੱਤੇ ਚੱਲਦੇ ਹਨ। ਜਦੋਂ audio_tier max ਹੋਵੇ ਤਾਂ ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਹੋਰ ਉਤਪਾਦ ਇਸਨੂੰ ਅਣਡਿੱਠਾ ਕਰਦੇ ਹਨ
faster_repliesਬੂਲੀਅਨ | ਨੱਲਨਹੀਂਸਪੀਡ ਬੂਸਟ। ਮੂਲ ਰੂਪ ਵਿੱਚ true। Bolt v2 ਪਾਈਪਲਾਈਨ ਉੱਤੇ bolt ਏਜੰਟ ਲਈ, ਜਵਾਬ ਥੋੜ੍ਹੀ ਵੱਧ ਲਾਗਤ ਨਾਲ ਕੁਝ ਜਲਦੀ ਸ਼ੁਰੂ ਹੁੰਦੇ ਹਨ। false ਇਸਨੂੰ ਬੰਦ ਕਰਦਾ ਹੈ। ਹੋਰ ਉਤਪਾਦ ਇਸਨੂੰ ਅਣਡਿੱਠਾ ਕਰਦੇ ਹਨ
background_trackਸਟ੍ਰਿੰਗ | ਨੱਲਨਹੀਂਐਂਬੀਐਂਟ ਆਡੀਓ ਆਈਡੀ ਜਾਂ null
acknowledgement_prompt_modeਸਟ੍ਰਿੰਗਨਹੀਂauto (ਮੂਲ ਰੂਪ ਵਿੱਚ) ਜਾਂ manual (ਪੁਰਾਣੇ -with-ack ਉਤਪਾਦ ਮੁੱਲ)
acknowledgement_promptਸਟ੍ਰਿੰਗਨਹੀਂਜਦੋਂ acknowledgement_prompt_mode="manual" ਹੋਵੇ ਤਾਂ ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ
silence_interval_secondsਇੰਟੀਜਰ | ਨੱਲਨਹੀਂ5–120। ਚੈੱਕ-ਇਨ ਤੋਂ ਪਹਿਲਾਂ ਕਾਲਰ ਦੀ ਚੁੱਪ ਦੇ ਸਕਿੰਟ
silence_max_checkinsਇੰਟੀਜਰ | ਨੱਲਨਹੀਂ1–10
silence_checkins_enabledਬੂਲੀਅਨਨਹੀਂਮੂਲ ਰੂਪ ਵਿੱਚ true
silence_final_actionਸਟ੍ਰਿੰਗਨਹੀਂਆਖਰੀ ਚੈੱਕ-ਇਨ ਤੋਂ ਬਾਅਦ: hang_up (ਮੂਲ ਰੂਪ ਵਿੱਚ) ਜਾਂ silence_transfer_destination ਨੂੰ transfer
silence_transfer_destinationਸਟ੍ਰਿੰਗਨਹੀਂਇਸ ਕੌਂਫਿਗ ਦੀ transfer_destinations ਵਿੱਚ ਇੱਕ ਐਂਟਰੀ ਦਾ ਨਾਮ; transfer ਨਾਲ ਲਾਜ਼ਮੀ ਹੈ। transfer_destinations ਤੋਂ ਬਿਨਾਂ ਟ੍ਰਾਂਸਫ਼ਰ ਨਹੀਂ ਕੀਤਾ ਜਾ ਸਕਦਾ ਅਤੇ ਏਜੰਟ ਕਾਲ ਖਤਮ ਕਰ ਦਿੰਦਾ ਹੈ
silence_final_messageਸਟ੍ਰਿੰਗਨਹੀਂ≤ 300 ਅੱਖਰ, ਲਿਖੇ ਅਨੁਸਾਰ ਪੜ੍ਹਿਆ ਜਾਂਦਾ ਹੈ; "" (ਮੂਲ ਰੂਪ ਵਿੱਚ) ਮੂਲ ਲਾਈਨ ਵਰਤਦਾ ਹੈ
connect_tone_enabledਬੂਲੀਅਨਨਹੀਂਮੂਲ ਰੂਪ ਵਿੱਚ false
pronunciation_dictsਬੂਲੀਅਨ | ਨੱਲਨਹੀਂਮੂਲ ਰੂਪ ਵਿੱਚ false; null, false ਦੇ ਸਮਾਨ ਹੈ। ਜਦੋਂ true ਹੋਵੇ, ਤਾਂ ਕਾਲ ਦੀ Cartesia ਸਪੀਚ ਕਾਲ ਦੀ ਭਾਸ਼ਾ ਲਈ ThunderPhone ਦੀ ਉਚਾਰਨ ਡਿਕਸ਼ਨਰੀ ਵਰਤਦੀ ਹੈ, ਜਿੱਥੇ ਉਹ ਮੌਜੂਦ ਹੋਵੇ। ਫ਼ੋਨ ਅਤੇ ਵਿਜਿਟ ਕਾਲਾਂ ਲਈ ਕੰਮ ਕਰਦਾ ਹੈ। ਸਿਰਫ਼ ThunderPhone ਦੀਆਂ ਆਪਣੀਆਂ Cartesia ਵੌਇਸਾਂ ਉੱਤੇ ਲਾਗੂ ਹੁੰਦਾ ਹੈ, ਤੁਹਾਡੀ ਆਪਣੀ Cartesia API ਕੁੰਜੀ ਦੀਆਂ ਵੌਇਸਾਂ ਉੱਤੇ ਨਹੀਂ। agent_id ਨਾਲ ਵਰਤਿਆ ਨਹੀਂ ਜਾਂਦਾ, ਜਿੱਥੇ ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਲਾਗੂ ਹੁੰਦੀਆਂ ਹਨ
wordsਐਰੇ | ਨੱਲਨਹੀਂਏਜੰਟ ਖਾਸ ਸ਼ਬਦਾਂ ਨੂੰ ਕਿਵੇਂ ਕਹਿੰਦਾ ਹੈ, support ਤੋਂ ਬਿਨਾਂ ਏਜੰਟ ਦੇ words ਵਾਲੀਆਂ ਹੀ ਐਂਟਰੀਆਂ। language ਤੋਂ ਬਿਨਾਂ ਐਂਟਰੀ ਇਸ ਕੌਂਫਿਗ ਦੀ ਭਾਸ਼ਾ ਲੈਂਦੀ ਹੈ। null ਅਤੇ [] ਦਾ ਅਰਥ ਕੋਈ ਨਹੀਂ ਹੈ। agent_id ਨਾਲ ਵਰਤਿਆ ਨਹੀਂ ਜਾਂਦਾ, ਜਿੱਥੇ ਸੇਵ ਕੀਤੇ ਏਜੰਟ ਦੇ ਸ਼ਬਦ ਲਾਗੂ ਹੁੰਦੇ ਹਨ
voicemail_actionਸਟ੍ਰਿੰਗਨਹੀਂprompt (ਮੂਲ ਰੂਪ ਵਿੱਚ), hangup, ਜਾਂ message
voicemail_messageਸਟ੍ਰਿੰਗਨਹੀਂਜਦੋਂ voicemail_action="message" ਹੋਵੇ ਤਾਂ ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ
agent_nameਸਟ੍ਰਿੰਗਨਹੀਂਡੈਸ਼ਬੋਰਡਾਂ ਅਤੇ ਵਿਜਿਟ ਨੂੰ ਰਿਪੋਰਟ ਕੀਤਾ ਜਾਣ ਵਾਲਾ ਡਿਸਪਲੇ ਨਾਮ
org_nameਸਟ੍ਰਿੰਗਨਹੀਂਏਜੰਟ ਦੇ ਪਰਸੋਨਾ ਲਈ ਸੰਸਥਾ ਦਾ ਡਿਸਪਲੇ ਨਾਮ
toolsਐਰੇਨਹੀਂਇਨਲਾਈਨ ਫੰਕਸ਼ਨ-ਟੂਲ ਸਕੀਮਾਵਾਂ (ਫੰਕਸ਼ਨ ਟੂਲ ਵੇਖੋ)
transfer_destinationsਆਬਜੈਕਟ ਦੀ ਐਰੇ | ਨੱਲਨਹੀਂਵੱਧ ਤੋਂ ਵੱਧ 50 {name, number} ਐਂਟਰੀਆਂ ਜਿਨ੍ਹਾਂ ਨੂੰ ਇਹ ਕਾਲ ਟ੍ਰਾਂਸਫ਼ਰ ਕਰ ਸਕਦੀ ਹੈ, ਏਜੰਟ ਦੇ ਟ੍ਰਾਂਸਫ਼ਰ ਨੰਬਰਾਂ ਵਾਂਗ ਪ੍ਰਮਾਣਿਤ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। ਏਜੰਟ ਨਾਮ ਰਾਹੀਂ ਅਤੇ ਸਿਰਫ਼ ਇਹਨਾਂ ਨੂੰ ਹੀ ਟ੍ਰਾਂਸਫ਼ਰ ਕਰਦਾ ਹੈ; [] ਦਾ ਅਰਥ ਕੋਈ ਟ੍ਰਾਂਸਫ਼ਰ ਨਹੀਂ ਹੈ। ਏਜੰਟ ਨੂੰ ਆਪਣੀ ਚੋਣ ਦੇ ਨੰਬਰ ਤੇ ਟ੍ਰਾਂਸਫ਼ਰ ਕਰਨ ਦੇਣ ਲਈ ਇਸਨੂੰ ਛੱਡ ਦਿਓ ਜਾਂ null ਭੇਜੋ
timezoneਸਟ੍ਰਿੰਗਨਹੀਂਇਸ ਕਾਲ ਲਈ IANA ਸਮਾਂ ਖੇਤਰ, ਜਿਵੇਂ America/Chicago। ਏਜੰਟ ਆਪਣਾ ਸਮਾਂ ਖੇਤਰ ਵਰਤਣ ਤੋਂ ਪਹਿਲਾਂ ਇਸ ਵਿੱਚ ਮਿਤੀ ਅਤੇ ਸਮਾਂ ਦੱਸਦਾ ਹੈ। agent_id ਦੇ ਨਾਲ ਵੀ ਮਨਜ਼ੂਰ ਹੈ। ਜੋ ਮੁੱਲ IANA ਖੇਤਰ ਨਹੀਂ ਹਨ, ਉਹਨਾਂ ਨੂੰ ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਹਰ ਕਾਲ ਲਈ ਸਮਾਂ ਖੇਤਰ ਸੈਟ ਕਰੋ ਵੇਖੋ
contextਸਟ੍ਰਿੰਗ | ਨੱਲਨਹੀਂਇਸ ਕਾਲ ਲਈ ਮੁਕਤ-ਰੂਪ ਟੈਕਸਟ, ਜਿਵੇਂ ਤੁਹਾਡੇ ਸਿਸਟਮ ਵੱਲੋਂ ਇਕੱਠੇ ਕੀਤੇ ਨੋਟਸ, ਵੱਧ ਤੋਂ ਵੱਧ 20,000 ਅੱਖਰ। prompt ਤੋਂ ਬਾਅਦ ਇੱਕ ਸੀਮਾਂਕਿਤ ਬਲਾਕ ਵਿੱਚ ਜੋੜਿਆ ਜਾਂਦਾ ਹੈ ਅਤੇ ਟੈਂਪਲੇਟ ਵਜੋਂ ਰੈਂਡਰ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ। agent_id ਦੇ ਨਾਲ ਵੀ ਮਨਜ਼ੂਰ ਹੈ। ਜੋ ਮੁੱਲ ਸਟ੍ਰਿੰਗ ਨਹੀਂ ਹੈ, ਜਾਂ ਲੰਮਾ ਹੈ, ਉਹ ਕਾਲ ਨੂੰ ਰੱਦ ਕਰਦਾ ਹੈ। ਕਾਲ ਵੇਰੀਏਬਲ ਅਤੇ ਕੌਂਟੈਕਸਟ ਵੇਖੋ
call_idਇੰਟੀਜਰਨਹੀਂਬੇਨਤੀ ਦੀ ਕਾਲ ਆਈਡੀ ਦਾ ਵਿਕਲਪੀ ਈਕੋ; ਅਣਡਿੱਠਾ ਕੀਤਾ ਜਾਂਦਾ ਹੈ

ਕਿਉਂਕਿ prompt ਅਤੇ voice ਲਾਜ਼ਮੀ ਹਨ, ਇਸ ਲਈ {} ਜਾਂ ਤਸਦੀਕ ਵਿੱਚ ਅਸਫਲ ਹੋਣ ਵਾਲਾ ਕੋਈ ਵੀ ਜਵਾਬ ਵਾਪਸ ਕਰਨ ਨਾਲ ਕਾਲ ਅਸਵੀਕਾਰ ਹੋ ਜਾਂਦੀ ਹੈ: ਫ਼ੋਨ ਕਾਲ ਟਾਈਮਆਉਟ ਅਤੇ ਮੁੜ ਕੋਸ਼ਿਸ਼ਾਂ ਵਿੱਚ ਦੱਸੇ ਅਨੁਸਾਰ ਸਮਾਪਤ ਹੋ ਜਾਂਦੀ ਹੈ, ਅਤੇ ਵਿਜਿਟ ਸੈਸ਼ਨ ਬੇਨਤੀ 422 ਨਾਲ ਅਸਫਲ ਹੁੰਦੀ ਹੈ। ਇਹ ਵਾਪਸ ਕਾਲ ਕਰਨ ਵਾਲਿਆਂ ਲਈ ਵੀ ਲਾਗੂ ਹੁੰਦਾ ਹੈ: ਤੁਹਾਡਾ webhook ਜੋ ਵੀ JSON ਆਬਜੈਕਟ ਵਾਪਸ ਕਰਦਾ ਹੈ, ਉਹੀ ਉਸਦਾ ਜਵਾਬ ਹੁੰਦਾ ਹੈ, ਅਤੇ {} ਕਾਲ ਅਸਵੀਕਾਰ ਕਰਨ ਦਾ ਤਰੀਕਾ ਹੈ।


ਏਜੰਟ ਕਾਲ ਸੈਟਅੱਪ ਵੈੱਬਹੁੱਕ

ਕਿਸੇ ਏਜੰਟ ਦਾ ਆਪਣਾ ਕਾਲ ਸੈਟਅੱਪ ਵੈੱਬਹੁੱਕ ਹੋ ਸਕਦਾ ਹੈ: ਇਸ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਵਿੱਚ ਕਾਲ ਸੈਟਅੱਪ ਵੈੱਬਹੁੱਕ ਫ਼ੀਲਡ, ਜਾਂ API ਵਿੱਚ call_setup_webhook_url। ਏਜੰਟ ਨੂੰ ਕਿਸੇ ਨੰਬਰ ਨਾਲ ਅਸਾਈਨ ਕਰੋ, ਅਤੇ ਉਸ ਨੰਬਰ 'ਤੇ ਏਜੰਟ ਦੁਆਰਾ ਜਵਾਬ ਦਿੱਤੀ ਜਾਣ ਵਾਲੀ ਹਰੇਕ ਆਉਣ ਵਾਲੀ ਕਾਲ ਤੋਂ ਪਹਿਲਾਂ, ThunderPhone ਉਸ ਕਾਲ ਦੇ ਵੇਰੀਏਬਲਾਂ ਅਤੇ ਸੰਦਰਭ ਲਈ ਵੈੱਬਹੁੱਕ ਨੂੰ ਪੁੱਛਦਾ ਹੈ। ਨੰਬਰ ਆਪਣੇ ਏਜੰਟ ਨੂੰ ਰੱਖਦਾ ਹੈ, ਇਸ ਲਈ ਫ਼ੋਨ ਨੰਬਰਾਂ ਦਾ ਪੰਨਾ ਅਤੇ ਏਜੰਟ ਪੰਨਾ ਦਿਖਾਉਂਦੇ ਹਨ ਕਿ ਉਸਦਾ ਜਵਾਬ ਕਿਹੜਾ ਏਜੰਟ ਦਿੰਦਾ ਹੈ।

ਇਹ ਏਜੰਟ ਦੀਆਂ ਹੋਰ ਸੈਟਿੰਗਾਂ ਵਾਂਗ ਹੀ ਇੱਕ ਸੈਟਿੰਗ ਹੈ: ਡਰਾਫਟ ਵਜੋਂ ਤਿਆਰ ਕੀਤੀ ਜਾਂਦੀ ਹੈ, ਡਿਪਲੌਇ ਕਰਨ 'ਤੇ ਪ੍ਰਕਾਸ਼ਿਤ ਹੁੰਦੀ ਹੈ ਅਤੇ ਵਰਜਨ ਇਤਿਹਾਸ ਵਿੱਚ ਰੱਖੀ ਜਾਂਦੀ ਹੈ। ਕੋਈ ਨੰਬਰ ਜੋ ਪੁਰਾਣੇ ਵਰਜਨ ਨਾਲ ਪਿੰਨ ਕੀਤਾ ਹੋਇਆ ਹੈ ਉਸ ਵਰਜਨ ਦਾ URL ਪੁੱਛਦਾ ਹੈ। ਬੇਨਤੀਆਂ ਏਜੰਟ ਦੇ ਆਪਣੇ call_setup_webhook_signing_secret ਨਾਲ ਸਾਈਨ ਹੁੰਦੀਆਂ ਹਨ (ਸੰਸਥਾ ਦੇ ਵੈੱਬਹੁੱਕ ਸੀਕ੍ਰੇਟ ਨਾਲ ਨਹੀਂ), ਅਤੇ ਉਹੀ X-ThunderPhone-Signature ਹੈਡਰ, ਟਾਈਮਆਉਟ, ਰੀਟ੍ਰਾਈ ਅਤੇ idempotency ਕੁੰਜੀ ਵਰਤਦੀਆਂ ਹਨ ਜੋ ਉੱਪਰ ਹਨ। ਸੀਕ੍ਰੇਟ ਸਿਰਫ਼ ਲਿਖਣ-ਯੋਗ ਹੈ: ਉਹ ਸੈਟ ਕਰੋ ਜਿਸਦੀ ਤੁਹਾਡਾ ਐਂਡਪੌਇੰਟ ਜਾਂਚ ਕਰਦਾ ਹੈ (ਏਜੰਟ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਵਿੱਚ, ਜਾਂ PATCH /v1/agents/{id} ਨਾਲ); ਕਿਸੇ ਵੀ ਰੀਡ ਵਿੱਚ ਇਹ ਕਦੇ ਵਾਪਸ ਨਹੀਂ ਮਿਲਦਾ, ਅਤੇ call_setup_webhook_signing_secret_set ਦੱਸਦਾ ਹੈ ਕਿ ਕੋਈ ਸੈਟ ਹੈ ਜਾਂ ਨਹੀਂ।

ਬੇਨਤੀ ਉੱਪਰ ਦਿੱਤਾ telephony.incoming ਪੇਲੋਡ ਹੈ, ਨਾਲ ਹੀ ਉਹ ਏਜੰਟ ਜਿਸਨੂੰ ਇਹ ਭਰ ਰਿਹਾ ਹੈ:

{
  "type": "telephony.incoming",
  "data": {
    "call_id":     987654321,
    "from_number": "+14155550199",
    "to_number":   "+15551234567",
    "variables":   null,
    "agent": {
      "id": 12,
      "name": "Front desk",
      "version": 7,
      "version_pinned": false
    }
  }
}
ਫ਼ੀਲਡਕਿਸਮਵੇਰਵਾ
agent.idਪੂਰਨ ਅੰਕਨੰਬਰ ਨਾਲ ਅਸਾਈਨ ਕੀਤਾ ਏਜੰਟ
agent.nameਸਟਰਿੰਗਇਸਦਾ ਨਾਮ
agent.versionਪੂਰਨ ਅੰਕ | nullਜਵਾਬ ਦੇਣ ਵਾਲੇ ਵਰਜਨ ਦਾ ਨੰਬਰ: ਨੰਬਰ ਦਾ ਪਿੰਨ ਕੀਤਾ ਵਰਜਨ, ਨਹੀਂ ਤਾਂ ਏਜੰਟ ਦਾ ਸਭ ਤੋਂ ਨਵਾਂ ਪ੍ਰਕਾਸ਼ਿਤ ਵਰਜਨ (ਜੇ ਕੋਈ ਨਹੀਂ ਹੈ ਤਾਂ null)
agent.version_pinnedਬੂਲੀਅਨਕੀ ਨੰਬਰ ਉਸ ਵਰਜਨ ਨਾਲ ਪਿੰਨ ਕੀਤਾ ਹੋਇਆ ਹੈ

ਕਾਲ ਨੂੰ ਲੋੜੀਂਦੀ ਜਾਣਕਾਰੀ ਨਾਲ ਜਵਾਬ ਦਿਓ। ਇਹਨਾਂ ਵਿੱਚੋਂ ਕੋਈ ਵੀ ਨੰਬਰ ਦੇ ਵਰਜਨ 'ਤੇ ਅਸਾਈਨ ਕੀਤੇ ਏਜੰਟ ਨੂੰ ਭਰ ਦਿੰਦਾ ਹੈ:

  • {"variables": {...}}, {"context": "..."}, ਜਾਂ ਦੋਵੇਂ
  • ਇਹੀ, ਜਦੋਂ "agent_id" ਨੂੰ ਅਸਾਈਨ ਕੀਤੇ ਏਜੰਟ ਦੀ id 'ਤੇ ਸੈਟ ਕੀਤਾ ਹੋਵੇ
  • {}: ਏਜੰਟ ਬਿਨਾਂ ਕੁਝ ਭਰੇ ਜਵਾਬ ਦਿੰਦਾ ਹੈ

timezone ਅਤੇ language ਦੀ ਵੀ ਇਜਾਜ਼ਤ ਹੈ, ਜਿਵੇਂ agent_id ਦੇ ਅੱਗੇ ਹੈ। ਵੇਰੀਏਬਲ ਏਜੰਟ ਦੇ {{placeholders}} ਨੂੰ ਭਰਦੇ ਹਨ; ਸੰਦਰਭ ਨੂੰ prompt ਤੋਂ ਬਾਅਦ ਜੋੜਿਆ ਜਾਂਦਾ ਹੈ।

ਜਾਂ ਕਾਲ ਦਾ ਫ਼ੈਸਲਾ ਖੁਦ ਕਰੋ। ਕਿਸੇ ਹੋਰ ਏਜੰਟ ਦਾ agent_id, ਜਾਂ prompt ਵਾਲੀ ਪੂਰੀ ਕੌਂਫ਼ਿਗਰੇਸ਼ਨ, ਅਸਾਈਨ ਕੀਤੇ ਏਜੰਟ (ਅਤੇ ਇਸਦੇ ਪਿੰਨ ਕੀਤੇ ਵਰਜਨ) ਦੀ ਬਜਾਏ ਇਸ ਇੱਕ ਕਾਲ ਦਾ ਜਵਾਬ ਦਿੰਦੀ ਹੈ। ਕਾਲ ਵੇਰਵੇ ਹਰੇਕ ਮਾਮਲੇ ਨੂੰ call_setup_webhook ਵਿੱਚ ਲੇਬਲ ਕਰਦੇ ਹਨ: assigned_agent, other_agent ਜਾਂ inline_config। ਕੋਈ ਜਵਾਬ ਜੋ ਵਰਤਿਆ ਨਹੀਂ ਜਾ ਸਕਦਾ (ਅਣਜਾਣ agent_id, variables ਦੇ ਨਾਲ ਹੋਰ ਕੁੰਜੀਆਂ, ਜਾਂ ਵੈਲੀਡੇਸ਼ਨ ਵਿੱਚ ਅਸਫਲ ਕੌਂਫ਼ਿਗਰੇਸ਼ਨ) ਕਾਲ ਨੂੰ ਉਸੇ ਤਰ੍ਹਾਂ ਖਤਮ ਕਰ ਦਿੰਦਾ ਹੈ ਜਿਵੇਂ ਨੰਬਰ ਦੇ ਵੈੱਬਹੁੱਕ ਲਈ ਹੁੰਦਾ ਹੈ।

ਜਦੋਂ ਵੈੱਬਹੁੱਕ ਨੂੰ ਜਵਾਬ ਦੇਣਾ ਲਾਜ਼ਮੀ ਹੈ। ਕਿਸੇ ਏਜੰਟ ਨੂੰ ਆਪਣਾ ਵੈੱਬਹੁੱਕ ਲੋੜੀਂਦਾ ਹੈ ਜਦੋਂ ਇਸ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਵਿੱਚ ਬਿਨਾਂ ਡਿਫੌਲਟ ਵਾਲਾ {{variable}} ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ: ਇਸਦਾ prompt ਜਾਂ ਦੁਬਾਰਾ ਵਰਤੀਆਂ ਜਾਣ ਵਾਲੀਆਂ ਹਦਾਇਤਾਂ, ਕਦਮ ਦੀਆਂ ਹਦਾਇਤਾਂ ਜਾਂ ਲਾਈਨਾਂ, ਪ੍ਰਵਾਨਗੀ prompt, ਵੌਇਸਮੇਲ ਸੁਨੇਹਾ, ਸਹਿਮਤੀ ਘੋਸ਼ਣਾ, ਜਾਂ {{variable}} ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ। ਏਜੰਟ ਦਾ call_setup_webhook_variables ਇਹਨਾਂ ਨੂੰ ਸੂਚੀਬੱਧ ਕਰਦਾ ਹੈ।

  • ਇਸਨੂੰ ਵੈੱਬਹੁੱਕ ਦੀ ਲੋੜ ਹੈ: ਜਦੋਂ ਵੈੱਬਹੁੱਕ ਟਾਈਮਆਉਟ ਹੋ ਜਾਂਦਾ ਹੈ, ਇਸ ਤੱਕ ਪਹੁੰਚ ਨਹੀਂ ਹੋ ਸਕਦੀ, ਜਾਂ ਇਹ ਕਿਸੇ ਗਲਤੀ ਜਾਂ ਅਜਿਹੇ ਬਾਡੀ ਨਾਲ ਜਵਾਬ ਦਿੰਦਾ ਹੈ ਜੋ JSON ਆਬਜੈਕਟ ਨਹੀਂ ਹੈ, ਤਾਂ ਕਾਲ ਸ਼ੁਰੂ ਨਹੀਂ ਹੁੰਦੀ, ਭਾਵੇਂ ਕਾਲ ਵਿੱਚ ਪਹਿਲਾਂ ਹੀ ਇਹਨਾਂ ਵਿੱਚੋਂ ਕਿਸੇ ਵੇਰੀਏਬਲ ਲਈ ਮੁੱਲ ਹੋਵੇ। ਇਸਨੂੰ ਖਤਮ ਕਰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ ਅਤੇ ਬਿਲਕੁਲ ਉਸੇ ਤਰ੍ਹਾਂ ਰਿਕਾਰਡ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਜਿਵੇਂ ਟਾਈਮਆਉਟ ਅਤੇ ਰੀਟ੍ਰਾਈ ਵਿੱਚ ਦੱਸਿਆ ਗਿਆ ਹੈ (end_reason inbound_config_webhook_failed, ਬਿਨਾਂ ਬਿੱਲ ਕੀਤੇ)।
  • ਇਸਨੂੰ ਕਿਸੇ ਚੀਜ਼ ਦੀ ਲੋੜ ਨਹੀਂ (ਕੋਈ ਵੇਰੀਏਬਲ ਨਹੀਂ, ਜਾਂ ਹਰੇਕ ਦਾ {{first_name|there}} ਵਰਗਾ ਡਿਫੌਲਟ ਹੈ): ਵੈੱਬਹੁੱਕ ਫਿਰ ਵੀ ਚਲਦਾ ਹੈ, ਪਰ ਜਦੋਂ ਇਹ ਅਸਫਲ ਹੁੰਦਾ ਹੈ ਤਾਂ ਏਜੰਟ ਇਸ ਤੋਂ ਬਿਨਾਂ ਜਵਾਬ ਦਿੰਦਾ ਹੈ, ਅਤੇ ਕਾਲ ਵੇਰਵੇ ਦਿਖਾਉਂਦੇ ਹਨ ਕਿ ਕੀ ਗਲਤ ਹੋਇਆ ਸੀ ਨਾਲ webhook_failed।

ਸਿਰਫ਼ ਕਾਲ ਸੰਦਰਭ ਹੋਣ ਨਾਲ ਵੈੱਬਹੁੱਕ ਲਾਜ਼ਮੀ ਨਹੀਂ ਬਣਦਾ: ਏਜੰਟ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਵਿੱਚ ਕਿਤੇ ਨਹੀਂ ਕਿਹਾ ਜਾਂਦਾ ਕਿ ਇਸਨੂੰ ਸੰਦਰਭ ਦੀ ਲੋੜ ਹੈ। ਜੇ ਤੁਹਾਡੇ ਵੈੱਬਹੁੱਕ ਦੇ ਜਵਾਬ ਤੋਂ ਬਿਨਾਂ ਕਾਲ ਸ਼ੁਰੂ ਨਹੀਂ ਹੋਣੀ ਚਾਹੀਦੀ, ਤਾਂ ਬਿਨਾਂ ਡਿਫਾਲਟ ਵਾਲਾ ਵੇਰੀਏਬਲ ਵਰਤੋ।

ਅਸਾਈਨ ਕਰਨਾ ਅਤੇ ਡਿਪਲੌਇ ਕਰਨਾ। ਜਿਸ ਏਜੰਟ ਨੂੰ ਆਪਣੇ ਵੈੱਬਹੁੱਕ ਦੀ ਲੋੜ ਹੈ, ਉਸਨੂੰ ਇਸ ਤੋਂ ਬਿਨਾਂ ਕਿਸੇ ਨੰਬਰ ਨਾਲ ਅਸਾਈਨ ਨਹੀਂ ਕੀਤਾ ਜਾ ਸਕਦਾ: ਵੇਰੀਏਬਲਾਂ ਦੇ ਨਾਮ ਵਾਲੇ ਸੁਨੇਹੇ ਨਾਲ ਅਸਾਈਨਮੈਂਟ ਅਸਵੀਕਾਰ ਕਰ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ। ਨੰਬਰ ਦਾ ਵਰਜਨ ਬਦਲਣ ਵੇਲੇ ਵੀ ਇਹੀ ਜਾਂਚ ਹੁੰਦੀ ਹੈ, ਜਿਸ ਵਿੱਚ ਪਿੰਨ ਕੀਤਾ ਨੰਬਰ ਵਾਪਸ ਨਵੀਨਤਮ ਵਰਜਨ 'ਤੇ ਜਾਣਾ ਵੀ ਸ਼ਾਮਲ ਹੈ। ਜਦੋਂ ਇਹ ਕਿਸੇ ਨੰਬਰ ਦਾ ਜਵਾਬ ਆਪਣੀਆਂ ਪ੍ਰਕਾਸ਼ਿਤ ਸੈਟਿੰਗਾਂ ਨਾਲ ਦੇ ਰਿਹਾ ਹੋਵੇ, ਤਾਂ ਵੈੱਬਹੁੱਕ ਤੋਂ ਬਿਨਾਂ ਅਜਿਹਾ ਵੇਰੀਏਬਲ ਜੋੜਨ ਵਾਲਾ ਡਿਪਲੌਇ (ਜਾਂ ਵੈੱਬਹੁੱਕ ਹਟਾਉਣ ਵਾਲਾ ਡਿਪਲੌਇ) ਵੀ ਇਸੇ ਤਰੀਕੇ ਨਾਲ ਅਸਵੀਕਾਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਡਰਾਫਟ ਨੂੰ ਸੇਵ ਕਰਨਾ ਹਮੇਸ਼ਾ ਮਨਜ਼ੂਰ ਹੁੰਦਾ ਹੈ, ਅਤੇ ਏਜੰਟ ਦੇ warnings ਵਿੱਚ ਸਮੱਸਿਆ ਠੀਕ ਹੋਣ ਤੱਕ call_setup_webhook_needed ਰਹਿੰਦਾ ਹੈ।

ਏਜੰਟ ਦਾ ਵੈੱਬਹੁੱਕ ਸਿਰਫ਼ ਉਹਨਾਂ ਨੰਬਰਾਂ 'ਤੇ ਆਉਣ ਵਾਲੀਆਂ ਫ਼ੋਨ ਕਾਲਾਂ ਲਈ ਚੱਲਦਾ ਹੈ ਜਿਨ੍ਹਾਂ ਨਾਲ ਉਹ ਅਸਾਈਨ ਹੈ। ਬਾਹਰ ਜਾਣ ਵਾਲੀਆਂ ਕਾਲਾਂ, ਵੈੱਬ ਵਿਜਟ ਸੈਸ਼ਨ, SIP ਪਤੇ, ਸਿਮੂਲੇਸ਼ਨ ਅਤੇ ਡੈਸ਼ਬੋਰਡ ਟੈਸਟ ਗੱਲਬਾਤਾਂ ਇਸਨੂੰ ਕਾਲ ਨਹੀਂ ਕਰਦੀਆਂ; ਉਹ ਪਹਿਲਾਂ ਵਾਂਗ ਬੇਨਤੀ ਤੋਂ ਆਪਣੇ ਵੇਰੀਏਬਲ ਲੈਂਦੀਆਂ ਹਨ।

ਸੇਵ ਕੀਤੇ ਨਮੂਨਿਆਂ ਨਾਲ ਟੈਸਟਿੰਗ। ਇਹ ਟੈਸਟ ਕਰਨ ਲਈ ਕਿ ਤੁਹਾਡਾ ਏਜੰਟ ਕਿਸੇ ਦਿੱਤੇ ਜਵਾਬ ਨਾਲ ਕੀ ਕਰਦਾ ਹੈ (ਵਾਪਸ ਆਇਆ ਕਾਲਰ, ਕੋਈ ਰਿਕਾਰਡ ਨਾ ਮਿਲਣਾ, ਸਪੇਨੀ ਬੋਲਣ ਵਾਲਾ), ਉਸ ਜਵਾਬ ਨੂੰ ਏਜੰਟ ਉੱਤੇ ਨਮੂਨੇ ਵਜੋਂ ਸੇਵ ਕਰੋ: ਇਸ ਦੇ variables, context ਅਤੇ ਚੋਣਵੇਂ ਤੌਰ ਤੇ language, ਜੋ ਤੁਸੀਂ ਟਾਈਪ ਕਰੋ ਜਾਂ ਪਿਛਲੀ ਕਾਲ ਤੋਂ ਕਾਪੀ ਕਰੋ। ਇਸਨੂੰ ਚੁਣੋ ਜਦੋਂ ਤੁਸੀਂ ਡੈਸ਼ਬੋਰਡ ਟੈਸਟ ਗੱਲਬਾਤ, ਆਪਣੇ ਫ਼ੋਨ ਲਈ ਟੈਸਟ ਕਾਲ ਜਾਂ ਏਜੰਟ ਦੇ ਵਿਰੁੱਧ ਸਿਮੂਲੇਸ਼ਨ ਸ਼ੁਰੂ ਕਰਦੇ ਹੋ, ਅਤੇ ਕਾਲ ਇਉਂ ਚੱਲਦੀ ਹੈ ਜਿਵੇਂ ਤੁਹਾਡੇ ਵੈੱਬਹੁੱਕ ਨੇ ਇਸ ਨਾਲ ਜਵਾਬ ਦਿੱਤਾ ਹੋਵੇ। ਨਮੂਨੇ ਏਜੰਟ ਦੇ ਹਰ ਵਰਜਨ ਵੱਲੋਂ ਸਾਂਝੇ ਕੀਤੇ ਜਾਂਦੇ ਹਨ। ਇੱਕ ਨੂੰ ਸੰਪਾਦਿਤ ਕਰਨ ਨਾਲ ਇਸ ਦੇ ਪਹਿਲਾਂ ਦੇ ਵਰਜਨ ਬਣੇ ਰਹਿੰਦੇ ਹਨ: ਜਦੋਂ ਏਜੰਟ ਦੀ ਤਬਦੀਲੀ ਨੂੰ ਕਿਸੇ ਅਜਿਹੇ ਵੈਰੀਏਬਲ ਦੀ ਲੋੜ ਹੋਵੇ ਜੋ ਨਮੂਨਾ ਸੈੱਟ ਨਹੀਂ ਕਰਦਾ, ਤਾਂ ਇਸਨੂੰ ਨਮੂਨੇ ਵਿੱਚ ਸ਼ਾਮਲ ਕਰੋ, ਅਤੇ ਪੁਰਾਣੇ ਏਜੰਟ ਵਰਜਨ ਨਮੂਨੇ ਨੂੰ ਪਹਿਲਾਂ ਵਾਂਗ ਹੀ ਵਰਤਦੇ ਰਹਿੰਦੇ ਹਨ। ਫ਼ੋਨ ਨੰਬਰ ਡਾਇਲ ਕਰਨ ਵਾਲੇ ਸਿਮੂਲੇਸ਼ਨ ਇਸ ਦੀ ਬਜਾਏ ਤੁਹਾਡਾ ਅਸਲੀ ਵੈੱਬਹੁੱਕ ਚਲਾਉਂਦੇ ਹਨ।

ਜਿਨ੍ਹਾਂ ਨੰਬਰਾਂ ਨਾਲ ਕੋਈ ਏਜੰਟ ਅਸਾਈਨ ਨਹੀਂ ਹੈ, ਉਹ ਉੱਪਰ ਦੱਸੇ ਅਨੁਸਾਰ ਨੰਬਰ ਦੇ ਜਾਂ ਸੰਗਠਨ ਦੇ ਵੈੱਬਹੁੱਕ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਰਹਿੰਦੇ ਹਨ।


ਵਾਪਸੀ ਕਾਲਾਂ

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

  1. ਬੇਨਤੀ ਵਿੱਚ returning_call। ਉੱਪਰ ਦਿੱਤੀ ਬਲੌਕਿੰਗ ਬੇਨਤੀ ਅਤੇ ਐਂਡਪੌਇੰਟ ਸੂਚਨਾ ਇਸਨੂੰ ਲੈ ਕੇ ਜਾਂਦੀਆਂ ਹਨ, ਤਾਂ ਜੋ ਤੁਹਾਡਾ ਹੈਂਡਲਰ ਕਾਲ ਕਰਨ ਵਾਲੇ ਨੂੰ ਰੂਟ ਕਰ ਸਕੇ:

    {
      "type": "telephony.incoming",
      "data": {
        "call_id": 987654321,
        "from_number": "+14155550199",
        "to_number": "+15551234567",
        "returning_call": {
          "call_id": 987650001,
          "agent_id": 13,
          "started_at": "2026-10-21T19:05:12.402Z",
          "outcome": "voicemail"
        }
      }
    }
    ਖੇਤਰਕਿਸਮਵੇਰਵਾ
    call_idਪੂਰਨ ਅੰਕਪਹਿਲਾਂ ਕੀਤੀ ਗਈ ਬਾਹਰ ਜਾਣ ਵਾਲੀ ਕਾਲ
    agent_idਪੂਰਨ ਅੰਕ | nullਉਹ ਏਜੰਟ ਜਿਸ ਨੇ ਕਾਲ ਕੀਤੀ ਸੀ; ਇਨਲਾਈਨ ਸੰਰਚਨਾ ਨਾਲ ਕੀਤੀ ਕਾਲ ਲਈ ਜਾਂ ਜਿਸ ਦਾ ਏਜੰਟ ਮਿਟਾ ਦਿੱਤਾ ਗਿਆ ਹੋਵੇ ਉਸ ਲਈ null
    started_atਸਤਰਇਹ ਕਦੋਂ ਸ਼ੁਰੂ ਹੋਈ ਸੀ (ISO 8601, UTC)
    outcomeਸਤਰno_answer (ਕਾਲ ਦੀ ਘੰਟੀ ਵੱਜਦੀ ਰਹੀ, ਵਿਅਸਤ ਸੀ ਜਾਂ ਅਸਵੀਕਾਰ ਕੀਤੀ ਗਈ), voicemail (ਵੌਇਸਮੇਲ ਨੇ ਜਵਾਬ ਦਿੱਤਾ, ਜਾਂ ਕਿਸੇ ਨੇ ਏਜੰਟ ਨਾਲ ਗੱਲ ਨਹੀਂ ਕੀਤੀ), conversation (ਕਿਸੇ ਨੇ ਏਜੰਟ ਨਾਲ ਗੱਲ ਕੀਤੀ) ਜਾਂ answered (ਕਾਲ ਚੁੱਕੀ ਗਈ; ਕਿਸ ਨੇ ਜਵਾਬ ਦਿੱਤਾ ਇਹ ਅਜੇ ਪਤਾ ਨਹੀਂ)
  2. ਏਜੰਟ ਲਈ ਪਿਛੋਕੜ। ਜੋ ਵੀ ਏਜੰਟ ਜਵਾਬ ਦਿੰਦਾ ਹੈ, ਉਸਨੂੰ ਆਪਣੇ prompt ਦੇ ਅੰਤ ਵਿੱਚ ਇੱਕ ਛੋਟਾ ਨੋਟ ਮਿਲਦਾ ਹੈ: ਪਹਿਲੀ ਕਾਲ ਕਦੋਂ ਕੀਤੀ ਗਈ ਸੀ, ਕਿਸ ਏਜੰਟ ਨੇ ਕੀਤੀ ਸੀ ਅਤੇ ਇਸਦਾ ਨਤੀਜਾ ਕੀ ਸੀ। ਏਜੰਟ ਨੂੰ ਇਸਨੂੰ ਉੱਚੀ ਆਵਾਜ਼ ਵਿੱਚ ਨਾ ਪੜ੍ਹਨ ਲਈ ਕਿਹਾ ਜਾਂਦਾ ਹੈ ਅਤੇ, ਕਿਉਂਕਿ ਕਾਲਰ ID ਜਾਅਲੀ ਹੋ ਸਕਦੀ ਹੈ, ਉਸ ਨੰਬਰ 'ਤੇ ਪਹਿਲਾਂ ਕਾਲ ਕੀਤੇ ਜਾਣ ਤੋਂ ਇਲਾਵਾ ਉਸ ਕਾਲ ਬਾਰੇ ਕੁਝ ਵੀ ਸਾਂਝਾ ਨਾ ਕਰਨ ਲਈ ਕਿਹਾ ਜਾਂਦਾ ਹੈ।

  3. ਇੱਕ ਬੈਕਅੱਪ ਏਜੰਟ। ਜਦੋਂ ਨੰਬਰ ਲਈ ਕੋਈ ਆਉਣ ਵਾਲੀਆਂ ਕਾਲਾਂ ਦਾ ਏਜੰਟ ਨਹੀਂ ਹੁੰਦਾ ਅਤੇ ਕੋਈ ਸੰਰਚਨਾ ਨਹੀਂ ਮਿਲਦੀ ਕਿਉਂਕਿ ਕੋਈ ਵੈੱਬਹੁੱਕ URL ਨਹੀਂ ਹੈ ਜਾਂ ਤੁਹਾਡੇ ਵੈੱਬਹੁੱਕ ਨੇ ਕੋਈ ਜਵਾਬ ਨਹੀਂ ਦਿੱਤਾ (ਇਸਦਾ ਸਮਾਂ ਸਮਾਪਤ ਹੋ ਗਿਆ, ਇਸ ਤੱਕ ਪਹੁੰਚ ਨਹੀਂ ਹੋ ਸਕੀ, ਜਾਂ ਦੋਵੇਂ ਕੋਸ਼ਿਸ਼ਾਂ ਵਿੱਚ 5xx, 408 ਜਾਂ 429 ਦਾ ਜਵਾਬ ਦਿੱਤਾ), ਤਾਂ ਕਾਲ ਖਤਮ ਕਰਨ ਦੀ ਬਜਾਏ ਉਸ ਏਜੰਟ ਕੋਲ ਜਾਂਦੀ ਹੈ ਜਿਸ ਨੇ ਪਹਿਲੀ ਕਾਲ ਕੀਤੀ ਸੀ, ਬਸ਼ਰਤੇ ਉਹ ਏਜੰਟ ਅਜੇ ਵੀ ਤੁਹਾਡੇ ਸੰਗਠਨ ਵਿੱਚ ਮੌਜੂਦ ਹੋਵੇ। ਇਹ ਉਸ ਏਜੰਟ ਦੀਆਂ ਤਾਇਨਾਤ ਸੈਟਿੰਗਾਂ ਨਾਲ ਚਲਦੀ ਹੈ। ਤੁਹਾਡਾ ਵੈੱਬਹੁੱਕ ਜੋ ਵੀ ਜਵਾਬ ਦੇਵੇ, ਉਹ ਫਿਰ ਵੀ ਫ਼ੈਸਲਾ ਕਰਦਾ ਹੈ: ਕੋਈ ਹੋਰ 4xx, ਉਹ ਬਾਡੀ ਜੋ JSON ਆਬਜੈਕਟ ਨਹੀਂ ਹੈ, {}, ਜਾਂ ਪ੍ਰਮਾਣਿਕਤਾ ਜਾਂਚ ਵਿੱਚ ਅਸਫਲ ਸੰਰਚਨਾ ਪਹਿਲਾਂ ਵਾਂਗ ਕਾਲ ਖਤਮ ਕਰ ਦਿੰਦੀ ਹੈ। ਨੰਬਰ ਲਈ ਆਉਣ ਵਾਲੀਆਂ ਕਾਲਾਂ ਦਾ ਏਜੰਟ ਹਮੇਸ਼ਾ ਜਵਾਬ ਦਿੰਦਾ ਹੈ।

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

ਕਾਲ ਦੇ ਵੇਰਵਿਆਂ ਵਿੱਚ। ਪਹਿਲਾਂ ਵਾਲੀ ਕਾਲ ਨਾਲ ਮੇਲ ਖਾਂਦੀ ਆਉਣ ਵਾਲੀ ਕਾਲ ਵਿੱਚ GET /v1/calls/{call_id} ਅੰਦਰ ਇੱਕ callback ਆਬਜੈਕਟ ਹੁੰਦਾ ਹੈ: ਉੱਪਰ ਦਿੱਤਾ returning_call, routed_as_callback (ਕੀ ਫਾਲਬੈਕ ਨੇ ਇਸ ਦਾ ਜਵਾਬ ਦਿੱਤਾ), ਅਤੇ config_webhook_failure ({kind, attempts, http_status, host} ਜਦੋਂ ਤੁਹਾਡੇ ਵੈੱਬਹੁੱਕ ਨੇ ਕੋਈ ਜਵਾਬ ਨਹੀਂ ਦਿੱਤਾ ਅਤੇ ਫਾਲਬੈਕ ਨੇ ਕਾਲ ਸੰਭਾਲ ਲਈ; ਨਹੀਂ ਤਾਂ null), ਤਾਂ ਜੋ ਕਾਲ ਦਾ ਜਵਾਬ ਦਿੱਤੇ ਜਾਣ ਦੇ ਬਾਵਜੂਦ ਵੈੱਬਹੁੱਕ ਦੀ ਰੁਕਾਵਟ ਦਿਖਾਈ ਦਿੰਦੀ ਰਹੇ।


ਜਵਾਬ ਦੇ ਆਕਾਰ ਦੀ ਸੀਮਾ


ਉਦਾਹਰਨ ਹੈਂਡਲਰ

Python (FastAPI)
import hashlib
import hmac
import json
import os
 
from fastapi import FastAPI, HTTPException, Request
 
app = FastAPI()
WEBHOOK_SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"]
 
def verify(body: bytes, signature: str) -> bool:
    expected = hmac.new(WEBHOOK_SECRET.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature or "")
 
@app.post("/thunderphone-webhook")
async def webhook(request: Request):
    body = await request.body()
    if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")):
        raise HTTPException(status_code=401)
 
    event = json.loads(body)
    if event["type"] == "telephony.incoming":
        caller = event["data"]["from_number"]
        prompt = (
            "Greet the caller as a San Francisco local…"
            if caller.startswith("+1415")
            else "You are a friendly customer support agent…"
        )
        return {
            "prompt": prompt,
            "voice": "john",
            "product": "spark",
        }
    if event["type"] == "web.incoming":
        return {
            "prompt": "You are the website's helpful voice assistant…",
            "voice": "john",
            "product": "spark",
        }
    return {}
Node.js (Express)
import crypto from "node:crypto";
import express from "express";
 
const app = express();
const SECRET = process.env.THUNDERPHONE_WEBHOOK_SECRET;
 
function verify(body, signature) {
  const expected = crypto
    .createHmac("sha256", SECRET)
    .update(body)
    .digest("hex");
  return signature &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
 
app.post(
  "/thunderphone-webhook",
  express.raw({ type: "application/json" }),
  (req, res) => {
    if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) {
      return res.sendStatus(401);
    }
    const event = JSON.parse(req.body.toString("utf8"));
 
    if (event.type === "telephony.incoming" || event.type === "web.incoming") {
      const caller = event.data.from_number || "web";
      const prompt = caller.startsWith("+1415")
        ? "Greet the caller as a San Francisco local…"
        : "You are a friendly customer support agent…";
      return res.json({
        prompt,
        voice: "john",
        product: "spark",
      });
    }
    res.json({});
  },
);

ਫੰਕਸ਼ਨ ਟੂਲਾਂ ਨਾਲ ਜਵਾਬ

ਟੂਲ ਜੋੜੋ ਤਾਂ ਜੋ AI ਗੱਲਬਾਤ ਦੌਰਾਨ ਤੁਹਾਡੀਆਂ API ਨੂੰ ਕਾਲ ਕਰ ਸਕੇ:

{
  "prompt":  "You are a booking assistant. Use the available tools to help customers schedule appointments.",
  "voice":   "john",
  "product": "spark",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "search_appointments",
        "description": "Find available appointment slots",
        "parameters": {
          "type": "object",
          "properties": {
            "date": { "type": "string", "description": "YYYY-MM-DD" },
            "service": { "type": "string" }
          },
          "required": ["date"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/search",
        "method": "POST",
        "headers": {
          "X-Api-Key": "your-key"
        }
      }
    }
  ]
}

ਸੈਟਿੰਗਾਂ ਦੀ ਤੁਰੰਤ ਜਾਣਕਾਰੀ

product: "bolt" ਭੇਜੋ ਅਤੇ ਇਹਨਾਂ ਫੀਲਡਾਂ ਨਾਲ ਕਾਲ ਨੂੰ ਅਨੁਕੂਲਿਤ ਕਰੋ। ਪੁਰਾਣੇ product ਮੁੱਲਾਂ (spark ਅਤੇ storm-* ਮੁੱਲਾਂ) ਨੂੰ ਹਾਲੇ ਵੀ ਸਵੀਕਾਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।

ਫੀਲਡਮੁੱਲਇਹ ਕੀ ਬਦਲਦਾ ਹੈ
intelligencecore, pro (ਮੂਲ)Core ਘੱਟ ਮਹਿੰਗਾ ਹੈ ਅਤੇ ਜਲਦੀ ਜਵਾਬ ਦੇਣਾ ਸ਼ੁਰੂ ਕਰਦਾ ਹੈ; Pro ਲੰਮੇ prompt ਦੀ ਵਧੇਰੇ ਭਰੋਸੇਯੋਗ ਤਰੀਕੇ ਨਾਲ ਪਾਲਣਾ ਕਰਦਾ ਹੈ
audio_tierlite, standard (ਮੂਲ), plus, maxਉੱਚੇ ਟੀਅਰ ਬਿਹਤਰ ਸੁਣਦੇ ਹਨ ਅਤੇ ਵੱਧ ਖਰਚ ਹੁੰਦੇ ਹਨ; Plus ਕੁਝ ਵਾਰੀਆਂ ਵਿੱਚ 1–2 ਸਕਿੰਟ ਜੋੜਦਾ ਹੈ, ਹਰ Max ਜਵਾਬ ਨੂੰ 3–4 ਸਕਿੰਟ ਲੱਗਦੇ ਹਨ (Max ਆਮ ਤੌਰ 'ਤੇ ਉਪਲਬਧ ਨਹੀਂ ਹੈ)
endpointingfaster, fast, normal (ਮੂਲ), patientਘੱਟ ਉਡੀਕ ਨਾਲ ਜਵਾਬ ਜਲਦੀ ਮਿਲਦਾ ਹੈ ਅਤੇ ਖਰਚ ਵੱਧ ਹੁੰਦਾ ਹੈ
faster_repliestrue (ਮੂਲ), falseਗਤੀ ਵਾਧਾ: ਥੋੜ੍ਹੇ ਵੱਧ ਖਰਚ ਲਈ ਜਵਾਬ ਥੋੜ੍ਹਾ ਜਲਦੀ ਮਿਲਦਾ ਹੈ

ਸੰਬੰਧਿਤ